GeoPlugin
GeoPlugin 是一款针对在 Paper、Purpur 和 Spigot 上运行的 Minecraft 服务器的先进 GeoIP 以及 VPN/代理防护插件。它帮助你按国家控制访问权限,检测登录时的 VPN/代理使用情况,并通过游戏内警报和网络钩子(webhooks)通知你的工作人员。

主要功能
- 使用本地数据库进行 GeoIP 国家检测。
- 支持
whitelist(白名单)和 blacklist(黑名单)模式的 国家访问控制。
- 通过 proxycheck.io 进行 VPN/代理检测,并可选择阻止登录。
- 国家统计信息(总连接数 + 唯一玩家数)。
- 针对被阻止的加入行为和可疑活动提供 管理员通知。
- 支持 Discord 和自定义 webhook 以发送外部警报。
- 双语支持:英语和西班牙语。
- 可读的命令输出,玩家列表支持分页。
- 可选的 PlaceholderAPI 集成(如果已安装则自动检测)。
- 灵活的绕过选项:权限、IP 白名单和玩家 UUID 白名单。
Webhook 集成
GeoPlugin 包含两个 webhook 通道,让你可以将警报精确路由到你需要的地方:
- Discord Webhook:用于在 Discord 中直接接收管理警报。
- 自定义 Webhook:用于 n8n、Make、Zapier、内部 API 或任何 HTTP 端点。
支持的 webhook 事件
- 因国家访问控制而被阻止的玩家。
- 因 VPN/代理检测而被阻止的玩家。
- 达到可疑活动阈值。
为什么这很有用
- 即使工作人员离线,也能让他们实时了解情况。
- 构建自动化操作(日志记录、通知、事件处理流程)。
- 与你当前的管理工作流程集成,而无需更改服务器游戏玩法。
代理/网络支持
当正确配置了 IP 转发时,GeoPlugin 可以在代理设置(Velocity/Bungee 风格网络)后方正常工作。
如果没有转发,服务器将无法读取玩家的真实 IP。
命令
/geoplugin help
/geoplugin reload
/geoplugin countrycheck <ip|player>
/geoplugin vpncheck <ip|player>
/geoplugin ip <player>
/geoplugin list [page]
/geoplugin stats
/geoplugin notify

权限(概览)
geoplugin.bypass → 绕过国家和 VPN 检查
geoplugin.bypass.country → 仅绕过国家检查
geoplugin.bypass.vpn → 仅绕过 VPN 检查
注意:如果用户拥有广泛的通配符权限(如 geoplugin.*),绕过行为可能会根据你的权限设置而适用。
依赖项
- 必需: 无
- 可选: PlaceholderAPI(用于占位符)

推荐用法
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.
评论 0
登录后参与评分
还没有评论,来抢沙发吧