Packet Handling

Interact with the raw Minecraft protocol to implement advanced features.

1. Listen to Packets

Create a class that extends SessionAdapter. Please use getLogger() to log information.

import org.geysermc.mcprotocollib.network.event.session.SessionAdapter;
import org.geysermc.mcprotocollib.network.packet.Packet;
import org.geysermc.mcprotocollib.network.session.Session;
import xin.bbtt.mcbot.plugin.Plugin;

public class MyPacketListener extends SessionAdapter {
    private final Plugin plugin;

    public MyPacketListener(Plugin plugin) {
        this.plugin = plugin;
    }

    @Override
    public void packetReceived(Session session, Packet packet) {
        // Log received packet names for debugging
        plugin.getLogger().debug("Received: {}", packet.getClass().getSimpleName());
    }
}

---

2. Sending Packets (e.g., Respawn)

When you listen to a specific event or receive a packet, you can send custom packets to the server using the provided session parameter (or by accessing Bot.Instance.getSession() globally).

Below is the correct way to send a "Respawn" request (ServerboundClientCommandPacket) inside an event callback:

import org.geysermc.mcprotocollib.network.session.Session;
import org.geysermc.mcprotocollib.protocol.data.game.ClientCommand;
import org.geysermc.mcprotocollib.protocol.packet.ingame.serverbound.ServerboundClientCommandPacket;

// Assuming this code is inside a method that has access to a session instance,
// such as inside packetReceived(Session session, Packet packet):
session.send(new ServerboundClientCommandPacket(
    ClientCommand.RESPAWN
));

---

3. Registering the Listener

Register the listener in your plugin's onEnable() hook:

@Override
public void onEnable() {
    Bot.Instance.addPacketListener(new MyPacketListener(this), this);
}