VPNGuard - 反代理连接保护

VPNGuard 是一款用于阻止玩家通过 VPN 或代理等匿名网络连接服务器的插件。它能有效减少垃圾信息发送者、机器人及其他不受欢迎的玩家进入服务器，通过检测并踢出来自数据中心或托管服务 IP 地址的玩家。插件使用一个私有的、几乎每日更新的屏蔽列表来应对新的威胁。

💡主要功能

• 阻止来自 VPN、代理或数据中心 IP 地址的连接。
• 使用每日更新的私有屏蔽列表。
• 支持国家/地区的黑白名单管理。
• 支持子网/IP 段封禁。
• 可生成尝试使用 VPN 连接的玩家报告。
• 提供轻量级的 BungeeCord 版本。

🎮命令列表

所有命令均以 /vpnguard 开头。

通知与报告

• notify - 启用或禁用在玩家尝试使用 VPN 加入时的游戏内通知。
• report - 生成一份报告，列出所有尝试使用 VPN 连接服务器的玩家。
• lookup <玩家名或IP> - 查询任意在线玩家或 IP 地址的详细信息。

缓存与数据管理

• clearcache - 删除所有本地保存的缓存文件。
• clearip <IP地址> - 删除指定 IP 地址的本地缓存文件。

名单管理

• country - 切换国家/地区名单的黑白名单模式，并可进行添加、移除、查看或清空操作。
• subnet - 封禁或解封一个 IP 地址段。
• whitelist - 向全局白名单添加、移除、查看或清空某个 ISP/组织。

其他

• about - 查看插件信息。

🔧权限节点

• vpnguard.permission.bypass - 拥有此权限的用户或用户组将绕过所有检查。
• vpnguard.command.vpnguard - 允许使用 /vpnguard 命令。（默认：true）
• vpnguard.command.notify - 允许使用 /vpnguard notify 命令。（默认：OP）
• vpnguard.command.report - 允许使用 /vpnguard report 命令。
• vpnguard.command.clearcache - 允许使用 /vpnguard clearcache 命令。（默认：OP）
• vpnguard.command.clearip - 允许使用 /vpnguard clearip 命令。（默认：OP）
• vpnguard.command.country - 允许使用 /vpnguard country 命令。（默认：OP）
• vpnguard.command.subnet - 允许使用 /vpnguard subnet 命令。（默认：OP）
• vpnguard.command.whitelist - 允许使用 /vpnguard whitelist 命令。（默认：OP）
• vpnguard.command.lookup - 允许使用 /vpnguard lookup 命令。（默认：OP）
• vpnguard.command.about - 允许使用 /vpnguard about 命令。（默认：true）

⭐配置与变量

配置文件 (config.yml) 允许自定义踢出消息等。点击此处查看示例配置。

消息变量

在 “commands” 部分可使用以下变量

• %p - 代表正在连接的玩家。
• %ip - 获取连接玩家的 IP 地址。

在 “country-deny-message” 中可使用：

• %p - 代表正在连接的玩家。
• %countryname - 获取连接玩家所在的国家/地区名称。

✨报告生成

使用 /vpnguard report 命令可以生成一份详细的连接尝试报告。此功能在 VPNGuard v3.0 及以上版本中可用。

❓常见问题解答

插件可以查询多少玩家的信息？

• 目前后端 API 提供商设有每月 500 次请求的限制。如果在 config.yml 中启用了 api-cache，则每月可以无问题地查询 500 名独立玩家的信息。请注意，插件本身免费，但其使用的 API 后端服务并非免费。

当 API 月度限额用尽后会怎样？

• API 服务器将不再提供关于新加入用户的信息。此后，这些用户可能会根据 config.yml 中 bypass-check 的设定，被允许加入服务器或直接被踢出。

我的服务器每月新用户超过 500 名，能否获得更多请求次数？

• 可以。您需要购买一个 API 密钥，在撰写本文时，费用为每月 5 美元。

在哪里可以查看或购买所使用的 API？

• 您可以访问 API 提供商的主页：https://vpnblocker.net

🔧使用条款

• 请勿重新分发或重新上传本插件。开发者辛勤工作并提供更新，只要求保留出处。请将感兴趣的用户引导至本资源发布页面。
• 您仅可出于审计源代码的目的反编译本插件，不得为重新分发、转售或复制源代码而进行反编译。
• 请不要在评论区留下错误报告或问题，因为无法进行对话（仅限一次回复）。请到论坛帖子中回复。
• 如果您不了解此插件的用途，请不要给予差评。
• 如需帮助，请在论坛发帖！请在下载并为插件留下评价前阅读上述常见问题解答。开发者很乐意考虑任何建议和反馈。