- 版权类型
- 原创
- 插件中文名称
- 玩家头顶称号
- 插件英文名称
- NameTag
- 原帖地址
- #
- 支持的核心(服务端)
- Spigot
- Paper
- Folia
- Purpur
- 其他核心
- 语言支持
- 中文(简体)
- 前置组件
- 无强制前置
PlaceholderAPI[可选]
ProtocolLib[可选]
- 适配版本(Java)
- 最新版本
- 26.x
- 1.21
- 1.20
- 1.19
- 1.18
- 1.17
- 1.16
- 1.15
- 1.14
- 1.13
- 1.12
NameTag 是一款服务器的玩家头顶称号插件。它支持上、中、下多行内容,自定义颜色与 PlaceholderAPI 动态变量,并提供命令和公开 API,适合称号、身份、血量、延迟、等级等展示场景。
请注意,如果出现了无法跨世界传送的问题,请加群咨询,我会兼容插件,因为乘客链的问题会出现无法挂载实体传送世界的Bug
核心功能
• 三段式标题:上标题、中间标题、下标题均可配置
• 多行内容:命令中可用 \n 分隔多行
• PlaceholderAPI:动态显示血量、延迟、前缀等变量
• 条件行:支持 >、>=、<、<=、==、!= 条件判断,支持权限判断,支持金币判断多项显示条件,仅满足条件时显示
• 玩家独立配置:修改内容会持久化保存
• 自动刷新:可配置刷新间隔,并跳过内容未变化的更新
• Folia 支持:兼容 Folia 调度模型
• 开放 API:其他插件可通过 Bukkit ServicesManager 读写称号及创建临时或实体绑定文字
问题反馈/插件交流
如在使用插件过程遇到任何BUG或有什么建议,可加入 NameTag 官方交流群: 780593544 | 群内咨询小加,如遇到问题也可以直接加他:3125131181
兼容性
• Minecraft:1.12 - 26.x
• 服务端:Spigot、Paper、Purpur、Folia
插件会根据服务端能力选择显示后端。在支持 TextDisplay 的现代版本上使用原生文字显示;兼容实现对旧版本提供降级路径。显示实体不会持久化,插件关闭时会主动清理。
如在使用插件过程遇到任何BUG或有什么建议,可加入 NameTag 官方交流群: 780593544 | 群内咨询小加,如遇到问题也可以直接加他:3125131181
兼容性
• Minecraft:1.12 - 26.x
• 服务端:Spigot、Paper、Purpur、Folia
插件会根据服务端能力选择显示后端。在支持 TextDisplay 的现代版本上使用原生文字显示;兼容实现对旧版本提供降级路径。显示实体不会持久化,插件关闭时会主动清理。
效果演示图
安全传送API兼容
若您有其他的传送插件无法跨世界传送,请让传送插件使用该API
代码:
import com.quantum.nametag.api.NameTagApi;
import org.bukkit.Bukkit;
import org.bukkit.entity.Player;
import org.bukkit.plugin.RegisteredServiceProvider;
private NameTagApi nameTagApi() {
RegisteredServiceProvider<NameTagApi> registration =
Bukkit.getServicesManager().getRegistration(NameTagApi.class);
return registration == null
? null
: registration.getProvider();
}
代码:
public boolean teleportPlayer(Player player, Location target) {
NameTagApi api = nameTagApi();
if (api != null) {
api.prepareTeleport(player);
}
boolean success;
try {
success = player.teleport(target);
} catch (RuntimeException exception) {
if (api != null) {
api.finishTeleport(player);
}
throw exception;
}
if (api != null) {
api.finishTeleport(player);
}
return success;
}
代码:
public CompletableFuture<Boolean> teleportAsync(
Player player,
Location target
) {
NameTagApi api = nameTagApi();
if (api != null) {
api.prepareTeleport(player);
}
CompletableFuture<Boolean> future = player.teleportAsync(target);
return future.whenComplete((success, error) -> {
Runnable restore = () -> {
if (api != null) {
api.finishTeleport(player);
}
};
Bukkit.getScheduler().runTask(plugin, restore);
});
}
安装方法
1. 将 NameTag 放入服务器 plugins 目录
2. 可选安装 PlaceholderAPI
3. 重启服务器
4. 修改 plugins/NameTag/config.yml 后执行 /nametag reload