
HamsterAPI:你的终极 Minecraft 数据包操作工具包
无需触碰 NMS 或反射,即可轻松拦截、修改和发送数据包。
什么是 HamsterAPI?
HamsterAPI 是一个功能强大、高性能的库,旨在让开发者完全掌控 Minecraft 的网络协议。它提供了一个清晰的事件驱动抽象层,使您能够轻松且稳定地操纵跨多个服务器版本的传入和传出数据包。
忘掉维护复杂 NMS 代码的麻烦吧。使用 HamsterAPI,您将得到一个简单、优雅且面向未来的解决方案,适用于从创建自定义外观到在数据包层面修补漏洞的所有需求。
主要特性
- ? 强大的数据包拦截: 通过灵活且基于优先级的系统,监听、修改和取消任何数据包。
- ? 无 NMS 数据包发送: 毫不费力地向玩家发送标题(Titles)、动作栏(ActionBars)和其他数据包,无需担心反射或特定版本代码的问题。
- ?️ 高级玩家控制: 安全地断开玩家连接并显示自定义消息,或直接关闭其连接通道。
- ? 无缝 BungeeCord 集成: 轻松在服务器之间切换玩家,使用插件消息通道并管理您的网络。
- ?️ 优化后的实用工具: 访问我们精简的反射和字节缓冲区实用工具,构建高级且与版本无关的功能。
快速开始
步骤 1:将 HamsterAPI 添加为依赖项
首先,确保在插件的 plugin.yml 文件中将 HamsterAPI 包含为依赖项。这是确保您的插件正确加载的关键步骤。
name: YourPlugin
version: 1.0
main: com.yourdomain.yourplugin.Main
depend: [HamsterAPI]
步骤 2:获取 API 实例
HamsterAPI 所有功能的入口点是单例实例。您可以在代码中的任何位置通过静态调用获取它:
HamsterAPI api = HamsterAPI.getInstance();
通过此实例,您可以访问所有核心管理器和实用工具:
getHamsterPlayerManager()- 管理针对玩家的操作,如发送数据包或断开连接。getBungeeMessenger()- 与您的 BungeeCord 代理进行通信。getPacketInjector()- 手动向玩家的网络管道注入或移除 API。getBufferIO()- 用于将原始字节缓冲区解码为可读数据包的实用工具。
核心概念与使用示例
如何监听数据包
HamsterAPI 提供了强大的事件系统,用于在网络管道的不同阶段拦截数据包。
管道流程: 客户端 -> [分片器 & 解压缩] -> PacketDecodeEvent -> [解码器] -> PacketReceiveEvent -> 服务端
-
PacketDecodeEvent
- 触发时机: 在原始字节被解压缩后,但在它们被解码为完整的数据包对象之前触发。
- 获得内容: 一个原始的
ByteBuf对象。 - 适用场景: 底层安全防护、修复漏洞以及分析原始网络数据。
-
PacketReceiveEvent / PacketSendEvent
- 触发时机: 在数据包已完全解码为
PacketWrapper对象之后触发。 - 获得内容: 用户友好的
PacketWrapper对象。 - 适用场景: 大多数常见用例,如创建自定义外观、取消游戏事件或修改游戏行为。
- 触发时机: 在数据包已完全解码为
要监听事件,请像注册 Bukkit 事件一样注册一个监听器类。更多详情请参阅 Spigot Event API Guide。
示例:监听数据包
public class MyPacketListener implements Listener {
@EventHandler
public void onPacketSend(PacketSendEvent event) {
// 获取数据包的名称
String packetName = event.getPacket().getName();
if (packetName.equals("PacketPlayOutChat")) {
Player player = event.getPlayer();
player.sendMessage("服务器试图向你发送一条聊天消息!");
// 你甚至可以取消该数据包
// event.setCancelled(true);
}
}
}
发送标题和副标题
// 获取特定玩家的 HamsterPlayer 实例
HamsterPlayer hamsterPlayer = HamsterAPI.getInstance().getHamsterPlayerManager().get(player);
// 发送一个标题,淡入时间为 1s,停留 3s,淡出时间为 1s。
// 时间单位为刻(20 刻 = 1 秒)
hamsterPlayer.sendTitle("§a欢迎!", "§7享受您的入住。", 20, 60, 20);
发送动作栏消息
HamsterPlayer hamsterPlayer = HamsterAPI.getInstance().getHamsterPlayerManager().get(player);
hamsterPlayer.sendActionbar("§e你有 §c5§e 条新消息。");
安全断开玩家连接(数据包踢出)
这将发送一个正式的连接断开数据包,允许客户端优雅地处理踢出操作并显示您的自定义原因。
HamsterPlayer hamsterPlayer = HamsterAPI.getInstance().getHamsterPlayerManager().get(player);
hamsterPlayer.disconnect("§c因为你太棒了,你已被踢出。");
立即关闭玩家连接
这将立即终止通道而不发送正式数据包。请在反作弊或需要即时断开的紧急情况下使用此方法。
HamsterPlayer hamsterPlayer = HamsterAPI.getInstance().getHamsterPlayerManager().get(player);
hamsterPlayer.closeChannel();
将玩家发送到另一个 BungeeCord 服务器
HamsterPlayer hamsterPlayer = HamsterAPI.getInstance().getHamsterPlayerManager().get(player);
```java
// 服务器名称必须与你的 BungeeCord config.yml 中的名称匹配
hamsterPlayer.sendServer("lobby-1");
路线图:HamsterAPI 的未来
我们正不断努力扩展 API 的功能。以下是即将推出的内容:
- BossBar API: 一种简单、与版本无关的方式来创建和管理自定义 BossBars。
- 自定义插件通道: 启用服务端插件与客户端模组之间的直接通信。
- BungeeCord 监听器: 一个专用的监听器,用于接收来自 BungeeCord 代理的插件消息。
立即开始使用 HamsterAPI,全面掌控你服务器的网络通信

HamsterAPI: Your Ultimate Minecraft Packet Manipulation Toolkit
Effortlessly intercept, modify, and send packets without ever touching NMS or Reflection.
What is HamsterAPI?
HamsterAPI is a powerful, high-performance library designed to give developers complete control over Minecraft's network protocol. It provides a clean, event-driven abstraction layer, allowing you to manipulate incoming and outgoing packets with ease and stability across multiple server versions.
Forget the hassle of maintaining complex NMS code. With HamsterAPI, you get a simple, elegant, and future-proof solution for everything from creating custom cosmetics to patching exploits at the packet level.
Key Features
- ? Powerful Packet Interception: Listen, modify, and cancel any packet with a flexible, priority-based event system.
- ? NMS-Free Packet Sending: Effortlessly send Titles, ActionBars, and other packets to players without the headache of Reflection or version-specific code.
- ?️ Advanced Player Control: Safely disconnect players with a custom message or instantly close their connecti: Your Ultimate Minecraft Packet Manipulation Toolkiton channel.
- ? Seamless BungeeCord Integration: Easily switch players between servers, use plugin messaging channels, and manage your network.
- ?️ Optimized Utilities: Access our streamlined reflection and byte buffer utilities to build advanced, version-independent features.
Getting Started
Step 1: Add HamsterAPI as a Dependency
First, ensure HamsterAPI is included as a dependency in your plugin's plugin.yml file. This is a crucial step for your plugin to load correctly.
name: YourPlugin
version: 1.0
main: com.yourdomain.yourplugin.Main
depend: [HamsterAPI]
Step 2: Access the API Instance
The entry point to all of HamsterAPI's features is the singleton instance. You can get it anywhere in your code with a static call:
HamsterAPI api = HamsterAPI.getInstance();
From this instance, you can access all the core managers and utilities:
getHamsterPlayerManager()- Manage player-specific actions like sending packets or disconnecting.getBungeeMessenger()- Communicate with your BungeeCord proxy.getPacketInjector()- Manually inject or remove the API from a player's network pipeline.getBufferIO()- A utility for decoding raw byte buffers into readable packets.
Core Concepts & Usage Examples
How to Listen to Packets
HamsterAPI offers a robust event system for intercepting packets at different stages of the network pipeline.
The Pipeline Flow: Client -> [Splitter & Decompress] -> PacketDecodeEvent -> [Decoder] -> PacketReceiveEvent -> Server
-
PacketDecodeEvent
- When: Fires after the raw bytes are decompressed but before they are decoded into a full packet object.
- What you get: A raw
ByteBufobject. - Ideal for: Low-level security, fixing exploits, and analyzing raw network data.
-
PacketReceiveEvent / PacketSendEvent
- When: Fires after the packet has been fully decoded into a
PacketWrapperobject. - What you get: A user-friendly
PacketWrapperobject. - Ideal for: Most common use-cases like creating cosmetics, canceling game events, or modifying game behavior.
- When: Fires after the packet has been fully decoded into a
To listen for events, register a listener class just as you would with Bukkit events. For more details, see the Spigot Event API Guide.
Example: Listening for a Packet
public class MyPacketListener implements Listener {
@EventHandler
public void onPacketSend(PacketSendEvent event) {
// Get the packet's name
String packetName = event.getPacket().getName();
if (packetName.equals("PacketPlayOutChat")) {
Player player = event.getPlayer();
player.sendMessage("The server tried to send you a chat message!");
// You can even cancel the packet
// event.setCancelled(true);
}
}
}
Send a Title and Subtitle
// Get the HamsterPlayer instance for a specific player
HamsterPlayer hamsterPlayer = HamsterAPI.getInstance().getHamsterPlayerManager().get(player);
// Send a title that fades in over 1s, stays for 3s, and fades out over 1s.
// Times are in ticks (20 ticks = 1 second)
hamsterPlayer.sendTitle("§aWelcome!", "§7Enjoy your stay.", 20, 60, 20);
Send an ActionBar Message
HamsterPlayer hamsterPlayer = HamsterAPI.getInstance().getHamsterPlayerManager().get(player);
hamsterPlayer.sendActionbar("§eYou have §c5§e new messages.");
Safely Disconnect a Player (Packet Kick)
This sends a formal disconnect packet, allowing the client to gracefully handle the kick and display your custom reason.
HamsterPlayer hamsterPlayer = HamsterAPI.getInstance().getHamsterPlayerManager().get(player);
hamsterPlayer.disconnect("§cYou have been kicked for being awesome.");
Instantly Close a Player's Connection
This immediately terminates the channel without sending a formal packet. Use this for anti-cheat or emergency situations where an instant disconnect is required.
HamsterPlayer hamsterPlayer = HamsterAPI.getInstance().getHamsterPlayerManager().get(player);
hamsterPlayer.closeChannel();
Send a Player to another BungeeCord Server
HamsterPlayer hamsterPlayer = HamsterAPI.getInstance().getHamsterPlayerManager().get(player);
// The server name must match the name in your BungeeCord config.yml
hamsterPlayer.sendServer("lobby-1");
Roadmap: The Future of HamsterAPI
We are constantly working to expand the API's capabilities. Here’s what’s on the horizon:
- BossBar API: A simple, version-independent way to create and manage custom BossBars.
- Custom Plugin Channels: Enable direct communication between your server-side plugin and client-side mods.
- BungeeCord Listener: A dedicated listener for receiving plugin messages from the BungeeCord proxy.
Get started with HamsterAPI today and take full control of your server's network communication
下载 HamsterAPI
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 HamsterAPI
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 HamsterAPI
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 HamsterAPI
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 HamsterAPI
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 HamsterAPI
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 HamsterAPI
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
暂无更新日志
关于这个资源的讨论、问题反馈与使用心得
还没有讨论,来发第一帖吧
你是这个资源的作者?登录后可认领此资源。
相似资源
插件
PacketEvents 是一款专为 Minecraft Java 版打造的协议库,旨在简化数据包的处理与传输。
插件
使床在所有维度中爆炸的模组
插件
ExyliaPlugins 的库。
插件
通过对话框或铁砧界面帮助你的 Anthme
插件
自定义你的Minecraft头像!
插件
重新定义服务器上的生物运输方式。使用高度可定制的口袋道具,安全地捕获、存储和释放任何实体。
评论 0
登录后参与评分
还没有评论,来抢沙发吧