? 发现错误或有任何建议?
如果您遇到了错误或对项目有想法:
AntiVPN+
一款轻量级的 Paper 插件,通过 proxycheck.io 检测 VPN 和代理连接,并发送实时 Discord Webhook 警报。
功能特性
- 玩家加入时的代理/VPN 检测 —— 基于 proxycheck.io API
- Discord Webhook 警报 —— 包含玩家信息、IP、国家和风险数据的丰富嵌入卡片
- 可选的自动踢出 —— 阻止使用 VPN/代理的玩家加入服务器
- IP 白名单 —— 跳过对受信任 IP 的检查
- 内置缓存机制 —— 减少冗余的 API 调用(可配置 TTL)
- 异步设计 —— HTTP 请求在后台线程运行,不影响游戏主线程零延迟
- 重载命令 —— 无需重启服务器即可应用配置更改
依赖要求
- 服务端: Paper 1.21+
- Java 版本: 17+
- API 密钥: 一个 proxycheck.io 的 API 密钥(proxycheck.io 提供免费套餐)
安装步骤
- 从 发布页面 下载最新的
AntiVPNPlus.jar
- 将 jar 文件放入服务器的
plugins/ 文件夹中
- 重启服务器或运行
/reload(不建议在生产环境使用此命令)
- 在
plugins/AntiVPNPlus/config.yml 中配置插件
配置说明
# proxycheck.io 的 API 密钥(留空则使用免费套餐)
api-key: ""
# proxycheck.io API 端点
api-url: ""
# Discord Webhook URL(留空以禁用)
webhook-url: ""
# 是否对所有连接发送 webhook(false = 仅当检测到 VPN 时发送)
send-always: true
# 踢出被检测为 VPN/代理的玩家
kick-vpn: false
# IP 检查结果的缓存时间(分钟)
cache-duration-minutes: 60
# HTTP 请求超时时间(秒)
timeout-seconds: 5
# 跳过代理检查的 IP 地址列表
whitelist-ips:
- "127.0.0.1"
- "192.168.1.1"
配置项详解
| 选项 |
默认值 |
描述 |
api-key |
"" |
您的 proxycheck.io API 密钥。留空使用免费套餐(查询次数有限制)。 |
api-url |
"" |
自定义 API 端点。留空则使用默认的 proxycheck.io/v3/。 |
webhook-url |
"" |
用于加入警报的 Discord Webhook URL。留空以禁用。 |
send-always |
true |
向所有玩家发送 webhook (true) 还是仅在检测到 VPN 时发送 (false)。 |
kick-vpn |
false |
自动踢出被检测为 VPN/代理的玩家。 |
cache-duration-minutes |
60 |
在重新检查 IP 之前缓存 API 结果的时间长度。 |
timeout-seconds |
5 |
API 和 Webhook 调用的 HTTP 请求超时时间。 |
whitelist-ips |
["127.0.0.1"] |
完全绕过代理检查的 IP 地址列表。 |
命令列表
| 命令 |
权限 |
描述 |
/antivpn reload |
antivpn.reload (默认: op) |
重载插件配置 |
Discord Webhook
当玩家加入服务器时,插件会向您的 Discord 频道发送一个丰富的嵌入卡片:
该嵌入卡片显示:
- 玩家名称
- 连接状态(
VPN 或 No VPN)
- IP 地址
- 国家
( ⚠ 警告:插件创建者不对用户在其服务器上安装此插件的行为负责,我也对其他人的 IP 地址不承担责任。 )
? Found a bug or have a suggestion?
If you encountered a bug or have an idea for the project:
- Please open an Issue on GitHub.
AntiVPN+
A lightweight Paper plugin that detects VPN and proxy connections using proxycheck.io and sends real-time Discord webhook alerts.
Features
- Proxy/VPN detection on player join via proxycheck.io API
- Discord webhook alerts — rich embeds with player info, IP, country, and risk data
- Optional auto-kick — block VPN/proxy players from joining
- IP whitelist — skip checks for trusted IPs
- Built-in caching — reduces redundant API calls (configurable TTL)
- Async by design — HTTP requests run off the main thread, zero lag to gameplay
- Reload command — apply config changes without restarting the server
Requirements
- Server: Paper 1.21+
- Java: 17+
- API key: A proxycheck.io API key (free tier available at proxycheck.io)
Installation
- Download the latest
AntiVPNPlus.jar from the releases page
- Place the jar into your server's
plugins/ folder
- Restart the server or run
/reload (not recommended on production)
- Configure the plugin in
plugins/AntiVPNPlus/config.yml
Configuration
# API key for proxycheck.io (leave empty to use the free tier)
api-key: ""
# proxycheck.io API endpoint
api-url: ""
# Discord webhook URL (leave empty to disable)
webhook-url: ""
# Send webhook for every connection (false = VPN only)
send-always: true
# Kick players detected as VPN/proxy
kick-vpn: false
# How long to cache IP check results (minutes)
cache-duration-minutes: 60
# HTTP request timeout (seconds)
timeout-seconds: 5
# IPs to skip proxy checking for
whitelist-ips:
- "127.0.0.1"
- "192.168.1.1"
Config options
| Option |
Default |
Description |
api-key |
"" |
Your proxycheck.io API key. Leave empty for free tier (limited queries). |
api-url |
"" |
Custom API endpoint. Leave empty to use the default proxycheck.io/v3/. |
webhook-url |
"" |
Discord webhook URL for join alerts. Leave empty to disable. |
send-always |
true |
Send webhook for all players (true) or only when a VPN is detected (false). |
kick-vpn |
false |
Automatically kick players detected as VPN/proxy. |
cache-duration-minutes |
60 |
How long to cache API results before re-checking an IP. |
timeout-seconds |
5 |
HTTP request timeout for API and webhook calls. |
whitelist-ips |
["127.0.0.1"] |
IPs that bypass the proxy check entirely. |
Commands
| Command |
Permission |
Description |
/antivpn reload |
antivpn.reload (default: op) |
Reload the plugin configuration |
Discord Webhook
When a player joins, the plugin sends a rich embed to your Discord channel:
The embed shows:
- Player name
- Connection status (
VPN or No VPN)
- IP address
- Country
( ⚠ Warning: The plugin creator is not responsible for people who install this plugin on their server, and I am also not responsible for other people's IP addresses. )
评论 0
登录后参与评分
还没有评论,来抢沙发吧