战斗检测模块详细文档

📋 目录

• 模块概述
• KillAura (自动攻击检测)
• Aimbot (自动瞄准检测)
• Criticals (暴击检测)
• Reach (攻击距离检测)
• Velocity (击退修改检测)
• HitBox (击中判定检测)
• AutoClicker (自动点击检测)
• BlockHit (格挡检测)
• FastBow (快速拉弓检测)
• FastProjectile (快速投射物检测)
• 配置示例
• 常见问题

🔍 模块概述

战斗检测模块负责监控和识别各种与战斗相关的作弊行为，包括自动攻击、自动瞄准、修改攻击距离、自动暴击等。该模块通过分析玩家的攻击模式、点击频率、瞄准精度、伤害输出等数据，来检测各种战斗作弊。

所有战斗检测模块的配置都位于plugins/光谱Spectrum/checks.yml文件中的combat部分。

⚔️ KillAura (自动攻击检测)

功能描述

检测玩家是否使用自动攻击作弊，能够自动锁定并攻击周围的实体，无需手动操作。

检测原理

• 分析玩家的攻击目标切换频率
• 监测玩家的视角变化与攻击行为的关系
• 比较预期的攻击延迟与实际的攻击延迟
• 检测异常的攻击角度和攻击距离
• 分析玩家在攻击时的移动和操作模式

配置参数详解

combat:
  killaura:
    # 是否启用自动攻击检测
    enabled: true
    
    # 检测阈值（0-1之间）
    threshold: 0.7
    
    # 违规积累速度
    violation-rate: 1.0
    
    # 最大违规次数
    max-violations: 15
    
    # 重置违规计数的时间间隔（秒）
    violation-reset-time: 300
    
    # 允许的最大攻击速度（攻击/秒）
    max-attack-rate: 10.0
    
    # 允许的最大目标切换频率（切换/秒）
    max-target-switch-rate: 3.0
    
    # 考虑剑的攻击冷却
    consider-cooldown: true
    
    # 考虑攻击范围
    consider-reach: true
    
    # 考虑玩家的移动状态
    consider-movement: true
    
    # 允许的最大视角变化率（度/毫秒）
    max-angle-change-rate: 5.0
    
    # 自动攻击检测的惩罚类型
    punishment: kick
    
    # 异步检测开关
    async: true
    
    # 调试模式开关
    debug: false
    
    # 玩家权限绕过检测
    bypass-permission: 鍏夎氨Spectrum.bypass.killaura

惩罚设置

自动攻击检测支持的惩罚类型：

• warning：发送警告消息
• kick：踢出玩家
• tempban：临时封禁
• ban：永久封禁

常见误报原因及解决方案

误报原因	解决方案
高服务器延迟	增加threshold值，或启用latency-compensation
鼠标宏	调整max-attack-rate值，或启用click-pattern-analysis
连击插件	在compatibility.yml中添加兼容设置

🎯 Aimbot (自动瞄准检测)

功能描述

检测玩家是否使用自动瞄准作弊，能够自动将视角对准目标实体的关键部位。

检测原理

• 分析玩家视角变化的平滑度和精度
• 监测玩家视角与目标位置的关系
• 比较预期的视角调整与实际的视角调整
• 检测异常的头部跟踪行为
• 分析目标移动与玩家视角调整的同步性

配置参数详解

combat:
  aimbot:
    # 是否启用自动瞄准检测
    enabled: true
    
    # 检测阈值（0-1之间）
    threshold: 0.7
    
    # 违规积累速度
    violation-rate: 1.0
    
    # 最大违规次数
    max-violations: 15
    
    # 重置违规计数的时间间隔（秒）
    violation-reset-time: 300
    
    # 允许的最大瞄准精度（度）
    max-aim-precision: 0.5
    
    # 允许的最大视角调整速度（度/毫秒）
    max-angle-speed: 4.0
    
    # 考虑目标距离
    consider-distance: true
    
    # 考虑目标移动速度
    consider-target-speed: true
    
    # 考虑玩家的网络延迟
    consider-latency: true
    
    # 头部跟踪检测的严格程度
    head-tracking-strictness: 0.8
    
    # 自动瞄准检测的惩罚类型
    punishment: kick
    
    # 异步检测开关
    async: true
    
    # 调试模式开关
    debug: false
    
    # 玩家权限绕过检测
    bypass-permission: 鍏夎氨Spectrum.bypass.aimbot

惩罚设置

自动瞄准检测支持的惩罚类型：

• warning：发送警告消息
• kick：踢出玩家
• tempban：临时封禁
• ban：永久封禁

常见误报原因及解决方案

误报原因	解决方案
高服务器延迟	增加threshold值，或启用latency-compensation
良好的瞄准技巧	调整head-tracking-strictness值
视角平滑插件	在compatibility.yml中添加兼容设置

