• 欢迎加入MineBBS QQ讨论群:点击查看所有的官方讨论群
  • 我们将于近期对服务器进行迁移,服务可能中断至多2日。请各位安排好自己的访问计划,造成不便敬请谅解!
  • MineBBS入站考试已经上线!想要成为【正式会员】解锁更多功能吗?快来参与吧!【点我去看】
NameTag - 多行玩家头顶称号 | 无损移动/条件行/分组显示/轻量化 1.12.x - 26.1.2[兼容Folia]

原创 工具 娱乐 游戏模式 NameTag - 多行玩家头顶称号 | 无损移动/条件行/分组显示/轻量化 1.12.x - 26.1.2[兼容Folia] 2.8.0

请登录后获取
版权类型
原创
插件中文名称
玩家头顶称号
插件英文名称
NameTag
原帖地址
#
支持的核心(服务端)
  1. Spigot
  2. Paper
  3. Folia
  4. Purpur
  5. 其他核心
语言支持
中文(简体)
前置组件
无强制前置
PlaceholderAPI[可选]
ProtocolLib[可选]
适配版本(Java)
  1. 最新版本
  2. 26.x
  3. 1.21
  4. 1.20
  5. 1.19
  6. 1.18
  7. 1.17
  8. 1.16
  9. 1.15
  10. 1.14
  11. 1.13
  12. 1.12
canvas-7912.webp

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 的现代版本上使用原生文字显示;兼容实现对旧版本提供降级路径。显示实体不会持久化,插件关闭时会主动清理。


效果演示图​

nt1.webp
nt2.webp



代码:
[/CENTER][/CENTER][/CENTER]
# NameTag Universal:适用于 Minecraft 1.12.2-26.x
# 支持 Bukkit、Spigot、Paper、Purpur、Folia、CastServer 和 Youer
# Youer 的 TextDisplay 桥接不可用时不会创建实体回退显示
# 1.19.4+ 使用 TextDisplay,1.12-1.19.3 使用 NMS 虚拟显示
default:
  top:
    - info: '&8[&3%player_ping%ms&8]&d帮派:&b%quantumlore_gang%'
      # perm: 'example.permission'
      # money: '500'
      # papi: 'quantumlore_level >= 10'
  # 中间行也可以改为 info/perm/money/papi 对象格式
  middle: '&8%quantumlore_title% &eLv.&b%player_level%&f &f%quantumlore_vipname% &8%quantumlore_membership%'
  bottom:
    - info: '&a%quantumlore_health%&7/&a%player_max_health% %quantumlore_health_bar%'
    - info: '&e%quantumlore_shield%&7/&e%quantumlore_max_shield%'
      perm: '所需权限'
      money: '500'
      papi: 'quantumlore_shield > 0'
# 权限组标题:根节点名称默认匹配 Vault/LuckPerms 的主权限组名称。
# 例如玩家主组为 vip 时匹配 vip;可使用 group 覆盖组名称。
# 需要 Vault 与支持 Vault Chat 的权限插件(如 LuckPerms Vault)。
# 使用 /nametag set 设置的个人标题优先于权限组标题。
vip:
  # group: 'vip'
  top:
    - info: '&6[VIP] &f%player_name%'
  middle: '&eLv.&6%player_level%'
  bottom:
    - info: '&a%player_health%&7/&a%player_max_health%'
# 条件说明:
# perm:必须拥有该权限
# money:Vault 余额必须大于或等于该数值,不会扣款
# papi:支持 >、>=、<、<=、==、!=
# 条件不满足时整行隐藏,不会产生空白行
# PAPI 动态变量刷新间隔,20 tick = 1 秒
refresh-interval-ticks: 40
# 跳过内容未变化的 NameTag 更新
# true:仅在文字变化时更新,推荐开启,可显著降低性能占用
# false:每次刷新都强制更新,即使显示内容完全相同
skip-unchanged-updates: true
# 所有玩家命令执行前都会临时卸载 NameTag 乘客链
# 若命令未触发传送,2 tick 后会在原位置自动恢复
# 无需配置 Home、Warp、TPA、PlotSquared 等具体命令

# PAPI 变量监听器
# 当变量变更时及时刷新
variable-listener:
  enabled: false
  interval-ticks: 1
# 标题相对玩家头顶的垂直偏移
# 数值越大位置越高,数值越小位置越低
height-offset: 0.15
# 1.12.2-1.19.3 使用 ArmorStand 时每行文字的垂直间距
# 数值越小排列越紧凑,推荐范围 0.22-0.30
legacy-line-spacing: 0.22
# ProtocolLib 虚拟全息的观察距离(方块)
# 仅在旧版核心无法使用紧凑乘客链且已安装 ProtocolLib 时生效
packet-view-distance: 48
# 是否允许玩家看到自己的数据包虚拟 NameTag
# 1.12 客户端不会接收自己的移动包,开启后会受网络往返延迟影响
# 推荐关闭,与 TAB 的实现一致;其他玩家仍能正常看到
show-own-nametag: false
messages:
  prefix: '&8[&aNameTag&8] '
  no-permission: '&c你没有权限执行此命令。'
  player-not-found: '&c未找到该在线玩家。'
  reloaded: '&a配置已重新加载。'
  set: '&a已更新玩家 &f%player% &a的头顶标题。'
  cleared: '&a已清除玩家 &f%player% &a的自定义标题。'
  show: '&7上标题: &f%top%\n&7中间标题: &f%middle%\n&7下标题: &f%bottom%'
  usage:
    - '&e/nametag reload'
    - '&e/nametag set <player> top <text...>'
    - '&e/nametag set <player> middle <text...>'
    - '&e/nametag set <player> bottom <text...>'
    - '&e/nametag clear <player>'
    - '&e/nametag show [player]'
[CENTER][CENTER]


安全传送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​


Quantum-NameTag.svg

  • nt1.webp
    nt1.webp
    39 KB · 查看: 17
  • nt2.webp
    nt2.webp
    33.7 KB · 查看: 16
作者
oroska
价格
50.00金粒
下载
40
查看
834
首次发布
最后更新

评分

0.00 星 0 次评分

资源团队

最新更新

  1. 2.8.0 - 版本更新

    修复插件兼容性 增加对隐身的兼容
  2. 2.7.1 - 版本更新

    修复插件兼容性 命令白名单逻辑更改为仅在白名单内的命令才会触发卸载重建
  3. 2.7.0 - 版本更新

    修复插件兼容性 增加命令白名单
后退
顶部 底部