
HrdaAPI 是一个强大的核心库(核心插件),为我其他项目中的功能提供支持。目前,它是 HrdaNick 插件的主要且必需的依赖项。
得益于 PacketEvents 的内部集成,它可以安全、可靠地监听和修改网络数据包。它主要专注于修改 PLAYER_INFO_UPDATE 数据包,从而允许直接在玩家头顶上方即时更改名称(名牌),而无需任何客户端模组。
⚙️ 对于服务器管理员
如果您想在您的服务器上运行我的 HrdaNick 插件(该插件最近突破了令人惊叹的 2,000 次下载里程碑!),您必须安装 HrdaAPI。
- 下载最新版本的 HrdaAPI。
- 下载最新版本的 PacketEvents
- 将下载的
.jar 文件放入服务器的 plugins 文件夹中。
- 重启服务器。
? 对于开发者 (API)
如果您正在创建自己的插件,并希望使用我稳定的系统来更改昵称和名牌,HrdaAPI 通过 HrdaNickAPI 类提供了非常简单的静态方法。
任何更改后,API 会自动处理数据包的重新编码以及一个不可见玩家的“刷新”(隐藏并再次显示玩家),以便周围的所有人能够正确且即时地加载新的名牌。
用法示例:
import cz.hrda.hrdaAPI.api.HrdaNickAPI;
import org.bukkit.entity.Player;
// 为玩家设置新昵称(包括其头顶上方的名牌)
HrdaNickAPI.setNick(player, "NewNick");
// 获取当前伪装的昵称
String nick = HrdaNickAPI.getNick(player);
// 检查玩家当前是否有修改过的昵称
boolean hasNick = HrdaNickAPI.hasNick(player);
// 安全地移除自定义昵称并恢复为原始名称
HrdaNickAPI.resetNick(player);
// 手动强制刷新周围玩家的名牌
HrdaNickAPI.refreshPlayer(player);

HrdaAPI is a powerful core library (core plugin) that powers features in my other projects. Currently, it serves as the main and required dependency for the HrdaNick plugin.
Thanks to the internal integration of PacketEvents, it can safely and reliably listen to and modify network packets. It primarily focuses on modifying PLAYER_INFO_UPDATE packets, which allows for instant name (nametag) changes directly above the player's head without requiring any client-side mods.
⚙️ For Server Owners
If you want to use my HrdaNick plugin on your server (which recently surpassed an amazing milestone of 2,000 downloads!), you must have HrdaAPI installed.
- Download the latest version of HrdaAPI.
- Download the latest version of PacketEvents
- Place the downloaded
.jar files into the plugins folder on your server.
- Restart your server.
? For Developers (API)
If you are creating your own plugins and want to use my stable system for changing nicknames and nametags, HrdaAPI offers very simple static methods via the HrdaNickAPI class.
Upon any change, the API automatically takes care of packet re-encoding and an invisible player "refresh" (hiding and showing the player again) so that the new nametag loads correctly and instantly for everyone around.
Usage examples:
import cz.hrda.hrdaAPI.api.HrdaNickAPI;
import org.bukkit.entity.Player;
// Setting a new nickname for a player (including the nametag above their head)
HrdaNickAPI.setNick(player, "NewNick");
// Getting the currently spoofed nickname
String nick = HrdaNickAPI.getNick(player);
// Checking if the player currently has a modified nickname
boolean hasNick = HrdaNickAPI.hasNick(player);
// Safely removing the custom nickname and reverting to the original name
HrdaNickAPI.resetNick(player);
// Manually forcing a nametag refresh for surrounding players
HrdaNickAPI.refreshPlayer(player);
评论 0
登录后参与评分
还没有评论,来抢沙发吧