NickNamer [Integrated API] - NickNamer - 昵称皮肤管理器

Nicknamer 是一款允许玩家自由更改游戏内昵称和皮肤外观的插件，支持在服务器与客户端之间同步显示，为服务器带来丰富的个性化体验。

💡核心特性

• 昵称更改：玩家可以设置自定义昵称。
• 皮肤更改：玩家可以更换为其他玩家的皮肤外观。
• 自我可见：在 1.8 及以上版本的客户端中，玩家可以实时看到自己更换后的皮肤。
• BungeeCord 支持：插件原生支持 BungeeCord 网络。

❓要求与依赖

• Minecraft 版本： 1.8 - 1.15 (客户端与服务端)
• Java 版本： 需要 Java 8 或更高版本。
• 必需依赖： PacketListenerAPI
• 菜单插件： 如需通过菜单选择昵称或皮肤，请下载对应的附加插件。
• 语言： 插件包含德语支持。

BungeeCord 设置

若要在 BungeeCord 环境下使用，请确保完成以下配置：

• 在 spigot.yml 中设置 bungeecord: true。
• 在 BungeeCord 的 config.yml 中设置 ip_forward: true。

若希望在所有子服务器间同步玩家的昵称与皮肤设置，你需要额外安装 BungeeCord 同步插件。

🎮命令列表

• /nick <昵称> [玩家] - 为自己或指定玩家设置昵称
• /clearNick [玩家] - 重置自己或指定玩家的昵称
• /randomNick [玩家] [类别] - 获取一个随机昵称
• /listNames - 查看已被使用的昵称列表
• /refreshNick [玩家] - 向所有玩家（包括自己）更新昵称与皮肤
• /skin <皮肤> [玩家] - 为自己或指定玩家设置皮肤
• /clearSkin [玩家] - 重置自己或指定玩家的皮肤
• /listSkins - 查看已被使用的皮肤列表
• /randomSkin [玩家] [类别] - 获取一个随机皮肤
• /nickReload - 重载插件配置

🔧权限节点

• nick.command.name - 允许设置昵称
• nick.command.name.clear - 允许重置昵称
• nick.command.name.list - 允许列出昵称
• nick.command.name.random - 允许设置随机昵称
• nick.colored - 允许在昵称中使用颜色代码
• nick.other - 允许更改其他玩家的昵称
• nick.command.skin - 允许设置皮肤
• nick.command.skin.clear - 允许重置皮肤
• nick.command.skin.list - 允许列出皮肤
• nick.command.skin.random - 允许设置随机皮肤
• skin.other - 允许更改其他玩家的皮肤
• nick.command.refresh - 允许更新昵称与皮肤
• nick.name.<昵称> - 允许使用特定昵称 (使用 nick.name.* 允许所有昵称)
• nicknamer.join.nick - 允许在加入服务器时获得随机昵称
• nicknamer.join.nick.<昵称> - 允许在加入服务器时获得特定昵称
• nicknamer.join.skin - 允许在加入服务器时获得随机皮肤
• nicknamer.join.skin.<皮肤> - 允许在加入服务器时获得特定皮肤
• nicknamer.reload - 允许重载插件

注意： 由于权限节点会被转换为小写，若需匹配包含大写字母的特定名称（如 Dinnerbone），必须手动添加 ^ 标识符，例如：^dinnerbone。

✨配置摘要

主要配置选项如下

• replace： 控制昵称在聊天、命令、记分牌等处的替换行为。
• updateSelf： 是否让玩家自己看到皮肤更改 (默认为 true)。
• random.join： 控制玩家加入时是否自动获得随机昵称或皮肤。
• names.format： 昵称的全局显示格式。
• names.chatFormat： 昵称在聊天消息中的格式。
• names.spaces： 是否允许昵称中包含空格（将下划线 _ 转换为空格）。
• bungeecord： 是否启用 BungeeCord 模式。
• storage.type： 数据存储类型 (temporary, local, sql, redis)。
• execution： 设置玩家更改或重置昵称/皮肤时触发的控制台或玩家命令。
• messages： 自定义所有命令的反馈消息。
• pluginFeatures.commands： 启用或禁用特定的命令模块。

完整的配置结构请参考插件生成的 config.yml 文件。

⭐API 与开发

插件集成了 API，开发者可以通过事件和 API 方法深度自定义功能。

事件示例

@EventHandler
public void on(NickDisguiseEvent event) {
    event.setNick("inventivetalent");
}

@EventHandler
public void on(SkinDisguiseEvent event) {
    event.setSkin("md_5");
}

Maven 依赖

<dependency>
    <groupId>org.inventivetalent.nicknamer</groupId>
    <artifactId>api</artifactId>
    <version>3.19.0-SNAPSHOT</version>
</dependency>
<repositories>
    <repository>
        <id>jitpack.io</id>
        <url>https://jitpack.io</url>
    </repository>
</repositories>

• JavaDoc： 点击查看

🔧链接与支持

• 源代码： GitHub
• 问题反馈： Issue Tracker
• 插件主页： SpigotMC 资源页面
• 图标与横幅制作： @iAmGio

感谢支持者： MOTDgd, md_5, squadcraft。

如果你喜欢这个插件，请为其评分。也欢迎通过捐赠来支持作者和插件的持续开发。