VoidAC — 适用于 Paper 1.16.5 的高级反作弊插件
VoidAC 是一款功能强大、模块化的反作弊插件,专为 Paper 1.16.5 服务器设计。它拥有独特的基于置信度的惩罚系统、全面的作弊检测能力以及为服务器管理员提供的丰富工具集。
与传统的立即封禁的反作弊插件不同,VoidAC 会随时间推移为每个玩家建立置信度分数,从而消除误报,同时也能捕捉到最谨慎的作弊者。
功能特性
检测模块
- KillAura(杀戮光环) — CPS(每秒点击次数)、攻击距离、瞄准偏差、穿墙命中(多因素评分,无误报)
- PlayerProfiler(玩家分析器) — 带有单玩家基线的统计分析、异常检测(>3σ)、轨迹预测
- AimAnalyzer(瞄准分析器) — 瞬狙检测、网格对齐、人类噪声分析、锁定追踪
- ReplayRecorder(回放录制器) — 20秒循环缓冲区,将回放保存/加载为 JSON 格式,支持管理员回放
- BadPackets(恶意数据包) — 数据包轰炸、无效坐标、NBT 篡改
- Anti-Xray(反透视) — 隐藏墙壁后的矿石(异步处理,零延迟)
- GrimAC 集成 — 自动检测 GrimAC 并将数据输入置信度系统
管理工具
- Confidence System(置信度系统) — 可配置的衰减、阈值、自动封禁、尖峰检测
- ColorUtils(颜色工具) — 完整支持十六进制颜色 (
&#RRGGBB)、渐变色 (<gradient:#:#>)、旧版颜色支持
- Language System(语言系统) — 英文和俄文,所有消息均可在
config.yml 中编辑
- Ban Animation(封禁动画) — 封禁时播放戏剧性的红色螺旋 + 爆炸效果 (
/vac ban)
- Fake Lag(假延迟) — 4 种类型的延迟模拟:连接、方块、实体、全部 (
/vac lags)
- Client Crash(客户端崩溃) — 多种崩溃方法:书籍、告示牌、爆炸、粒子、洪水 (
/vac crash)
- Spectate(旁观) — 隐身旁观,置信度显示在动作栏 (
/vac spectate)
- Freeze(冻结) — 青色粒子冻结效果 (
/vac freeze)
- Player Reports(玩家举报) — 玩家可举报他人,增加置信度 (
/vac report)
- Provocation Checks(挑衅检查) — 5 阶段自动化检查 (
/vac check)
- VPN Detection(VPN 检测) — IP 地理位置查询 (
/vac checkvpn)
- Evidence Logging(证据记录) — 所有违规行为存储在数据库中 (
/vac history)
通知与集成
- In-Game Alerts(游戏内警报) — 实时作弊警报,支持可配置阈值
- ActionBar Spectate(动作栏旁观) — 实时显示目标置信度
- Discord Bot(Discord 机器人) — 原生基于 WebSocket 的机器人(零依赖),支持斜杠命令:
/ban, /freeze, /unfreeze, /check, /stats
- 用于确认封禁/冻结的按钮
- Discord Webhooks(Discord Webhook) — 封禁和警报通知
- Bungee/Velocity — 跨服务器封禁/警报同步
- Auto-Updater(自动更新器) — 检查 GitHub 发布版本,并在玩家加入时通知管理员
- PlaceholderAPI(独立扩展包) —
%vac_confidence_<player>%, %vac_cps_<player>%, %vac_reach_<player>% 等
数据库
- MySQL — 完全支持连接池
- SQLite — 内置回退选项(零配置)
命令
| 命令 |
描述 |
权限 |
/vac help |
显示帮助信息 |
vac.admin |
/vac ban <player> |
带动画封禁 |
vac.command.ban |
/vac profile <player> |
玩家档案 |
vac.command.profile |
/vac lags <player> [type] |
假延迟 |
vac.command.lags |
/vac confidence <player> <action> [value] |
管理置信度 |
vac.command.confidence |
/vac crash <player> [method] |
崩溃客户端 |
vac.command.crash |
/vac alerts [on/off] |
切换警报 |
vac.alerts |
/vac spectate <player/stop> |
旁观玩家 |
vac.command.spectate |
/vac report <player> <reason> |
举报玩家 |
vac.report |
/vac check <player> |
挑衅检查 |
vac.command.check |
/vac checkvpn <player> |
VPN 检查 |
vac.command.checkvpn |
/vac history <player> |
违规历史 |
vac.command.history |
/vac freeze <player> [off] |
冻结玩家 |
vac.command.freeze |
/vac cps <player> |
显示 CPS 统计 |
vac.command.cps |
/vac reach <player> |
显示攻击距离统计 |
vac.command.reach |
/vac hits <player> |
显示详细命中统计 |
vac.command.hits |
/vac update |
检查更新 |
vac.command.update |
/vac version |
显示插件版本 |
vac.command.version |
/vac replay <player> [save] |
回放记录的数据 |
vac.command.replay |
/vac settings |
设置 GUI |
vac.admin |
/vac reload |
重载配置 |
vac.command.reload |
/vac stats |
服务器统计 |
vac.admin |
安装指南
- 下载 最新版本的 jar 文件,访问 Releases
- 放置
VoidAC.jar 到服务器的 plugins/ 文件夹中
- 重启 你的服务器(或执行
/reload)
- 配置
plugins/VoidAC/config.yml 以满足你的需求
环境要求
- Paper 1.16.5(或兼容分支)
- Java 8 或更高版本
- GrimAC(可选,推荐)— 用于 GrimAC 集成
- PacketEvents(可选)— 用于优化的数据包处理
- PlaceholderAPI(可选)— 用于占位符扩展
配置说明
所有设置均位于 plugins/VoidAC/config.yml 中。主要部分如下:
MySQL(可选,默认使用 SQLite)
mysql:
enabled: false
host: localhost
port: 3306
database: vac_anticheat
username: root
password: ""
置信度系统
confidence:
increment_per_violation: 2.0
max_confidence: 100.0
ban_threshold: 100.0
decay_per_second: 0.5
decay_delay_seconds: 30
decay_min_confidence: 5.0
spike_window_seconds: 10
spike_multiplier: 2.5
auto_ban: true
语言
language: en # "en" 或 "ru"
# 消息可在 messages.en.* / messages.ru.* 下编辑
Discord 机器人
discord:
enabled: false
token: "YOUR_BOT_TOKEN"
channel_id: "YOUR_CHANNEL_ID"
KillAura 检测
killaura:
threshold: 60.0
confidence_increment: 3.0
max_cps: 8.0
max_reach: 3.5
min_aim_deviation: 0.8
max_wall_ratio: 5.0
从源码构建
git clone https://github.com/SomeOneDay01/VoidAC.git
cd VoidAC
mvn clean package
编译后的 jar 包位于 target/VoidAC-1.0.3.jar。
置信度系统工作原理
- 违规记录 → 每次检测到的作弊行为都会增加该检查项下的玩家违规计数
- 置信度 → 每次违规会增加置信度百分比(可配置),并乘以累犯倍数和突发检测系数
- 衰减 → 如果没有新的违规行为,置信度会随时间线性衰减(可配置延迟、速率和最低保底值)
- 突发检测 — 在
spike_window_seconds 时间内快速发生的违规会触发 spike_multiplier 加成
- 自动封禁 → 当置信度达到
ban_threshold 时,玩家将被自动封禁
- 误报防护 → 最小样本量、多因素评分和冷却机制防止草率标记
这意味着:
- 偶尔误触一次穿墙的玩家不会被封禁
- 顽固的作弊者最终必然达到 100% 置信度
- 置信度永远不会完全重置(
decay_min_confidence)——习惯性作弊者会在多次会话中累积
- 服务器管理员拥有对阈值的完全控制权
权限
| 权限 |
默认设置 |
描述 |
vac.admin |
OP |
所有命令的完全访问权限 |
vac.alerts |
OP |
接收和管理警报 |
vac.report |
OP |
举报玩家 |
vac.command.* |
OP |
各个命令的独立权限 |
Discord 机器人设置
- 在 Discord Developer Portal 创建机器人
- 在机器人设置中启用 Message Content Intent(消息内容意图)
- 使用
applications.commands 和 bot 作用域邀请机器人
- 在 config.yml 中设置
discord.token 和 discord.channel_id
- 重启服务器 —— 斜杠命令将自动注册
可用的 Discord 命令
/ban <player> — 带确认按钮的封禁操作
/freeze <player> — 带确认按钮的冻结操作
/unfreeze <player> — 解冻玩家
/check <player> — 显示玩家统计信息
/stats — 服务器统计数据
开发者 API
VoidAC 通过 VAC.getInstance() 暴露其管理器:
VAC vac = VAC.getInstance();
// 访问玩家数据
PlayerData data = vac.getPlayerDataManager().getOrCreate(player);
data.addViolation("Speed", 1);
// 置信度
data.getConfidence();
data.addConfidence(5.0);
// 封禁
vac.getPunishmentManager().banPlayer(player, "Console", true);
// 分析
vac.getPlayerProfiler().getCpsAnomalyScore(player);
vac.getAimAnalyzer().getOverallAimScore(player);
vac.getReplayRecorder().saveReplay(player);
支持
许可证
本项目采用 MIT 许可证授权。
VoidAC — Advanced Anti-Cheat for Paper 1.16.5
VoidAC is a powerful, multi-module anti-cheat plugin for Paper 1.16.5 servers. It features a unique confidence-based punishment system, comprehensive cheat detection, and an extensive toolkit for server administrators.
Unlike traditional anti-cheats that ban instantly, VoidAC builds a confidence score per player over time, eliminating false positives while catching even the most careful cheaters.
Features
Detection Modules
- KillAura — CPS, reach, aim deviation, through-wall hits (multi-factor scoring, no false flags)
- PlayerProfiler — statistical profiling with per-player baselines, anomaly detection (>3σ), trajectory prediction
- AimAnalyzer — snap detection, grid alignment, human noise analysis, lock-on tracking
- ReplayRecorder — rolling 20-second buffer, save/load replay to JSON, admin playback
- BadPackets — Packet spam, invalid coordinates, NBT manipulation
- Anti-Xray — Hides ores behind walls (async, zero-lag)
- GrimAC Integration — auto-detects GrimAC and feeds data into confidence system
Administrative Tools
- Confidence System — configurable decay, thresholds, auto-ban, spike detection
- ColorUtils — full hex (
&#RRGGBB), gradient (<gradient:#:#>), legacy color support
- Language System — English & Russian, all messages editable in
config.yml
- Ban Animation — dramatic red spiral + explosion on ban (
/vac ban)
- Fake Lag — 4 types of lag simulation: connection, block, entity, all (
/vac lags)
- Client Crash — multiple crash methods: book, sign, explosion, particles, flood (
/vac crash)
- Spectate — invisible spectating with confidence in actionbar (
/vac spectate)
- Freeze — aqua particle freeze effect (
/vac freeze)
- Player Reports — players report others, confidence increases (
/vac report)
- Provocation Checks — 5-phase automated check (
/vac check)
- VPN Detection — IP geolocation lookup (
/vac checkvpn)
- Evidence Logging — all violations stored in database (
/vac history)
Notifications & Integration
- In-Game Alerts — real-time cheat alerts with configurable thresholds
- ActionBar Spectate — shows target confidence in real-time
- Discord Bot — native WebSocket-based bot (zero dependencies) with slash commands:
/ban, /freeze, /unfreeze, /check, /stats
- Buttons for ban/freeze confirmation
- Discord Webhooks — ban and alert notifications
- Bungee/Velocity — cross-server ban/alert synchronization
- Auto-Updater — checks GitHub releases and notifies admins on join
- PlaceholderAPI (separate expansion) —
%vac_confidence_<player>%, %vac_cps_<player>%, %vac_reach_<player>%, and more
Database
- MySQL — full support with connection pooling
- SQLite — built-in fallback (zero configuration)
Commands
| Command |
Description |
Permission |
/vac help |
Show help |
vac.admin |
/vac ban <player> |
Ban with animation |
vac.command.ban |
/vac profile <player> |
Player profile |
vac.command.profile |
/vac lags <player> [type] |
Fake lag |
vac.command.lags |
/vac confidence <player> <action> [value] |
Manage confidence |
vac.command.confidence |
/vac crash <player> [method] |
Crash client |
vac.command.crash |
/vac alerts [on/off] |
Toggle alerts |
vac.alerts |
/vac spectate <player/stop> |
Spectate player |
vac.command.spectate |
/vac report <player> <reason> |
Report player |
vac.report |
/vac check <player> |
Provocation check |
vac.command.check |
/vac checkvpn <player> |
VPN check |
vac.command.checkvpn |
/vac history <player> |
Violation history |
vac.command.history |
/vac freeze <player> [off] |
Freeze player |
vac.command.freeze |
/vac cps <player> |
Show CPS stats |
vac.command.cps |
/vac reach <player> |
Show reach stats |
vac.command.reach |
/vac hits <player> |
Show detailed hit stats |
vac.command.hits |
/vac update |
Check for updates |
vac.command.update |
/vac version |
Show plugin version |
vac.command.version |
/vac replay <player> [save] |
Replay recorded data |
vac.command.replay |
/vac settings |
Settings GUI |
vac.admin |
/vac reload |
Reload config |
vac.command.reload |
/vac stats |
Server statistics |
vac.admin |
Installation
- Download the latest jar from Releases
- Place
VoidAC.jar in your server's plugins/ folder
- Restart your server (or
/reload)
- Configure
plugins/VoidAC/config.yml to your needs
Requirements
- Paper 1.16.5 (or compatible fork)
- Java 8 or higher
- GrimAC (optional, recommended) — for GrimAC integration
- PacketEvents (optional) — for optimized packet handling
- PlaceholderAPI (optional) — for placeholder expansion
Configuration
All settings are in plugins/VoidAC/config.yml. Key sections:
MySQL (optional, SQLite used by default)
mysql:
enabled: false
host: localhost
port: 3306
database: vac_anticheat
username: root
password: ""
Confidence System
confidence:
increment_per_violation: 2.0
max_confidence: 100.0
ban_threshold: 100.0
decay_per_second: 0.5
decay_delay_seconds: 30
decay_min_confidence: 5.0
spike_window_seconds: 10
spike_multiplier: 2.5
auto_ban: true
Language
language: en # "en" or "ru"
# Messages editable under messages.en.* / messages.ru.*
Discord Bot
discord:
enabled: false
token: "YOUR_BOT_TOKEN"
channel_id: "YOUR_CHANNEL_ID"
KillAura Detection
killaura:
threshold: 60.0
confidence_increment: 3.0
max_cps: 8.0
max_reach: 3.5
min_aim_deviation: 0.8
max_wall_ratio: 5.0
Building from Source
git clone https://github.com/SomeOneDay01/VoidAC.git
cd VoidAC
mvn clean package
The compiled jar will be in target/VoidAC-1.0.3.jar.
How the Confidence System Works
- Violations → each detected cheat action increments the player's violation counter for that check
- Confidence → each violation adds confidence percentage (configurable), multiplied by repeat-offense multiplier and spike detection
- Decay → confidence decays linearly over time if no new violations occur (configurable delay, rate, and minimum floor)
- Spike Detection — rapid violations within
spike_window_seconds trigger spike_multiplier boost
- Auto-Ban → when confidence reaches
ban_threshold, the player is automatically banned
- False Positive Protection → minimum sample sizes, multi-factor scoring, cooldowns prevent hasty flags
This means:
- A player who accidentally clips once won't get banned
- A persistent cheater will inevitably reach 100% confidence
- Confidence never fully resets (
decay_min_confidence) — habitual cheaters accumulate over sessions
- Server admins have full control over thresholds
Permissions
| Permission |
Default |
Description |
vac.admin |
OP |
Full access to all commands |
vac.alerts |
OP |
Receive and manage alerts |
vac.report |
OP |
Report players |
vac.command.* |
OP |
Individual command permissions |
Discord Bot Setup
- Create a bot at Discord Developer Portal
- Enable Message Content Intent in Bot settings
- Invite bot with
applications.commands and bot scopes
- Set
discord.token and discord.channel_id in config.yml
- Restart the server — slash commands register automatically
Available Discord Commands
/ban <player> — Ban with confirmation buttons
/freeze <player> — Freeze with confirmation buttons
/unfreeze <player> — Unfreeze a player
/check <player> — Show player stats
/stats — Server statistics
API for Developers
VoidAC exposes its managers via VAC.getInstance():
VAC vac = VAC.getInstance();
// Access player data
PlayerData data = vac.getPlayerDataManager().getOrCreate(player);
data.addViolation("Speed", 1);
// Confidence
data.getConfidence();
data.addConfidence(5.0);
// Ban
vac.getPunishmentManager().banPlayer(player, "Console", true);
// Profiling
vac.getPlayerProfiler().getCpsAnomalyScore(player);
vac.getAimAnalyzer().getOverallAimScore(player);
vac.getReplayRecorder().saveReplay(player);
Support
License
This project is licensed under the MIT License.
评论 0
登录后参与评分
还没有评论,来抢沙发吧