Logo
GeoPlugin
PluginMIT

GeoPlugin

GeoPlugin is a lightweight Minecraft plugin for GeoIP-based access control, VPN/proxy detection, and security alerts via webhooks.

28
Downloads
0
Followers
2 months ago
Updated
📦
1
Versions
managementsocialutilitypaperpurpurspigot
Download Latestv1.0.0View on Modrinth

📖About 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.

example

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.

discord webhook
discord webhook vpn

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.

geoplugin webhook 3

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

command example

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)

placeholders

Recommended Use

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