# GeoPlugin<\/p>\n
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.<\/p>\n
<\/p>\n
## Main Features<\/p>\n
– **GeoIP country detection** using a local database.
\n– **Country access control** with `whitelist` and `blacklist` modes.
\n– **VPN\/Proxy detection** via proxycheck.io with optional login blocking.
\n– **Country statistics** (total connections + unique players).
\n– **Admin notifications** for blocked joins and suspicious activity.
\n– **Discord and custom webhook support** for external alerts.
\n– **Bilingual support**: English and Spanish.
\n– **Readable command output** with pagination for player lists.
\n– **Optional PlaceholderAPI integration** (auto-detected if installed).
\n– **Flexible bypass options**: permissions, IP whitelist, and player UUID whitelist.<\/p>\n
## Webhook Integrations<\/p>\n
GeoPlugin includes two webhook channels so you can route alerts exactly where you need them:<\/p>\n
– **Discord Webhook** for direct moderation alerts in Discord.
\n– **Custom Webhook** for n8n, Make, Zapier, internal APIs, or any HTTP endpoint.<\/p>\n
### Supported webhook events<\/p>\n
– Player blocked by country access control.
\n– Player blocked by VPN\/Proxy detection.
\n– Suspicious activity threshold reached.<\/p>\n
\n<\/p>\n
### Why this is useful<\/p>\n
– Keep staff informed in real time even when they are offline.
\n– Build automated actions (logging, notifications, incident pipelines).
\n– Integrate with your current moderation workflow without changing server gameplay.<\/p>\n
<\/p>\n
## Proxy\/Network Support<\/p>\n
GeoPlugin works correctly behind proxy setups (Velocity\/Bungee-style networks) **when IP forwarding is configured properly**.
\nWithout forwarding, the server cannot read the real player IP.<\/p>\n
## Commands<\/p>\n
– `\/geoplugin help` <\/p>\n ## Permissions (high level)<\/p>\n – `geoplugin.bypass` \u2192 bypass country + VPN checks Note: If a user has broad wildcard permissions (like `geoplugin.*`), bypass behavior may apply depending on your permission setup.<\/p>\n ## Dependencies<\/p>\n – **Required:** None <\/p>\n ## Recommended Use<\/p>\n GeoPlugin is ideal for servers that want stronger access control, better network visibility, and clear moderation alerts with minimal setup.<\/p>\n","protected":false},"excerpt":{"rendered":" GeoPlugin is a lightweight Minecraft plugin for GeoIP-based access control, VPN\/proxy detection, and security alerts via webhooks.<\/p>\n","protected":false},"featured_media":75336,"template":"","meta":{"_minecraft_slug":"geoplugin","_minecraft_project_id":"y7rnOtRC","_minecraft_author":"palgato","_minecraft_license":"MIT","_minecraft_downloads":9,"_minecraft_follows":0,"_minecraft_client_side":"unsupported","_minecraft_server_side":"required","_minecraft_storage_type":"zip","_minecraft_archive_name":"geoplugin.zip","_minecraft_size_bytes":6683347,"_minecraft_version_count":1,"_minecraft_updated_at":"2026-05-15T23:13:33.957835Z","_minecraft_date_created":"2026-04-15T22:21:58.032191Z","_minecraft_date_modified":"2026-04-07T06:46:33.774516Z","_minecraft_project_url":"https:\/\/modrinth.com\/mod\/geoplugin","_minecraft_icon_attachment_id":75336,"_minecraft_imported_at":"2026-06-04T08:49:59+00:00","_minecraft_import_hash":"f176d8be633dec18a7c64491c4bebf97","_minecraft_versions":"","_minecraft_links":"","_minecraft_gallery":"","_minecraft_api_metadata":""},"mod_category":[126,127,128,867,129,92],"mod_loader":[132,133,134],"minecraft_version":[59,36,60,93,94,101,102,62,37,40,41,73,74,38,78,79,80,81,82],"class_list":["post-75335","mod","type-mod","status-publish","has-post-thumbnail","hentry","mod_category-management","mod_category-paper","mod_category-purpur","mod_category-social","mod_category-spigot","mod_category-utility","mod_loader-paper","mod_loader-purpur","mod_loader-spigot","minecraft_version-1-20","minecraft_version-1-20-1","minecraft_version-1-20-2","minecraft_version-1-20-3","minecraft_version-1-20-4","minecraft_version-1-20-5","minecraft_version-1-20-6","minecraft_version-1-21","minecraft_version-1-21-1","minecraft_version-1-21-10","minecraft_version-1-21-11","minecraft_version-1-21-2","minecraft_version-1-21-3","minecraft_version-1-21-4","minecraft_version-1-21-5","minecraft_version-1-21-6","minecraft_version-1-21-7","minecraft_version-1-21-8","minecraft_version-1-21-9"],"yoast_head":"\n
\n– `\/geoplugin reload`
\n– `\/geoplugin countrycheck
\n– `\/geoplugin vpncheck
\n– `\/geoplugin ip
\n– `\/geoplugin list [page]`
\n– `\/geoplugin stats`
\n– `\/geoplugin notify`<\/p>\n
\n– `geoplugin.bypass.country` \u2192 bypass country checks only
\n– `geoplugin.bypass.vpn` \u2192 bypass VPN checks only<\/p>\n
\n– **Optional:** PlaceholderAPI (for placeholders)<\/p>\n