Minecraft

PocketMine "raklib" is blocking an IP — what do I do?

If your PocketMine server logs show "raklib" blocking an IP, that is PocketMine's network layer doing its job. In most cases it is protective and clears on its own. This article explains what is happening and how to handle a legitimate player getting caught.

What raklib is

RakLib is PocketMine's network layer. When it blocks an address, it is usually rate-limiting or anti-spam kicking in after a flood of packets. This behavior is normally protective, and the block often clears on its own.

What to do

Work through this based on who is being blocked.

  1. A legitimate player is blocked? Check PocketMine's network/anti-flood config to whitelist the address or relax the threshold, then restart.
  2. Everyone is being blocked persistently? That points at a network or config issue rather than normal protection — gather the log and share it in a ticket.

Tip: Do not rush to disable RakLib's protection entirely. Loosen the threshold for a known-good player instead, so you keep the anti-flood defense against real spam.

Frequently asked questions

Is a raklib block a problem? Usually not. It is PocketMine's anti-spam/rate-limiting protecting your server, and it typically clears by itself.

How do I unblock a real player? Adjust PocketMine's network/anti-flood config to whitelist them or raise the threshold, then restart the server.

It is blocking everyone constantly — what now? That suggests a network or configuration problem, not normal protection. Share the log with us in a ticket so we can help investigate.