⚡ Criticals (暴击检测)

功能描述

检测玩家是否使用自动暴击作弊，能够在不满足暴击条件的情况下进行暴击攻击。

检测原理

• 分析玩家的跳跃状态与攻击行为的关系
• 监测玩家的垂直位置变化与攻击时机
• 比较预期的暴击频率与实际的暴击频率
• 检测异常的伤害输出模式
• 分析玩家的重力影响和碰撞数据

配置参数详解

combat:
  criticals:
    # 是否启用暴击检测
    enabled: true
    
    # 检测阈值（0-1之间）
    threshold: 0.6
    
    # 违规积累速度
    violation-rate: 1.0
    
    # 最大违规次数
    max-violations: 10
    
    # 重置违规计数的时间间隔（秒）
    violation-reset-time: 300
    
    # 允许的最大暴击频率（百分比）
    max-critical-rate: 80
    
    # 跳跃检测的垂直位移阈值（方块）
    jump-threshold: 0.3
    
    # 跳跃检测的时间阈值（毫秒）
    jump-time-threshold: 100
    
    # 考虑落地暴击
    consider-landing-critical: true
    
    # 暴击检测的惩罚类型
    punishment: warning
    
    # 异步检测开关
    async: false
    
    # 调试模式开关
    debug: false
    
    # 玩家权限绕过检测
    bypass-permission: 鍏夎氨Spectrum.bypass.criticals

惩罚设置

暴击检测支持的惩罚类型：

• warning：发送警告消息
• kick：踢出玩家
• tempban：临时封禁

📏 Reach (攻击距离检测)

功能描述

检测玩家是否使用攻击距离作弊，能够攻击超出正常攻击范围的目标。

检测原理

• 计算玩家与目标之间的实际距离
• 比较攻击距离与预期的最大攻击范围
• 监测攻击行为与玩家-目标距离的关系
• 检测异常的点击注册位置
• 分析玩家的碰撞检测数据

配置参数详解

combat:
  reach:
    # 是否启用攻击距离检测
    enabled: true
    
    # 检测阈值（0-1之间）
    threshold: 0.7
    
    # 违规积累速度
    violation-rate: 1.0
    
    # 最大违规次数
    max-violations: 15
    
    # 重置违规计数的时间间隔（秒）
    violation-reset-time: 300
    
    # 基础攻击距离（方块）
    base-reach: 3.0
    
    # 允许的距离偏差（方块）
    max-reach-deviation: 0.4
    
    # 考虑网络延迟
    consider-latency: true
    
    # 考虑武器类型
    consider-weapon: true
    
    # 考虑攻击角度
    consider-angle: true
    
    # 攻击距离检测的惩罚类型
    punishment: kick
    
    # 异步检测开关
    async: false
    
    # 调试模式开关
    debug: false
    
    # 玩家权限绕过检测
    bypass-permission: 鍏夎氨Spectrum.bypass.reach

惩罚设置

攻击距离检测支持的惩罚类型：

• warning：发送警告消息
• kick：踢出玩家
• tempban：临时封禁
• ban：永久封禁

常见误报原因及解决方案

误报原因	解决方案
高服务器延迟	增加max-reach-deviation值，或启用latency-compensation
特殊武器（如三叉戟投掷）	在compatibility.yml中添加兼容设置
客户端-服务器位置不同步	调整consider-latency和threshold参数

🌊 Velocity (击退修改检测)

功能描述

检测玩家是否修改了自己受到攻击时的击退效果，包括减少、增加或完全消除击退。

检测原理

• 计算玩家受到攻击后的预期击退距离
• 监测玩家受到击退时的移动轨迹
• 比较实际的击退距离与预期距离
• 分析玩家在被击退时的异常操作
• 检测异常的碰撞响应

配置参数详解

combat:
  velocity:
    # 是否启用击退修改检测
    enabled: true
    
    # 检测阈值（0-1之间）
    threshold: 0.7
    
    # 违规积累速度
    violation-rate: 1.0
    
    # 最大违规次数
    max-violations: 15
    
    # 重置违规计数的时间间隔（秒）
    violation-reset-time: 300
    
    # 允许的击退距离偏差（百分比）
    max-velocity-deviation: 30
    
    # 考虑防护装备
    consider-protection: true
    
    # 考虑玩家状态（如跳跃、飞行等）
    consider-player-state: true
    
    # 击退修改检测的惩罚类型
    punishment: warning
    
    # 异步检测开关
    async: false
    
    # 调试模式开关
    debug: false
    
    # 玩家权限绕过检测
    bypass-permission: 鍏夎氨Spectrum.bypass.velocity

惩罚设置

击退修改检测支持的惩罚类型：

• warning：发送警告消息
• kick：踢出玩家
• tempban：临时封禁

📐 HitBox (击中判定检测)

功能描述

