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

• GeoIP country detection using a local database.
• Country access control with whitelist and blacklist modes.
• VPN/Proxy detection via proxycheck.io with optional login blocking.
• Country statistics (total connections + unique players).
• Admin notifications for blocked joins and suspicious activity.
• Discord and custom webhook support for external alerts.
• Bilingual support: English and Spanish.
• Readable command output with pagination for player lists.
• Optional PlaceholderAPI integration (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:

• Discord 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

• Required: 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.