一款功能强大且轻量级的 Minecraft 插件,适用于 Paper/Spigot 1.20.6+(及更高版本),允许你完全自定义玩家名称标签、聊天格式、TAB 列表以及生命值显示。
? 概述
该插件在三个区域管理玩家的前缀、后缀、昵称颜色和生命值副标题:
- 玩家头顶上方(3D scoreboard 团队名称标签)。
- TAB 列表中(玩家列表)。
- 聊天中(默认的
<PlayerName> Message 格式被替换为 Prefix Nickname Suffix: Message,并防止颜色溢出到消息文本中)。
?️ 主要功能
-
渐变与 RGB 十六进制颜色支持 (1.16+):
- 完全支持传统颜色代码(例如
&a, &l, §c)。
- 支持自定义 Hex 颜色(例如
&#FF5555)。
- 内置多 Hex 颜色插值以实现渐变效果(例如
&#FF0000�FF00Admin 可平滑地从红色过渡到绿色)。
-
智能格式化与自动间距:
- 如果缺少空格,会自动在前缀后和后缀前添加空格,确保它们永远不会与玩家名称冲突或粘连。
-
原生昵称着色 (nickcolor):
- 使用 Minecraft 原生的
team.color(...) scoreboard 字段来更改玩家头顶和 TAB 列表中的名字颜色。
- 修改聊天中的名字颜色,并在之后干净地重置消息颜色,以防止颜色溢出。
-
名称下方的生命值显示 (subtitle):
- 默认启用(实时显示玩家名字下方的
<health> HP,红色字体)。
- 生命值分数在受到伤害或治疗事件发生后的整整 1 tick 后更新,以确保准确性。
- 使用
on/off 选项进行简单的单玩家切换。
-
LuckPerms 集成:
- 允许从 LuckPerms 组手动同步前缀/后缀值。
- 具备可切换的 autosync 调度器,每 5 秒更新所有在线玩家的组信息。
-
持久化数据:
- 所有玩家修改(前缀、后缀、颜色和副标题配置)都存储在插件目录内的
data.yml 中,因此它们能在服务器重启后保留。
? 命令与权限
修改类命令需要 nametags.use 权限。管理类命令(reload/autosync)需要 nametags.admin 权限(默认为 OP)。
| 命令 |
描述 |
/nametag <player> prefix <text> |
更改玩家的前缀并在聊天中通知他们。 |
/nametag <player> silentprefix <text> |
静默更改前缀(不向目标玩家发送消息)。 |
/nametag <player> rgbprefix <hex/gradient> |
设置渐变前缀(例如 &#FF0000�FF00Owner)。 |
/nametag <player> suffix <text> |
更改玩家的后缀并通知他们。 |
/nametag <player> silentsuffix <text> |
静默更改后缀。 |
/nametag <player> rgbsuffix <hex/gradient> |
设置渐变后缀。 |
/nametag <player> nickcolor <color> |
设置昵称颜色(选项:red, blue, green, gold, yellow, white, aqua 等)。 |
/nametag <player> subtitle <on/off> |
切换玩家名字下方的 <health> HP 显示。 |
/nametag <player> <category> reset |
重置所选类别(前缀、后缀或 nickcolor)。 |
/nametag <player> luckperms-sync |
执行一次从 LuckPerms 同步前缀/后缀的操作。 |
/nametag luckperms-autosync |
切换自动 5 秒 LuckPerms 同步器。 |
/nametag reload / /nametags reload |
重新加载插件配置并将更新应用到在线玩家。 |
包含完整的 Tab 补全支持,可为 nickcolor 命令建议在线玩家名称、子命令以及英文颜色名称。
A robust and lightweight Minecraft plugin designed for Paper/Spigot 1.20.6+ (and newer) that lets you fully customize player nametags, chat formatting, tab lists, and health displays.
? Overview
The plugin manages player prefixes, suffixes, nickname colors, and health subtitles across three areas:
- Above player heads (3D scoreboard team nametags).
- On the TAB list (player list).
- On the Chat (the default
<PlayerName> Message format is replaced with Prefix Nickname Suffix: Message, and colors are prevented from bleeding into the message text).
?️ Key Features
-
Gradients & RGB Hex Support (1.16+):
- Fully supports legacy color codes (e.g.,
&a, &l, §c).
- Supports custom Hex colors (e.g.,
&#FF5555).
- Built-in multi-hex color interpolation for gradients (e.g.,
&#FF0000�FF00Admin smoothly transitions from red to green).
-
Smart Formatting & Auto-Spacing:
- Automatically adds a space after prefixes and before suffixes if missing, ensuring they never clash or stick to player names.
-
Native Nickname Coloration (nickcolor):
- Uses Minecraft's native
team.color(...) scoreboard field to change player name colors above heads and in the TAB list.
- Modifies chat name colors while cleanly resetting message colors afterwards to prevent color bleed.
-
Health Display below Name (subtitle):
- Enabled by default (shows
<health> HP in red under player names in real-time).
- Health scores update exactly 1 tick after damage or healing events for accuracy.
- Simple per-player toggle using
on/off options.
-
LuckPerms Integration:
- Allows manual synchronization of prefix/suffix values from LuckPerms groups.
- Features a toggleable autosync scheduler that updates all online players' groups every 5 seconds.
-
Persistent Data:
- All player modifications (prefixes, suffixes, colors, and subtitle configurations) are stored in
data.yml inside the plugin directory so they survive server restarts.
? Commands & Permissions
Modify commands require the nametags.use permission. Admin commands (reload/autosync) require nametags.admin (defaults to OP).
| Command |
Description |
/nametag <player> prefix <text> |
Changes the player's prefix and notifies them in chat. |
/nametag <player> silentprefix <text> |
Changes the prefix silently (no message is sent to the target player). |
/nametag <player> rgbprefix <hex/gradient> |
Set a gradient prefix (e.g. &#FF0000�FF00Owner). |
/nametag <player> suffix <text> |
Changes the player's suffix and notifies them. |
/nametag <player> silentsuffix <text> |
Changes the suffix silently. |
/nametag <player> rgbsuffix <hex/gradient> |
Set a gradient suffix. |
/nametag <player> nickcolor <color> |
Sets nickname color (Options: red, blue, green, gold, yellow, white, aqua, etc.). |
/nametag <player> subtitle <on/off> |
Toggles the <health> HP display below the player's name. |
/nametag <player> <category> reset |
Resets the selected category (prefix, suffix, or nickcolor). |
/nametag <player> luckperms-sync |
Performs a one-time synchronization of prefix/suffix from LuckPerms. |
/nametag luckperms-autosync |
Toggles the automatic 5-second LuckPerms synchronizer. |
/nametag reload / /nametags reload |
Reloads the plugin configuration and applies updates to online players. |
Full tab-completion support is included, suggesting online player names, subcommands, and English color names for the nickcolor command.
评论 0
登录后参与评分
还没有评论,来抢沙发吧