Перейти к содержимому
Mineforgian

GeoPlugin

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

Загрузки
60
Подписчики
0
Обновлён
7 апреля 2026 г.
Лицензия
MIT

Опубликован 2 апреля 2026 г.

Исходный код

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.

Ченджлог

1.0.0Релиз1.21.9, 1.21.10, 1.21.11 · 7 апреля 2026 г.

Changelog

1.0.0 - 2026-04-07

Added

  • Core GeoIP detection using local database (countries.mmdb).
  • Country access control system with whitelist/blacklist modes.
  • VPN/Proxy detection via proxycheck.io with login-time checks and optional blocking.
  • Country statistics tracking (total connections + unique players by country).
  • Admin notifications for blocked joins, plus suspicious activity tracking.
  • Discord webhook integration for block/suspicious events.
  • Custom webhook integration for external automations.
  • PlaceholderAPI integration (optional, auto-register when installed).
  • Command suite: help, reload, countrycheck, vpncheck, ip, list, stats, notify.
  • EN/ES language support with plural-aware messages.
  • Paginated /geoplugin list output and improved /geoplugin stats readability.
  • Country/stats placeholders for scoreboards and HUDs.
  • VPN bypass by player UUID (vpn-detection.whitelist-player-uuids).

Improved

  • Stronger config validation and clearer configuration comments.
  • Better operational clarity around bypass permissions (geoplugin.*, geoplugin.bypass, geoplugin.bypass.vpn).
  • Better compatibility testing coverage with standalone and proxy-based labs.
  • Verified forwarding-based deployments with Velocity and Bungee-style setups.

Compatibility

  • Designed for Spigot/Paper API (api-version: 1.20).
  • Tested in local lab scenarios behind Velocity and Bungee-style proxies.
  • PlaceholderAPI support is optional (softdepend).

Removed

  • In-session IP-change kick logic.
  • VPN status placeholders (is_vpn, vpn_type, and player-targeted VPN placeholders).

Комментарии

Загружаем…