GeoPlugin

GeoPlugin

GeoPlugin is an advanced GeoIP and VPN/Proxy protection plugin for Minecraft servers running on Paper, Purpur, and Spigot. It helps you control access by country, detect VPN/proxy usage on login, and notify your staff through in-game alerts and webhooks.

Main Features

- Flexible bypass options using a local database. - Flexible bypass options with `whitelist` and `blacklist` modes. - Flexible bypass options via proxycheck.io with optional login blocking. - Flexible bypass options (total connections + unique players). - Flexible bypass options for blocked joins and suspicious activity. - Flexible bypass options for external alerts. - Flexible bypass options: English and Spanish. - Flexible bypass options with pagination for player lists. - Flexible bypass options (auto-detected if installed). - Flexible bypass options: permissions, IP whitelist, and player UUID whitelist.

Webhook Integrations

GeoPlugin includes two webhook channels so you can route alerts exactly where you need them:

- Custom Webhook for direct moderation alerts in Discord. - Custom Webhook for n8n, Make, Zapier, internal APIs, or any HTTP endpoint.

Supported webhook events

- Player blocked by country access control. - Player blocked by VPN/Proxy detection. - Suspicious activity threshold reached.

Why this is useful

- Keep staff informed in real time even when they are offline. - Build automated actions (logging, notifications, incident pipelines). - Integrate with your current moderation workflow without changing server gameplay.

Proxy/Network Support

GeoPlugin works correctly behind proxy setups (Velocity/Bungee-style networks) when IP forwarding is configured properly. Without forwarding, the server cannot read the real player IP.

Commands

- `/geoplugin help` - `/geoplugin reload` - `/geoplugin countrycheck <ip|player>` - `/geoplugin vpncheck <ip|player>` - `/geoplugin ip <player>` - `/geoplugin list [page]` - `/geoplugin stats` - `/geoplugin notify`

Permissions (high level)

- `geoplugin.bypass` → bypass country + VPN checks - `geoplugin.bypass.country` → bypass country checks only - `geoplugin.bypass.vpn` → bypass VPN checks only

Note: If a user has broad wildcard permissions (like `geoplugin.*`), bypass behavior may apply depending on your permission setup.

Dependencies

- Optional: None - Optional: PlaceholderAPI (for placeholders)

Recommended Use

GeoPlugin is ideal for servers that want stronger access control, better network visibility, and clear moderation alerts with minimal setup.