VectorGuard
适用于 Paper 服务器的生产级战斗反作弊插件。
VectorGuard 是一款 100% 服务端反作弊插件,专注于战斗检测。它利用数据包级别的分析、基于刻(tick)遥测和多信号检测技术,以高准确率和极低的误报率识别作弊者。
专为现代 Paper 服务器(1.20.x–1.21.x)及 Java 21 从头构建。
产品概览
VectorGuard 是一款仅针对战斗的反作弊系统,旨在捕获最常见的 PvP 漏洞,同时保持轻量级的性能消耗和对合法玩家的公平性。每一项检查都使用多个独立信号(旋转、时机、移动、冷却使用情况和命中验证),并应用带有衰减缓冲违规机制,因此单次突发不会惩罚正常玩家。针对高延迟玩家的 Ping 感知阈值和数据包计时补偿功能进一步降低了误报率。
管理员拥有快速响应的工作流:包含操作按钮的可点击游戏内警报、聚合跨检查风险的威胁评分,以及用于快速证据审查的可视化报告命令。内置 GUI 允许工作人员调整阈值、切换检查项和调整处罚,无需编辑文件或重启服务器。警报还可以镜像到 Discord 以便进行服务器外监控。
VectorGuard 作为单个 jar 文件发布,无外部依赖。PacketEvents 已嵌入其中,插件完全在服务端运行,无需客户端模组。
功能特性
检测引擎
- 19 项战斗检查,针对最常见的作弊模块,包括战锤 PvP 漏洞、水晶 PvP 自动化、弓操控和库存漏洞
- 多信号复合检测 — 每项检查结合多个独立信号以确保高置信度
- 带可配置衰减的缓冲违规系统 — 防止单刻异常触发处罚
- 延迟补偿 — 所有检查均考虑玩家 Ping,避免对高 Ping 玩家进行错误标记
- 基于刻的分析 — 提供每位玩家的位置历史和旋转配置文件
管理员体验
- 可点击的聊天警报,附带操作按钮:
[TP] [VL] [DBG] [RPT]
- 威胁评分系统 — 综合所有检查的 0–100% 风险评估
- 可视化威胁报告,通过
/vg report <player> 查看
- 在线管理员声音警报(可配置)
- Discord Webhook 集成,用于服务器外监控
- 游戏内 GUI,用于编辑阈值、切换检查项和调整处罚
架构
- 100% 服务端 — 无需客户端模组
- 嵌入式 PacketEvents 并已着色 — 零外部依赖
- 模块化检查系统 — 每项检查独立且完全可配置
- 内置性能分析器 (
/vg profile)
- 多版本支持 — Paper 1.20.x 至 1.21.x
检查项
战斗类
| 检查项 |
描述 |
| Aimbot (自瞄) |
检测与辅助瞄准一致的瞬间旋转、加速度尖峰、过度平滑曲线和精度模式 |
| TriggerBot (连点/自动攻击) |
在准星对齐后识别具有近零反应延迟的自动化攻击时机 |
| AutoTotem (自动图腾) |
在致命伤害窗口期间捕捉不切实际的副手图腾快速切换 |
| Reach (距离/超距) |
眼睛到实体盒子的距离验证,包含 Ping、冲刺和移动的宽容度 |
| Velocity (速度/抗击退) |
通过验证服务器发送的速度数据包后的位移来检测抗击退 |
| Criticals (暴击) |
通过伪造的位置数据包识别虚假暴击(异常的暴击率、地面标志振荡、微小的 Y 轴偏移) |
| AutoClicker (连点器) |
通过时序方差分析(标准差、CPS、变异系数)捕捉机械式的点击模式 |
| KillAura (杀戮光环) |
检测多目标攻击、角度不匹配、穿墙攻击和完美的冷却滥用 |
| Sprint (冲刺) |
识别围绕攻击的回跑、KeepSprint 和冲刺切换模式 |
| MaceSpoof (战锤伪饰) |
检测为伪造战锤 smash 伤害而欺骗的下落距离位置数据包(暴击-战锤漏洞) |
| MaceNoFall (无摔落+战锤) |
捕捉 NoFall + 战锤组合:玩家造成战锤下落加成伤害,但在落地时规避摔落伤害 |
| MaceSwap (战锤切换) |
识别在下落期间自动将武器切换为战锤的行为(属性切换 / 自动切换模式) |
| CrystalAura (水晶光环) |
检测自动化的水晶放置与破坏循环(超人级的水晶攻击/秒数、放置→破坏配对、快速破坏比率) |
| BowManipulation (弓操控) |
通过充能方差分析、射速和远距离异常命中率捕捉 BowSpam 和 BowAimbot |
| InventoryCleaner (库存清理) |
识别非人类的库存操作速度(自动图腾切换、偷窃箱子物品、战斗中的库存使用) |
| AutoWeapon (自动换武) |
检测围绕攻击的自动化武器切换(攻击前切换比率、A→B→A 切换回模式) |
| HitboxExpand (碰撞箱扩展) |
通过横向偏移分析和边缘命中跟踪捕捉扩展的实体碰撞箱 |
| AutoArmor (自动护甲) |
检测战斗中的自动化装备穿戴(快速的护甲点击、防破损耐久度切换) |
数据包类
| 检查项 |
描述 |
| Timer (定时器) |
通过数据包速率分析检测游戏速度操纵(突发、持续和平均速率监控) |
要求
- Java 21+
- Paper 1.20.x – 1.21.x(或分支:Purpur, Pufferfish 等)
- 无外部依赖 — PacketEvents 已嵌入
安装
- 下载
VectorGuard-x.y.z.jar
- 将其放入服务器的
plugins/ 文件夹中
- 启动或重启服务器
- 编辑
plugins/VectorGuard/config.yml 以自定义阈值
- 使用
/vg reload 应用更改而无需重启
命令
| 命令 |
描述 |
/vg reload |
重新加载配置 |
/vg debug <player|*> |
切换某位玩家(或所有玩家)的调试输出 |
/vg vl <player> |
查看违规等级 |
/vg report <player> |
生成可视化威胁报告 |
/vg gui |
打开游戏内配置编辑器 |
/vg profile [seconds] |
运行性能分析器 |
权限
| 权限 |
默认值 |
描述 |
vectorguard.admin |
op |
访问所有 /vg 命令和 GUI |
vectorguard.alert |
op |
接收带有操作按钮的游戏内作弊警报 |
vectorguard.debug.view |
op |
查看调试输出 |
vectorguard.report |
true |
允许使用 /vg report 生成威胁报告 |
配置
所有设置均位于 plugins/VectorGuard/config.yml。
检查配置
每个检查项包含:
enabled — 开启或关闭该检查
buffer-threshold — 缓冲区必须超过此值才会被标记
buffer-decay-per-tick — 缓冲区每 tick 减少的量
vl-per-breach — 每次标记增加的违规等级(VL)
vl-decay-per-tick — VL 每 tick 减少的量
thresholds.* — 特定于检查的调优值
惩罚阶段
punishments:
alert-vl: 2.5 # 向管理员发送警报
setback-vl: 6.0 # 将玩家传送回上一个安全位置
punish-vl: 12.0 # 执行惩罚命令
punish-command: "kick %player% Unfair combat behavior detected by VectorGuard."
Discord Webhooks
notifications:
discord:
enabled: true
webhook-url: "https://discord.com/api/webhooks/..."
min-vl: 5.0
cooldown-ms: 10000
管理员警报
notifications:
admin:
sound-enabled: true
clickable-actions: true
show-threat-score: true
GUI 配置编辑器
运行 /vg gui 打开交互式图形界面,您可以在其中:
- 开启或关闭各项检查
- 编辑缓冲区阈值和 VL 值
- 调整惩罚阈值和冷却时间
- 保存更改并重新加载配置
常见问题
问:这需要玩家安装任何东西吗?
答:不需要。VectorGuard 完全在服务器端运行。
问:PacketEvents 需要作为单独的插件安装吗?
答:不需要。PacketEvents 已嵌入在 VectorGuard 的 jar 包中。
问:它兼容 Purpur/Pufferfish/其他 Paper 分支吗?
答:是的,任何 Paper 分支都应该可以工作。
问:它会与其他反作弊冲突吗?
答:VectorGuard 仅专注于战斗检测。它可以与专注于移动的反作弊共存,但运行两个战斗型反作弊可能会导致重复标记。
问:如何减少误报?
答:增加正在错误标记的检查项的 buffer-threshold 和 ping-cutoff-ms 值。默认值经过保守调优。
致谢
由 Mr. Dev 创建
许可协议
版权所有 (c) 2025 NeonDev。保留所有权利。
本软件及其源代码均为 NeonDev 的独家财产。
未经版权所有者事先书面许可,不得出于任何目的使用、复制、修改、合并、发布、分发、再许可、出售或以其他方式利用本软件的任何部分,包括但不限于源代码、编译后的二进制文件、文档、配置文件或任何相关资产。
未经授权而使用、复制或分发本软件或其任何部分均属严格禁止,并可能导致民事和刑事处罚。
本软件按“原样”提供,不提供任何形式的明示或暗示保证,包括但不限于对适销性、特定用途适用性和非侵权性的保证。在任何情况下,作者均不对因使用本软件或与本软件相关的任何其他事宜而引起的任何索赔、损害或其他责任负责,无论是基于合同、侵权行为还是其他原因。
VectorGuard
Production-grade combat anti-cheat for Paper servers.
VectorGuard is a 100% server-side anti-cheat plugin focused exclusively on combat detection. It uses packet-level analysis, tick-based telemetry, and multi-signal detection to identify cheaters with high accuracy and minimal false positives.
Built from the ground up for modern Paper servers (1.20.x–1.21.x) with Java 21.
Product Overview
VectorGuard is a combat-only anti-cheat designed to catch the most common PvP exploits while staying light on performance and fair on legitimate players. Every check uses multiple independent signals (rotation, timing, movement, cooldown usage, and hit validation) and applies buffered violations with decay, so one-off spikes do not punish normal players. Ping-aware thresholds and packet-timing compensation reduce false positives for high-latency players.
Administrators get a fast response workflow: clickable in-game alerts with action buttons, a threat score that aggregates risk across checks, and a visual report command for quick evidence review. A built-in GUI lets staff adjust thresholds, toggle checks, and tune punishments without editing files or restarting the server. Alerts can also be mirrored to Discord for off-server monitoring.
VectorGuard ships as a single jar with no external dependencies. PacketEvents is embedded, and the plugin runs entirely server-side with no client mod required.
Features
Detection Engine
- 19 combat checks targeting the most common cheat modules including Mace PvP exploits, crystal PvP automation, bow manipulation, and inventory exploits
- Multi-signal compound detection — each check combines multiple independent signals for high confidence
- Buffered violation system with configurable decay — prevents single-tick flukes from triggering punishments
- Latency compensation — all checks account for player ping to avoid false-flagging high-ping players
- Tick-based analytics with per-player position history and rotation profiling
Admin Experience
- Clickable chat alerts with action buttons:
[TP] [VL] [DBG] [RPT]
- Threat score system — composite 0–100% risk assessment across all checks
- Visual threat reports via
/vg report <player>
- Sound alerts for online admins (configurable)
- Discord webhook integration for off-server monitoring
- In-game GUI for editing thresholds, toggling checks, and tuning punishments
Architecture
- 100% server-side — no client mod required
- PacketEvents embedded and shaded — zero external dependencies
- Modular check system — each check is independent and fully configurable
- Performance profiler built-in (
/vg profile)
- Multi-version support — Paper 1.20.x through 1.21.x
Checks
Combat
| Check |
Description |
| Aimbot |
Detects snap rotations, acceleration spikes, over-smooth curves, and precision patterns consistent with aim assistance |
| TriggerBot |
Identifies automated attack timing with near-zero reaction delay after crosshair alignment |
| AutoTotem |
Catches unrealistically fast offhand totem swaps during lethal damage windows |
| Reach |
Eye-to-hitbox distance verification with ping, sprint, and movement leniency |
| Velocity |
Detects Anti-Knockback by verifying displacement after server-sent velocity packets |
| Criticals |
Identifies fake critical hits via spoofed position packets (abnormal crit rate, ground-flag oscillation, tiny Y offsets) |
| AutoClicker |
Catches robotic click patterns through timing variance analysis (stddev, CPS, coefficient of variation) |
| KillAura |
Detects multi-target attacks, angle mismatch, wall attacks, and perfect cooldown abuse |
| Sprint |
Identifies backwards sprinting, KeepSprint, and sprint-toggle patterns around attacks |
| MaceSpoof |
Detects spoofed fall-distance position packets for fake Mace smash damage (Criticals-Mace exploit) |
| MaceNoFall |
Catches NoFall + Mace combos: players deal Mace fall-bonus damage but evade fall damage on landing |
| MaceSwap |
Identifies automated weapon switching to Mace during falls (AttributeSwap / auto-swap patterns) |
| CrystalAura |
Detects automated crystal place-and-break cycles (superhuman crystal attacks/sec, place→break pairing, fast-break ratio) |
| BowManipulation |
Catches BowSpam and BowAimbot via charge variance analysis, fire rate, and abnormal hit rates at distance |
| InventoryCleaner |
Identifies inhuman inventory manipulation speed (AutoTotem swaps, chest stealing, combat inventory use) |
| AutoWeapon |
Detects automated weapon switching around attacks (pre-attack swap ratio, A→B→A swap-back patterns) |
| HitboxExpand |
Catches expanded entity hitboxes via lateral offset analysis and edge-hit rate tracking |
| AutoArmor |
Detects automated armor equipping during combat (rapid armor clicks, anti-break durability swaps) |
Packet
| Check |
Description |
| Timer |
Detects game speed manipulation via packet rate analysis (burst, sustained, and average rate monitoring) |
Requirements
- Java 21+
- Paper 1.20.x – 1.21.x (or forks: Purpur, Pufferfish, etc.)
- No external dependencies — PacketEvents is embedded
Installation
- Download
VectorGuard-x.y.z.jar
- Place it in your server's
plugins/ folder
- Start or restart the server
- Edit
plugins/VectorGuard/config.yml to customize thresholds
- Use
/vg reload to apply changes without restarting
Commands
| Command |
Description |
/vg reload |
Reload configuration |
/vg debug <player|*> |
Toggle debug output for a player (or all) |
/vg vl <player> |
View violation levels |
/vg report <player> |
Generate a visual threat report |
/vg gui |
Open the in-game config editor |
/vg profile [seconds] |
Run performance profiler |
Permissions
| Permission |
Default |
Description |
vectorguard.admin |
op |
Access to all /vg commands and GUI |
vectorguard.alert |
op |
Receive in-game cheat alerts with action buttons |
vectorguard.debug.view |
op |
View debug output |
vectorguard.report |
true |
Allows using /vg report to generate threat reports |
Configuration
All settings are in plugins/VectorGuard/config.yml.
Check Configuration
Each check has:
enabled — toggle the check on/off
buffer-threshold — buffer must exceed this to flag
buffer-decay-per-tick — buffer decreases each tick
vl-per-breach — violation level added per flag
vl-decay-per-tick — VL decreases each tick
thresholds.* — check-specific tuning values
Punishment Stages
punishments:
alert-vl: 2.5 # Send alert to admins
setback-vl: 6.0 # Teleport player to last safe position
punish-vl: 12.0 # Execute punishment command
punish-command: "kick %player% Unfair combat behavior detected by VectorGuard."
Discord Webhooks
notifications:
discord:
enabled: true
webhook-url: "https://discord.com/api/webhooks/..."
min-vl: 5.0
cooldown-ms: 10000
Admin Alerts
notifications:
admin:
sound-enabled: true
clickable-actions: true
show-threat-score: true
GUI Config Editor
Run /vg gui to open an interactive GUI where you can:
- Toggle checks on/off
- Edit buffer thresholds and VL values
- Adjust punishment thresholds and cooldowns
- Save changes to config and reload
FAQ
Q: Does this require players to install anything?
A: No. VectorGuard is 100% server-side.
Q: Is PacketEvents required as a separate plugin?
A: No. PacketEvents is embedded inside the VectorGuard jar.
Q: Does it work with Purpur/Pufferfish/other Paper forks?
A: Yes, any Paper fork should work.
Q: Will it conflict with other anti-cheats?
A: VectorGuard focuses only on combat. It can coexist with movement-focused anti-cheats, but running two combat anti-cheats may cause duplicate flagging.
Q: How do I reduce false positives?
A: Increase the buffer-threshold and ping-cutoff-ms values for checks that are flagging incorrectly. The defaults are tuned conservatively.
Credits
Created by Mr. Dev
License
Copyright (c) 2025 NeonDev. All Rights Reserved.
This software and its source code are the exclusive property of NeonDev.
No part of this software, including but not limited to the source code, compiled
binaries, documentation, configuration files, or any associated assets, may be
used, copied, modified, merged, published, distributed, sublicensed, sold, or
otherwise exploited for any purpose without the prior written permission of the
copyright holder.
Unauthorized use, reproduction, or distribution of this software, or any portion
of it, is strictly prohibited and may result in civil and criminal penalties.
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
AUTHOR BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE
SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
评论 0
登录后参与评分
还没有评论,来抢沙发吧