High-Performance VPN & Proxy Mitigation for Paper 1.21.1
ProxyIPGuard (PIG) is a lightweight security utility designed to protect your server from bot attacks, ban-evasion, and malicious "alt-account" spam. By leveraging asynchronous IP-intelligence lookups, PIG identifies and blocks connections originating from known data centers, VPN providers, and open proxies.
- Asynchronous Intelligence: IP lookups are performed off the main thread, ensuring zero impact on server TPS during player logins.
- Hosting/Proxy Detection: Specifically targets data-center IPs frequently used by botnets and griefers.
- Dynamic Whitelist: Allow trusted players to bypass VPN checks—ideal for staff or verified community members.
- Toggleable Protection: Enable or disable the guard instantly via in-game commands without needing a restart.
All commands require the pig.admin permission.
| Command | Action | Message Color |
|---|---|---|
/pig enable |
Activates proxy blocking. | §a (Green) |
/pig disable |
Deactivates proxy blocking. | §a (Green) |
/pig status |
Displays current state (On/Off). | §a (Green) |
/pig whitelist [name] |
Grants bypass to a player. | §a (Green) |
/pig unwhitelist [name] |
Revokes bypass from a player. | §a (Green) |
/pig help |
Displays all available commands. | §a (Green) |
# Toggle protection state
enabled: true
# List of players allowed to bypass detection
whitelist: []
# Proxy Intelligence API
api-endpoint: "[http://ip-api.com/json/](http://ip-api.com/json/)"
# Message shown to kicked proxy users
kick-message: "§cProxies/VPNs are not allowed on this server."