NickAPI - 玩家昵称与功能扩展

NickAPI 是一款专为开发者设计的 API，让你能轻松在服务器中集成玩家伪装功能，无需直接操作 NMS 或其他底层代码。它提供了全面的伪装方法，支持从 1.8.8 到最新版本，并已重构为更稳定、无需 ProtocolLib 的结构。

💡核心信息

• 支持版本：1.8.8, 1.20.2+, 1.21
• 最新版本：7.6
• 开发者文档：https://haoshoku.xyz/nickapi
• 社区 Discord：https://discord.gg/uFhUc2W

🎮功能特性

NickAPI 提供了丰富的伪装功能，帮助你实现高度自定义的玩家身份替换：

• 客户端 UUID 更改
• 玩家名前缀/后缀（Tag）更改
• 皮肤更改
• GameProfile 名称更改
• TabComplete 提示更改
• 旁路伪装功能（可设定特定玩家看见伪装，其他玩家看不见）
• 集成 UUIDFetcher
• 集成 SkinFetcher
• 支持离线模式（Cracked）服务器
• 可为未购买正版的玩家分配随机皮肤或自定义皮肤
• 可为游戏名不对应正版账户的玩家分配随机或自定义皮肤

🔧Maven 依赖

将以下配置添加到你的 `pom.xml` 中

<repositories>
    <repository>
        <id>nickapi</id>
        <url>https://haoshoku.xyz:8081/repository/default/</url>
    </repository>
</repositories>
<dependencies>
    <dependency>
        <groupId>xyz.haoshoku.nick</groupId>
        <artifactId>nickapi</artifactId>
        <version>7.6</version>
        <scope>provided</scope>
    </dependency>
</dependencies>

插件配置

在你的插件 plugin.yml 中，必须添加 NickAPI 作为依赖：

depend: [NickAPI]

⭐示例代码

以下是一个简单的命令实现示例，展示了如何使用 NickAPI 的主要静态方法：

@Override
public boolean onCommand( CommandSender sender, Command command, String label, String[] args ) {
    if ( ! ( sender instanceof Player ) )
        return true;
    Player player = (Player) sender;

    if ( args.length == 0 ) {
        player.sendMessage( ChatColor.YELLOW + "/nick reset" );
        player.sendMessage( ChatColor.YELLOW + "/nick <Name>" );
        return true;
    }

    switch ( args[0].toLowerCase() ) {
        case "reset":
            NickAPI.resetNick( player );
            NickAPI.resetSkin( player );
            NickAPI.resetUniqueId( player );
            NickAPI.resetProfileName( player );
            NickAPI.refreshPlayer( player );
            player.sendMessage( ChatColor.DARK_RED + "Successfully reset nick" );
            break;
        default:
            String name = args[0];
            NickAPI.setNick( player, name );
            NickAPI.setSkin( player, name );
            NickAPI.setUniqueId( player, name );
            NickAPI.setProfileName( player, name );
            NickAPI.refreshPlayer( player );
            player.sendMessage( ChatColor.DARK_GREEN + "Successfully set the nickname to " + ChatColor.YELLOW + name );
            break;
    }
    return true;
}

❓常见问题解答

问：我把插件放进 NickAPI 文件夹了，但什么都没发生。为什么？

• 答：这个插件本身不提供任何游戏内功能。它是一个纯粹的开发工具 API，需要开发者编写代码调用才能起作用。

问：为什么移除了 1.7 服务器支持？

• 答：1.7 版本需要大量的额外工作来适配，且无法支持客户端 UUID 欺骗功能。它使用的 GameProfile、JSON 类等关键类库导入方式也不同。此外，这是一个非常古老的版本，基本已无人使用。

问：这个插件是否包含任何不该有的内容？

• 答：和以往的 NickAPI 版本一样，我们的团队仅会在玩家加入服务器时收到一条通知消息。你无需担心隐私或安全问题。

问：我运行的是离线模式（Cracked）服务器，功能似乎不工作？

• 答：请按以下步骤操作：
• 下载 BungeeCord 端插件：https://www.spigotmc.org/resources/nickapibungee.81107/ 并放入你的 BungeeCord 插件文件夹。
• 进入 NickAPI 的配置文件，将 cracked 选项设置为 true。

✨重要提示

• NickAPI 7.0 及以上版本已移除基于实例的 API 调用方式，所有核心方法现已改为静态方法，调用更简便。
• 部分方法名称在 7.0 版本中进行了重命名。如果你需要支持 1.7 版本，请使用 NickAPI 5.x 版本。
• 这是一个供开发者使用的 API。如果你需要一个开箱即用的完整昵称插件，可以参考基于此 API 实现的 HaoNick：
• 下载地址：https://www.spigotmc.org/resources/haonick-advanced-nick-plugin-1-7-1-16.81108/

如有任何问题或需要报告错误，欢迎加入我们的 Discord 社区：https://haoshoku.xyz/go/discord