转载 闭源 反作弊 MatrixAntiVPN 1.0.0

[MD]
# MatrixAntiVPN

MatrixAntiVPN 是一款专为巴西服务器优化的全异步插件，可检测并拦截通过 VPN、代理、Tor 及托管服务发起的连接。

## 主要特性

- **高性能**：全程异步处理，不占用主线程，不影响 TPS，内置智能缓存与连接池。
- **精准检测**：多 API 并行集成，支持自动故障转移；内置巴西本土 ISP 过滤器，有效降低误判；可识别代理、VPN、Tor 及托管 IP。
- **灵活配置**：提供踢出（Kick）、警告（Warning）、仅记录（Log）三种处置模式；支持 BungeeCord / Velocity；支持 MySQL / SQLite；提供完整 API 供二次开发集成。
- **巴西本地化**：内置全国及各州 ISP 名单，针对共享宽带运营商做专项过滤，界面消息默认葡萄牙语。

## 安装

1. 下载 `MatrixAntiVPN.jar` 文件。
2. 将其放入服务器的 `plugins` 目录。
3. 重启服务器。
4. 按需编辑 `config.yml` 配置文件。
5. 执行 `/antivpn reload` 命令热重载配置。

## 命令

| 命令 | 说明 |
|------|------|
| `/antivpn reload` | 重载配置 |
| `/antivpn status` | 查看插件运行状态 |
| `/antivpn check <player|ip>` | 检查指定玩家或 IP |
| `/antivpn whitelist <add|remove|list> [ip]` | 管理白名单 |
| `/antivpn cache <clear|info>` | 管理缓存 |

## 权限节点

| 权限节点 | 说明 |
|----------|------|
| `matrixantivpn.*` | 授予全部权限 |
| `matrixantivpn.admin` | 管理员访问权限 |
| `matrixantivpn.bypass` | 跳过 VPN 检测 |
| `matrixantivpn.alerts` | 接收检测警报通知 |
| `matrixantivpn.check` | 允许检查 IP / 玩家 |

## 配置说明

- **处置模式**：`default`（踢出）、`warning`（警告）、`log`（仅记录）
- 检测服务商可自定义，支持多提供商冗余备用。
- 巴西 ISP 白名单列表可自行编辑。
- 数据库：默认使用 SQLite，大型网络推荐切换至 MySQL。

## 性能优化建议

- 多服联机网络建议使用 MySQL 作为后端数据库。
- 缓存容量可扩展至 50,000 条记录。
- 结合白名单与地区过滤规则，可大幅降低误判率。

## 支持与联系

- GitHub：[https://github.com/m4trixdev](https://github.com/m4trixdev)
- 邮箱：[[email protected]](https://www.spigotmc.org/cdn-cgi/l/email-protection))

## 许可证

Copyright © 2025 MatrixDev. All rights reserved.
[/MD]