HamsterAPI

`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.

PacketDecodeEvent When: Fires after the raw bytes are decompressed but before they are decoded into a full packet object. What you get: A raw `ByteBuf` object. 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 `PacketWrapper` object. What you get: A user-friendly `PacketWrapper` object. * Ideal for: Most common use-cases like creating cosmetics, canceling game events, or modifying game behavior.

To listen for events, register a listener class just as you would with Bukkit events. For more details, see the (https://www.spigotmc.org/wiki/using-the-event-api/).

Example: Listening for a Packet ```java 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); } } } ```

```java // 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); ```

```java HamsterPlayer hamsterPlayer = HamsterAPI.getInstance().getHamsterPlayerManager().get(player);

hamsterPlayer.sendActionbar("§eYou have §c5§e new messages."); ```