GeoPlugin

Minecraft 版本： 1.20 1.20.1 1.20.2 1.20.3 1.20.4 1.20.5 1.20.6 1.21 1.21.1 1.21.2 1.21.3 1.21.4 1.21.5 1.21.6 1.21.7 1.21.8 1.21.9 1.21.10 1.21.11

平台： paper purpur spigot

标签： management social utility

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.