MineGuardRealIP Plugin
Real player IP forwarding and direct connection protection
MineGuardRealIP is a plugin for Spigot/Paper servers that solves two problems: passing the player's real IP and protecting the server from direct connections that bypass the filter.
Why you need the plugin
When traffic flows through MineGuard, your server sees the filter's IP instead of the player's real IP. As a result:
- IP bans don't work — you ban the filter's IP, not the player's
- Geo-plugins show the wrong country
- Logs are useless — all connections show the same IP
- Anti-cheat plugins can't track players by IP
Without a plugin for IP forwarding you'd need to configure Proxy Protocol on the server side, which is more complex and isn't always possible. The plugin eliminates that requirement.
What the plugin does
- Passes the real IP — the plugin receives the player's real IP from the MineGuard filter and provides it to the server. All plugins and logs see the actual IP
- Blocks direct connections — if someone connects directly to the server (not through MineGuard), the plugin will reject them. This protects against IP leaks and bypass attacks
Installation
1
Download the plugin
Download the latest MineGuardRealIP on the mineguard.pro/plugin page.
2
Place it in plugins
Copy the
.jar file into your server's plugins/ folder.3
Restart the server
Restart your Minecraft server. The plugin will load automatically.
4
Enable it in the MineGuard panel
In your backend settings, enable Proxy Protocol v2 — the plugin will handle it automatically.
Once the plugin is installed, the server can only be reached through MineGuard. Direct IP connections will be blocked — this is expected behavior.
Compatibility
- Spigot / Paper — fully supported
- Versions — 1.8+
If you use BungeeCord or Velocity as a proxy in front of your game servers, install the plugin on the proxy, not on the backend servers.