<\/p>\n
# HamsterAPI: Your Ultimate Minecraft Packet Manipulation Toolkit<\/p>\n
### Effortlessly intercept, modify, and send packets without ever touching NMS or Reflection.<\/p>\n
—<\/p>\n
## What is HamsterAPI?<\/p>\n
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.<\/p>\n
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.<\/p>\n
## Key Features<\/p>\n
* \ud83d\ude80 **Powerful Packet Interception:** Listen, modify, and cancel any packet with a flexible, priority-based event system.
\n* \ud83d\udce6 **NMS-Free Packet Sending:** Effortlessly send Titles, ActionBars, and other packets to players without the headache of Reflection or version-specific code.
\n* \ud83d\udee1\ufe0f **Advanced Player Control:** Safely disconnect players with a custom message or instantly close their connecti: Your Ultimate Minecraft Packet Manipulation Toolkiton channel.
\n* \ud83c\udf10 **Seamless BungeeCord Integration:** Easily switch players between servers, use plugin messaging channels, and manage your network.
\n* \ud83d\udee0\ufe0f **Optimized Utilities:** Access our streamlined reflection and byte buffer utilities to build advanced, version-independent features.<\/p>\n
—<\/p>\n
## Getting Started<\/p>\n 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.<\/p>\n “`yaml 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:<\/p>\n “`java From this instance, you can access all the core managers and utilities:<\/p>\n * `getHamsterPlayerManager()` – Manage player-specific actions like sending packets or disconnecting. —<\/p>\n ## Core Concepts & Usage Examples<\/p>\n HamsterAPI offers a robust event system for intercepting packets at different stages of the network pipeline.<\/p>\n **The Pipeline Flow:** `Client -> [Splitter & Decompress] -> PacketDecodeEvent -> [Decoder] -> PacketReceiveEvent -> Server`<\/p>\n * **PacketDecodeEvent** * **PacketReceiveEvent \/ PacketSendEvent** To listen for events, register a listener class just as you would with Bukkit events. For more details, see the Spigot Event API Guide.<\/p>\n **Example: Listening for a Packet** @EventHandler if (packetName.equals(“PacketPlayOutChat”)) { \/\/ You can even cancel the packet “`java \/\/ Send a title that fades in over 1s, stays for 3s, and fades out over 1s. “`java hamsterPlayer.sendActionbar(“\u00a7eYou have \u00a7c5\u00a7e new messages.”); This sends a formal disconnect packet, allowing the client to gracefully handle the kick and display your custom reason.<\/p>\n “`java hamsterPlayer.disconnect(“\u00a7cYou have been kicked for being awesome.”); This immediately terminates the channel without sending a formal packet. Use this for anti-cheat or emergency situations where an instant disconnect is required.<\/p>\n “`java hamsterPlayer.closeChannel(); “`java \/\/ The server name must match the name in your BungeeCord config.yml —<\/p>\n ## Roadmap: The Future of HamsterAPI<\/p>\n We are constantly working to expand the API’s capabilities. Here\u2019s what\u2019s on the horizon:<\/p>\n * **BossBar API:** A simple, version-independent way to create and manage custom BossBars. ### Get started with HamsterAPI today and take full control of your server’s network communication<\/p>\n","protected":false},"excerpt":{"rendered":" Lightweight Spigot\/Bukkit API library that provides developers with utility methods, performance-focused abstractions, and shared systems to speed up plugin development.<\/p>\n","protected":false},"featured_media":78984,"template":"","meta":{"_minecraft_slug":"hamsterapi","_minecraft_project_id":"indGVLxv","_minecraft_author":"LinsaFTW","_minecraft_license":"MIT","_minecraft_downloads":6142,"_minecraft_follows":13,"_minecraft_client_side":"unsupported","_minecraft_server_side":"required","_minecraft_storage_type":"zip","_minecraft_archive_name":"hamsterapi.zip","_minecraft_size_bytes":287571,"_minecraft_version_count":6,"_minecraft_updated_at":"2026-05-16T02:54:56.781770Z","_minecraft_date_created":"2025-10-05T21:04:26.503819Z","_minecraft_date_modified":"2026-03-30T18:18:26.713259Z","_minecraft_project_url":"https:\/\/modrinth.com\/mod\/hamsterapi","_minecraft_icon_attachment_id":78984,"_minecraft_imported_at":"2026-06-04T13:18:42+00:00","_minecraft_import_hash":"1c35b0875a329a330acf5bc8683cd39d","_minecraft_versions":"","_minecraft_links":"","_minecraft_gallery":"","_minecraft_api_metadata":""},"mod_category":[124,125,127,128,129],"mod_loader":[130,131,132,133,134],"minecraft_version":[339,340,341,357,359,360,379,382,385,438,446,449,110,111,112,113,114,115,116,117,118,119,120,46,47,48,49,50,51,52,53,54,55,56,57,58,59,36,60,93,94,101,102,62,37,40,41,73,74,38,78,79,80,81,82,22,23,24,25,26,27,28,29,30,31,860,861,862,863,864],"class_list":["post-78983","mod","type-mod","status-publish","has-post-thumbnail","hentry","mod_category-bukkit","mod_category-folia","mod_category-paper","mod_category-purpur","mod_category-spigot","mod_loader-bukkit","mod_loader-folia","mod_loader-paper","mod_loader-purpur","mod_loader-spigot","minecraft_version-1-10","minecraft_version-1-10-1","minecraft_version-1-10-2","minecraft_version-1-11","minecraft_version-1-11-1","minecraft_version-1-11-2","minecraft_version-1-12","minecraft_version-1-12-1","minecraft_version-1-12-2","minecraft_version-1-13","minecraft_version-1-13-1","minecraft_version-1-13-2","minecraft_version-1-14","minecraft_version-1-14-1","minecraft_version-1-14-2","minecraft_version-1-14-3","minecraft_version-1-14-4","minecraft_version-1-15","minecraft_version-1-15-1","minecraft_version-1-15-2","minecraft_version-1-16","minecraft_version-1-16-1","minecraft_version-1-16-2","minecraft_version-1-16-3","minecraft_version-1-16-4","minecraft_version-1-16-5","minecraft_version-1-17","minecraft_version-1-17-1","minecraft_version-1-18","minecraft_version-1-18-1","minecraft_version-1-18-2","minecraft_version-1-19","minecraft_version-1-19-1","minecraft_version-1-19-2","minecraft_version-1-19-3","minecraft_version-1-19-4","minecraft_version-1-20","minecraft_version-1-20-1","minecraft_version-1-20-2","minecraft_version-1-20-3","minecraft_version-1-20-4","minecraft_version-1-20-5","minecraft_version-1-20-6","minecraft_version-1-21","minecraft_version-1-21-1","minecraft_version-1-21-10","minecraft_version-1-21-11","minecraft_version-1-21-2","minecraft_version-1-21-3","minecraft_version-1-21-4","minecraft_version-1-21-5","minecraft_version-1-21-6","minecraft_version-1-21-7","minecraft_version-1-21-8","minecraft_version-1-21-9","minecraft_version-1-8","minecraft_version-1-8-1","minecraft_version-1-8-2","minecraft_version-1-8-3","minecraft_version-1-8-4","minecraft_version-1-8-5","minecraft_version-1-8-6","minecraft_version-1-8-7","minecraft_version-1-8-8","minecraft_version-1-8-9","minecraft_version-1-9","minecraft_version-1-9-1","minecraft_version-1-9-2","minecraft_version-1-9-3","minecraft_version-1-9-4"],"yoast_head":"\nStep 1: Add HamsterAPI as a Dependency<\/summary>\n
\nname: YourPlugin
\nversion: 1.0
\nmain: com.yourdomain.yourplugin.Main
\ndepend: [HamsterAPI]
\n“`
\n<\/details>\nStep 2: Access the API Instance<\/summary>\n
\nHamsterAPI api = HamsterAPI.getInstance();
\n“`<\/p>\n
\n* `getBungeeMessenger()` – Communicate with your BungeeCord proxy.
\n* `getPacketInjector()` – Manually inject or remove the API from a player’s network pipeline.
\n* `getBufferIO()` – A utility for decoding raw byte buffers into readable packets.
\n<\/details>\nHow to Listen to Packets<\/summary>\n
\n * **When:** Fires after the raw bytes are decompressed but *before* they are decoded into a full packet object.
\n * **What you get:** A raw `ByteBuf` object.
\n * **Ideal for:** Low-level security, fixing exploits, and analyzing raw network data.<\/p>\n
\n * **When:** Fires *after* the packet has been fully decoded into a `PacketWrapper` object.
\n * **What you get:** A user-friendly `PacketWrapper` object.
\n * **Ideal for:** Most common use-cases like creating cosmetics, canceling game events, or modifying game behavior.<\/p>\n
\n“`java
\npublic class MyPacketListener implements Listener {<\/p>\n
\n public void onPacketSend(PacketSendEvent event) {
\n \/\/ Get the packet’s name
\n String packetName = event.getPacket().getName();<\/p>\n
\n Player player = event.getPlayer();
\n player.sendMessage(“The server tried to send you a chat message!”);<\/p>\n
\n \/\/ event.setCancelled(true);
\n }
\n }
\n}
\n“`
\n<\/details>\nSend a Title and Subtitle<\/summary>\n
\n\/\/ Get the HamsterPlayer instance for a specific player
\nHamsterPlayer hamsterPlayer = HamsterAPI.getInstance().getHamsterPlayerManager().get(player);<\/p>\n
\n\/\/ Times are in ticks (20 ticks = 1 second)
\nhamsterPlayer.sendTitle(“\u00a7aWelcome!”, “\u00a77Enjoy your stay.”, 20, 60, 20);
\n“`
\n<\/details>\nSend an ActionBar Message<\/summary>\n
\nHamsterPlayer hamsterPlayer = HamsterAPI.getInstance().getHamsterPlayerManager().get(player);<\/p>\n
\n“`
\n<\/details>\nSafely Disconnect a Player (Packet Kick)<\/summary>\n
\nHamsterPlayer hamsterPlayer = HamsterAPI.getInstance().getHamsterPlayerManager().get(player);<\/p>\n
\n“`
\n<\/details>\nInstantly Close a Player’s Connection<\/summary>\n
\nHamsterPlayer hamsterPlayer = HamsterAPI.getInstance().getHamsterPlayerManager().get(player);<\/p>\n
\n“`
\n<\/details>\nSend a Player to another BungeeCord Server<\/summary>\n
\nHamsterPlayer hamsterPlayer = HamsterAPI.getInstance().getHamsterPlayerManager().get(player);<\/p>\n
\nhamsterPlayer.sendServer(“lobby-1”);
\n“`
\n<\/details>\n
\n* **Custom Plugin Channels:** Enable direct communication between your server-side plugin and client-side mods.
\n* **BungeeCord Listener:** A dedicated listener for receiving plugin messages from the BungeeCord proxy.<\/p>\n