VanillaGuard
一款轻量级、尊重原版行为的 Paper 1.21.x 反作弊插件。在不误判你朋友的情况下捕捉作弊者。
大多数反作弊要么过于激进(因冲刺跳跃或在冰上行走而封禁玩家),要么配置过于复杂。VanillaGuard 采取了不同的方法:它知道原版 Minecraft 中实际可能发生的情况,仅标记那些物理上不可能发生的行为。
✨ 特性
? 速度检测 — 状态感知,考虑速度药水、灵魂疾行、冰面、游泳等因素
? 飞行检测 — 捕捉悬停和非自然上升,同时不误判合法坠落
⚔️ 距离检测 — 标记超出原版 3 格攻击范围的行为(带有延迟缓冲)
⛵ 船飞检测 — 修复了大多数反作弊忽略的利用船飞行的漏洞
? 违规缓冲系统 — 持续的作弊行为会积累证据;短暂的延迟波动不会导致误判
? 自动封禁 — 达到阈值后自动进行临时封禁(默认:5 次违规 = 1 天封禁)
? 实时工作人员警报 — 在聊天中查看正在发生的违规行为
? 为什么选择 VanillaGuard?
对正常游戏行为零误报。
VanillaGuard 知道以下情况是合法的:
冲刺跳跃因动量冲击短暂达到 ~8.5 bps
速度 II + 冲刺跳跃达到 ~10.5 bps
灵魂疾行 III + 速度 II 在灵魂沙上达到 ~12.7 bps
蓝冰上的船只可以达到 70+ bps
激流三叉戟会产生巨大的速度爆发
击退、传送和鞘翅都会打破正常的移动规则
所有这些情况都会自动豁免。你的朋友可以在不因为游戏本身的机制而被封禁的情况下正常游玩。
?️ 检查详情
速度
每秒计算玩家当前状态下的最大合法速度(药水、脚下方块、游泳、冰面等),并带有 30% 的延迟缓冲。使用随时间衰减的违规缓冲——持续作弊比衰减积累得更快,但短暂的网络波动不会误触发。
飞行
追踪空中的 Y 轴累积。仅标记悬停和上升模式——任何速度的坠落都不会被评估,消除了由数据包抖动导致的误报。通过随时间积累证据,甚至能捕捉到缓慢的悬浮作弊(0.04 dy/tick)。
豁免:鞘翅、激流、悬浮、慢落、水、梯子、藤蔓、脚手架、蛛网、粉雪、气泡柱、载具、击退、传送、新加入服务器。
距离
测量攻击者眼睛到受害者碰撞盒最近点的距离(与原版使用的算法相同)。原版生存模式为 3.0 格;VanillaGuard 在 >4.0 格时进行标记,以允许约 150ms 的延迟。
船飞
检测在物理上必须下落时却未下落的船只。追踪船只无支撑(下方无水/冰/睡莲/实心方块)的连续 tick 数;在出现 5 次此类 tick 且垂直运动 >-0.12 时进行标记。
⚙️ 配置
plugins/VanillaGuard/config.yml:
yamlflag-threshold: 5 # 临时封禁前的标记次数
ban-days: 1 # 封禁时长
? 权限
PermissionDefaultDescriptionvanillaguard.bypassop完全豁免所有检查vanillaguard.alertsop接收游戏内违规警报
服务器操作员、创造/旁观模式玩家以及拥有 vanillaguard.bypass 权限的玩家会自动完全豁免。
? 要求
Paper 1.21.x(其他分支如 Purpur/Pufferfish 也应该可以工作)
Java 21+
? 安装
下载 VanillaGuard-1.0.0.jar
将其放入服务器的 plugins/ 文件夹
重启服务器
完成 —— 在控制台中检查是否显示 VanillaGuard v1 enabled。
⚠️ 适用范围
VanillaGuard 是一款面向中小型服务器的轻量级反作弊。它专注于常见的作弊行为(飞行、加速、距离、船飞),并对正常的原版游戏行为零误报。它不包含以下内容:
KillAura / 命中检测
NoFall / NoSlow
数据包级别分析
Phase / NoClip 检测
自动点击器检测
对于运行竞争性 PvP 的大型服务器,建议考虑 Vulcan、Grim 或 Matrix。而对于小型 SMP 和朋友服务器,如果你只想阻止明显的作弊者而不破坏游戏体验——这正是 VanillaGuard 大放异彩的地方。
? 反馈
发现 Bug?遇到误报?留下评论或提交 Issue。该插件会根据实际测试结果积极改进。
VanillaGuard
A lightweight, vanilla-respecting anti-cheat for Paper 1.21.x. Catches cheaters without false-flagging your friends.
Most anti-cheats are either too aggressive (banning players for sprint-jumping or playing on ice) or too complex to configure. VanillaGuard takes a different approach: it knows what's actually possible in vanilla Minecraft and only flags what physically isn't.
✨ Features
? Speed detection — state-aware, accounts for Speed potions, Soul Speed, ice, swimming, and more
? Fly detection — catches hovering and unnatural ascending without flagging legit falls
⚔️ Reach detection — flags attacks beyond vanilla's 3-block range (with latency buffer)
⛵ BoatFly detection — closes the boat-flying bypass that most anti-cheats miss
? Violation buffer system — sustained cheating accumulates evidence; brief lag spikes don't false-flag
? Auto-ban — configurable temp ban after threshold reached (default: 5 flags = 1-day ban)
? Live staff alerts — see violations in chat as they happen
? Why VanillaGuard?
No false positives on legitimate play.
VanillaGuard knows that:
Sprint-jumping briefly hits ~8.5 bps from momentum impulses
Speed II + sprint-jumping reaches ~10.5 bps
Soul Speed III + Speed II on soul sand hits ~12.7 bps
Boats on blue ice can reach 70+ bps
Riptide tridents create huge velocity bursts
Knockback, teleports, and elytra all break normal movement rules
All of this is exempt automatically. Your friends can play without getting banned for the game's actual mechanics.
?️ Checks in detail
Speed
Calculates the maximum legitimate speed for the player's current state every tick (potions, blocks underfoot, swimming, ice, etc.) with a 30% latency buffer. Uses a violation buffer that decays over time — sustained cheating accumulates faster than it can decay, but brief network spikes don't false-trigger.
Fly
Tracks airborne Y-accumulation. Only flags hovering and ascending patterns — falls of any speed are never evaluated, eliminating false positives from packet jitter. Catches even slow levitation cheats (0.04 dy/tick) by accumulating evidence over time.
Exemptions: elytra, riptide, levitation, slow-falling, water, ladders, vines, scaffolding, cobweb, powder snow, bubble columns, vehicles, knockback, teleports, recent join.
Reach
Measures distance from attacker eye to nearest point on victim's hitbox (same math vanilla uses). Vanilla survival is 3.0 blocks; VanillaGuard flags at >4.0 to allow ~150ms latency.
BoatFly
Detects boats that aren't falling when they physically must. Tracks consecutive ticks where the boat is unsupported (no water/ice/lily pad/solid block beneath); flags after 5 such ticks with vertical motion >-0.12.
⚙️ Configuration
plugins/VanillaGuard/config.yml:
yamlflag-threshold: 5 # flags before temp ban
ban-days: 1 # ban duration
? Permissions
PermissionDefaultDescriptionvanillaguard.bypassopFully exempt from all checksvanillaguard.alertsopReceive in-game violation alerts
Server operators, creative/spectator players, and anyone with vanillaguard.bypass are fully exempt automatically.
? Requirements
Paper 1.21.x (other forks like Purpur/Pufferfish should work too)
Java 21+
? Installation
Download VanillaGuard-1.0.0.jar
Drop it in your server's plugins/ folder
Restart your server
Done — check console for VanillaGuard v1 enabled.
⚠️ Scope
VanillaGuard is a lightweight anti-cheat for small to medium servers. It focuses on common cheats (fly, speed, reach, boatfly) with zero false positives on legitimate vanilla play. It does not include:
KillAura / hit detection
NoFall / NoSlow
Packet-level analysis
Phase / NoClip detection
Auto-clicker detection
For larger servers running competitive PvP, consider Vulcan, Grim, or Matrix. For smaller SMPs and friend servers where you just want to stop the obvious cheaters without breaking gameplay — that's where VanillaGuard shines.
? Feedback
Found a bug? Got a false positive? Drop a comment or open an issue. The plugin is actively improved based on real-world testing.
评论 0
登录后参与评分
还没有评论,来抢沙发吧