反作弊

🪴 本插件专为 KWEEBEC 世界服务器开发 🪴
IP: world.kweebec.xyz

---

一款面向 Hytale 的服务端反作弊插件，侧重于通过**数据包分析**实现**作弊防护**。此外还包含一个**身份保护**模块，用于控制安全/非安全连接及昵称冲突。

---

核心功能

移动检测

• 速度检测 基于连续 tick 之间的位置变化量，结合容差与违规累积，检测异常水平速度。
• 飞行检测 通过分析滞空时间和垂直行为，检测非法悬浮/飞行。
• 穿墙检测 检测玩家是否处于相对于世界碰撞的无效位置（穿墙/位于方块内部）。在区块/实例加载期间会抑制检测以避免误判。

智能执行

• 违规等级 (VL) 违规不会基于“单次事件”进行惩罚——系统会累积违规等级并随时间递减（衰减），从而最大限度减少误判。
• 回退 将玩家传送回其上一个有效位置，而非直接踢出（取决于设置）。
• 踢出 当违规等级达到指定阈值时踢出玩家。

传送门 / 实例安全

• 传送/切换场景后的宽限期，以及世界/区块初始化与切换期间的惩罚抑制。

身份保护

• 可选的强制安全认证要求。
• 重复昵称拦截（一个昵称——一名在线玩家）。
• 非安全连接绑定白名单：用户名=UUID。

---

配置

以下是各字段的说明（在速度/飞行/穿墙章节中会重复出现，但含义相同）。

通用

• enabled 启用/禁用整个插件。

警报

enabled 启用检测/惩罚通知。

prefix 消息前缀（例如 [反作弊]）。

minIntervalMillis 防刷屏：通知的最小间隔时间（毫秒）。

sendToSuspect 是否向被怀疑的玩家发送通知。

logToConsole 是否在控制台重复输出通知。

身份

enabled 启用身份模块检查。

requireSecureAuth 如果为 true，将拒绝非安全连接。

preventDuplicateUsernames 如果为 true，则禁止第二个同名玩家加入（防止冒充和冲突）。

allowInsecureAuthWithAnyUuid 如果为 true，则允许“使用任意 UUID”的非安全连接（安全性较低）。

allowedInsecureBindings 以 CSV 字符串格式允许的非安全连接绑定，格式为：用户名=UUID,用户名2=UUID2

kickReason 身份检查被拒绝/失败时的踢出原因。

duplicateUsernameKickReason 昵称冲突时的踢出原因。

---

检测设置（速度/飞行/穿墙的通用字段）

每项检测都有其自己的配置节（例如 speed、fly、noClip），并支持以下参数集：

enabled 启用/禁用该检测项。

vlDecayPerSecond VL 每秒的“衰减”速率：数值越高，玩家停止违规后“清理”积分的速度越快。

setbackVl 允许应用**回退**（重置）的 VL 阈值。

kickVl 允许进行**踢出**的 VL 阈值。

maxSetbacks 此项检测允许的最大回退次数。

0 = 无限制（回退可无限重复，但踢出仍取决于 kickVl）。

setbackCooldownTicks 回退之间的最小间隔（以 tick 为单位），以避免每帧都“传送”玩家。

graceTicksAfterTeleport 传送/通过传送门后，抑制此项检测（及其惩罚）的 tick 数。

graceTicksAfterVelocity 服务端施加移动冲量/速度后，抑制检测的 tick 数（以避免误判合法的“踢出”或弹射）。

kickReason 此项检测的特定踢出原因文本。

附加字段（并非所有检测均具备）

仅速度检测

maxMultiplier 预期速度的通用容差倍数。

extraSpeed 额外的“缓冲值”（对允许速度的绝对增量）。

vlScale 违规贡献给 VL 的缩放比例（使系统更敏感或更不敏感）。

仅飞行检测

maxAirTicks 触发怀疑前允许的最大“空中停留时间”。

maxUpSpeed 可疑向上垂直速度的阈值。

仅穿墙检测

validateEveryTicks 繁重位置有效性检查的频率：

• 1 = 每 tick 一次
• 2 = 每两个 tick 一次
• 5 = 每五个 tick 一次
  数值越高，负载越低，但反应时间会变慢。

---

权限

支持绕过权限：

• 完全绕过所有检测。
• 选择性绕过速度/飞行/穿墙检测。
  （具体权限节点字符串在权限配置中定义）。

---

未来开发

计划扩展检测功能：

• 透视（X-Ray）
• 战斗作弊（杀戮光环、攻击距离、自动瞄准）
• 物品栏/复制
• 网络/时间滥用