[API] PacketListenerAPI - 数据包监听管理接口

PacketListenerAPI 提供了一个简便的方式来监听数据包的发送与接收，并包含修改数据包字段值的功能。

💡版本要求

• 3.8 版本之后需要 Java 11+。

🎮快速开始

通过 PacketListenerAPI.addPacketHandler 方法添加你的数据包处理器。

PacketListenerAPI.addPacketHandler(new PacketHandler() {
@Override
public void onSend(SentPacket packet) {
// 处理发送的数据包
}
@Override
public void onReceive(ReceivedPacket packet) {
// 处理接收的数据包
}
});

• 你可以使用 @PacketOptions 注解来限制需要处理的数据包类型。
• 如果你需要在 BungeeCord 服务器上直接操作数据包，请查看此 API 的 BungeeCord 版本。

✨功能示例

检查数据包

以下示例演示如何检查一个实体生成数据包。

方法一：非版本安全（不推荐）

此方法需要导入特定的数据包类，因此在 Minecraft 版本更新后可能失效。

if (packet.getPacket() instanceof PacketPlayOutSpawnEntity) {
// 正在生成一个实体
}

方法二：版本安全（推荐）

通过比较数据包名称来检查，这是跨版本兼容的推荐做法。

if (packet.getPacketName().equals("PacketPlayOutSpawnEntity")) {
// 正在生成一个实体
}

修改字段值

以下示例演示如何修改实体生成数据包中的实体类型字段。

if (packet.getPacketName().equals("PacketPlayOutSpawnEntity")) {
// 字段 "f" 定义了实体类型的整型ID
packet.setPacketValue("f", );
}

🔧项目依赖 (Maven)

将以下依赖添加到你的 pom.xml 文件中。

org.inventivetalent.packetlistenerapi 
api 
VERSION-SNAPSHOT 

• 仓库地址：https://jitpack.io/#org.inventivetalent/packetlistenerapi

❓兼容性与链接

• 此 API 与 APIManager 兼容。
• 源码仓库：查看项目源代码。
• 问题追踪：报告 Bug 或提出建议。
• Javadoc：查看详细的 API 文档。
• 官方网站：访问插件主页。

如果你喜欢这个资源，请为其评分。支持作者或本项目的捐赠也备受感激。