检测玩家是否修改了目标实体的击中判定区域，使攻击更容易命中目标。

检测原理

• 分析玩家的攻击位置与目标实体碰撞箱的关系
• 监测异常的命中率和攻击位置分布
• 比较预期的命中率与实际的命中率
• 检测异常的攻击注册点
• 分析攻击角度和攻击距离的关系

配置参数详解

combat:
  hitbox:
    # 是否启用击中判定检测
    enabled: true
    
    # 检测阈值（0-1之间）
    threshold: 0.7
    
    # 违规积累速度
    violation-rate: 1.0
    
    # 最大违规次数
    max-violations: 15
    
    # 重置违规计数的时间间隔（秒）
    violation-reset-time: 300
    
    # 允许的最大击中偏差（方块）
    max-hit-deviation: 0.3
    
    # 考虑网络延迟
    consider-latency: true
    
    # 考虑目标移动速度
    consider-target-speed: true
    
    # 考虑攻击角度
    consider-angle: true
    
    # 击中判定检测的惩罚类型
    punishment: warning
    
    # 异步检测开关
    async: false
    
    # 调试模式开关
    debug: false
    
    # 玩家权限绕过检测
    bypass-permission: 鍏夎氨Spectrum.bypass.hitbox

惩罚设置

击中判定检测支持的惩罚类型：

• warning：发送警告消息
• kick：踢出玩家
• tempban：临时封禁

🖱️ AutoClicker (自动点击检测)

功能描述

检测玩家是否使用自动点击作弊，能够以超出人类反应速度的频率进行点击。

检测原理

• 分析玩家的点击频率和模式
• 监测点击之间的时间间隔和变化
• 比较预期的点击速度与实际的点击速度
• 检测异常的点击规律性和一致性
• 分析点击行为与游戏内事件的关系

配置参数详解

combat:
  autoclicker:
    # 是否启用自动点击检测
    enabled: true
    
    # 检测阈值（0-1之间）
    threshold: 0.7
    
    # 违规积累速度
    violation-rate: 1.0
    
    # 最大违规次数
    max-violations: 15
    
    # 重置违规计数的时间间隔（秒）
    violation-reset-time: 300
    
    # 允许的最大点击速度（点击/秒）
    max-click-rate: 15.0
    
    # 最小点击间隔标准差（毫秒）
    min-click-interval-std: 5.0
    
    # 启用点击模式分析
    click-pattern-analysis: true
    
    # 考虑武器冷却
    consider-cooldown: true
    
    # 自动点击检测的惩罚类型
    punishment: warning
    
    # 异步检测开关
    async: true
    
    # 调试模式开关
    debug: false
    
    # 玩家权限绕过检测
    bypass-permission: 鍏夎氨Spectrum.bypass.autoclicker

惩罚设置

自动点击检测支持的惩罚类型：

• warning：发送警告消息
• kick：踢出玩家
• tempban：临时封禁

常见误报原因及解决方案

误报原因	解决方案
高性能鼠标	增加max-click-rate值
玩家快速点击技巧	调整min-click-interval-std值
点击辅助设备	在compatibility.yml中添加兼容设置

🛡️ BlockHit (格挡检测)

功能描述

检测玩家是否使用快速格挡作弊，能够在攻击后立即切换到格挡状态，减少受到的伤害。

检测原理

• 分析玩家的攻击与格挡动作之间的时间间隔
• 监测异常的武器切换速度
• 比较预期的动作延迟与实际的动作延迟
• 检测异常的防御行为模式
• 分析玩家的物品栏操作和攻击行为

配置参数详解

combat:
  blockhit:
    # 是否启用格挡检测
    enabled: true
    
    # 检测阈值（0-1之间）
    threshold: 0.6
    
    # 违规积累速度
    violation-rate: 1.0
    
    # 最大违规次数
    max-violations: 10
    
    # 重置违规计数的时间间隔（秒）
    violation-reset-time: 300
    
    # 允许的最小攻击-格挡时间间隔（毫秒）
    min-attack-block-delay: 100
    
    # 允许的最小格挡-攻击时间间隔（毫秒）
    min-block-attack-delay: 100
    
    # 格挡检测的惩罚类型
    punishment: warning
    
    # 异步检测开关
    async: false
    
    # 调试模式开关
    debug: false
    
    # 玩家权限绕过检测
    bypass-permission: 鍏夎氨Spectrum.bypass.blockhit

惩罚设置

格挡检测支持的惩罚类型：

• warning：发送警告消息
• kick：踢出玩家

🏹 FastBow (快速拉弓检测)

功能描述

检测玩家是否使用快速拉弓作弊，能够比正常速度更快地拉弓并射出箭矢。

检测原理

• 分析玩家拉弓和射箭之间的时间间隔
• 监测异常的箭矢发射速度
• 比较预期的拉弓时间与实际的拉弓时间
• 检测异常的弓弦状态变化
• 分析玩家的物品使用行为

