NameManager - 玩家名称管理器

NameManager 是一款功能强大的 Minecraft 插件，它允许你深度自定义玩家的名称显示，包括前缀、后缀、头顶名称、血条显示以及加入/离开消息等，并提供了完善的 API 供开发者使用。

💡核心功能

• 颜色与格式权限：为玩家分配使用特定颜色和格式（如粗体、下划线）的权限。
• 自定义前缀与后缀：为玩家或玩家组设置独特的前缀和后缀。
• 名称显示自定义：修改玩家头顶显示的名称以及在玩家列表（Tablist）中的名称。
• 自定义加入/离开消息：可配置独特的玩家加入和离开服务器消息。
• 开发者 API：提供完整的 API，方便其他插件集成与调用。
• 生命值显示：可在玩家名称下方显示其当前生命值（血条）。
• UUID 兼容：100% 兼容 Minecraft 的 UUID 系统。
• Vault 支持：可集成 Vault 以兼容经济、权限等系统。
• 跨服支持：如需在 BungeeCord 网络中使用，请搭配 NameManagerBungee 插件。

🎮命令

• /nm help - 显示帮助信息。
• /nm group - 管理玩家组。

🎮权限

所有权限均以 NameManager. 开头，结构清晰。

命令权限

控制玩家使用各项命令的权限。

• NameManager.help
• NameManager.prefix
• NameManager.suffix
• NameManager.clear
• NameManager.uuid
• NameManager.rainbow

组管理权限

用于管理玩家组的相关操作。

• NameManager.group.help
• NameManager.group.prefix
• NameManager.group.suffix
• NameManager.group.reload
• NameManager.group.remove
• NameManager.group.list
• NameManager.group.add

颜色与格式权限

允许玩家在名称中使用特定颜色或文本格式。

• NameManager.black
• NameManager.dark_blue
• NameManager.dark_green
• NameManager.dark_aqua
• NameManager.dark_red
• NameManager.dark_purple
• NameManager.gold
• NameManager.gray
• NameManager.dark_gray
• NameManager.blue
• NameManager.green
• NameManager.aqua
• NameManager.red
• NameManager.light_purple
• NameManager.yellow
• NameManager.white
• NameManager.reset
• NameManager.strikethrough
• NameManager.underline
• NameManager.italic

🔧配置文件 (config.yml)

主要配置选项如下

# 是否启用自定义加入/离开消息
Messages: false
# 消息中是否包含玩家的自定义前缀/后缀
CustomNameForMessages: false
# 自定义加入消息格式
Join: '&a[ + ] %player%'
# 自定义离开消息格式
Leave: '&c[ - ] %player%'
# 是否在玩家名称下方显示生命值
HealthBelowName: false
# 生命值的显示图标
HealthFormat: '&c❤'
# 是否启用 BungeeCord 跨服支持（需配合 NameManagerBungee）
Bungee: false
# 是否与 Vault 挂钩
Vault: false

✨API 方法

NameManager 提供了两个主要的 API 类供开发者调用。

NameManagerAPI

用于管理单个玩家的名称标签。

public static void setNametag(OfflinePlayer player, String prefix, String suffix)
public static void setNametagPrefix(OfflinePlayer player, String prefix)
public static void setNametagSuffix(OfflinePlayer player, String suffix)
public static void setNametagColor(String playerName, String color)
public static String getNametag(Player player)
public static String getNametagPrefix(Player player)
public static String getNametagSuffix(Player player)
public static void clearNametag(OfflinePlayer player)
public static void getOfflinePlayer(final String playerName, final UUIDCallback callback)

NameManagerGroupAPI

用于管理玩家组的名称标签。

public static void addPlayer(String group, String playerName)
public static void removePlayer(String group, String playerName)
public static void setGroupNametag(String group, String prefix, String suffix)
public static void setGroupPrefix(String group, String prefix)
public static void setGroupSuffix(String group, String suffix)
public static void removeGroup(String group)
public static String getGroupNametag(String group)
public static String getGroupPrefix(String group)
public static String getGroupSuffix(String group)

❓已知问题与解决方案

问题：启动时出现类似 [NameManager] Default system encoding may have misread config.yml from plugin jar 的错误。

**解决方案**

• 删除配置文件 config.yml 中 HealthFormat 项里的心形符号（❤）。
• 或者，在服务器启动脚本中添加 -Dfile.encoding=UTF-8 参数。

如果你有任何功能请求或发现了其他错误，请及时反馈。

⭐资源与教程

• 插件源地址：可在 SpigotMC 资源页面查看。
• BungeeCord 版本：NameManagerBungee。
• 语言：提供葡萄牙语等社区教程和评测。