配置参数详解

combat:
  fastbow:
    # 是否启用快速拉弓检测
    enabled: true
    
    # 检测阈值（0-1之间）
    threshold: 0.6
    
    # 违规积累速度
    violation-rate: 1.0
    
    # 最大违规次数
    max-violations: 10
    
    # 重置违规计数的时间间隔（秒）
    violation-reset-time: 300
    
    # 允许的最小拉弓时间（毫秒）
    min-bow-pull-time: 200
    
    # 快速拉弓检测的惩罚类型
    punishment: warning
    
    # 异步检测开关
    async: false
    
    # 调试模式开关
    debug: false
    
    # 玩家权限绕过检测
    bypass-permission: 鍏夎氨Spectrum.bypass.fastbow

惩罚设置

快速拉弓检测支持的惩罚类型：

• warning：发送警告消息
• kick：踢出玩家

🚀 FastProjectile (快速投射物检测)

功能描述

检测玩家是否使用快速投射物作弊，能够以异常高的速度发射投射物（如雪球、鸡蛋、末影珍珠等）。

检测原理

• 分析投射物的发射速度和轨迹
• 监测异常的投射物飞行速度
• 比较预期的投射物行为与实际的投射物行为
• 检测异常的投射物伤害输出
• 分析玩家的物品使用频率

配置参数详解

combat:
  fastprojectile:
    # 是否启用快速投射物检测
    enabled: true
    
    # 检测阈值（0-1之间）
    threshold: 0.6
    
    # 违规积累速度
    violation-rate: 1.0
    
    # 最大违规次数
    max-violations: 10
    
    # 重置违规计数的时间间隔（秒）
    violation-reset-time: 300
    
    # 允许的最大投射物发射速度（投射物/秒）
    max-projectile-rate: 5.0
    
    # 允许的最大投射物速度加成（百分比）
    max-projectile-speed-bonus: 20
    
    # 快速投射物检测的惩罚类型
    punishment: warning
    
    # 异步检测开关
    async: false
    
    # 调试模式开关
    debug: false
    
    # 玩家权限绕过检测
    bypass-permission: 鍏夎氨Spectrum.bypass.fastprojectile

惩罚设置

快速投射物检测支持的惩罚类型：

• warning：发送警告消息
• kick：踢出玩家

📝 配置示例

以下是战斗检测模块的推荐配置示例：

combat:
  # 自动攻击检测
  killaura:
    enabled: true
    threshold: 0.7
    max-attack-rate: 10.0
    punishment: kick
    
  # 自动瞄准检测
  aimbot:
    enabled: true
    threshold: 0.7
    max-angle-speed: 4.0
    punishment: kick
    
  # 暴击检测
  criticals:
    enabled: true
    threshold: 0.6
    max-critical-rate: 80
    punishment: warning
    
  # 攻击距离检测
  reach:
    enabled: true
    threshold: 0.7
    base-reach: 3.0
    max-reach-deviation: 0.4
    punishment: kick
    
  # 击退修改检测
  velocity:
    enabled: true
    threshold: 0.7
    max-velocity-deviation: 30
    punishment: warning
    
  # 击中判定检测
  hitbox:
    enabled: true
    threshold: 0.7
    max-hit-deviation: 0.3
    punishment: warning
    
  # 自动点击检测
  autoclicker:
    enabled: true
    threshold: 0.7
    max-click-rate: 15.0
    click-pattern-analysis: true
    punishment: warning
    
  # 格挡检测
  blockhit:
    enabled: true
    threshold: 0.6
    min-attack-block-delay: 100
    punishment: warning
    
  # 快速拉弓检测
  fastbow:
    enabled: true
    threshold: 0.6
    min-bow-pull-time: 200
    punishment: warning
    
  # 快速投射物检测
  fastprojectile:
    enabled: true
    threshold: 0.6
    max-projectile-rate: 5.0
    punishment: warning

❓ 常见问题

如何减少战斗检测的误报？

1. 调整检测阈值：增加threshold值可以降低检测的严格程度
2. 考虑服务器延迟：在config.yml中启用latency-compensation并设置合适的值
3. 为PvP高手设置白名单：使用/鍏夎氨Spectrum whitelist add <player>命令
4. 配置兼容模式：在compatibility.yml中添加与其他插件的兼容设置
5. 对于高点击速度的合法玩家，调整max-click-rate值

如何优化战斗检测的性能？

1. 对于性能较低的服务器，可以禁用一些非核心的战斗检测模块
2. 调整检测频率：在config.yml中增加check-interval值
3. 启用异步检测：对于计算密集型的检测模块，将async设置为true
4. 降低点击分析的精度：在不影响检测效果的前提下，适当降低点击分析的采样率

---

最后更新时间：2025年10月2日