自动化检测模块详细文档

📋 目录

模块概述
AutoFish (自动钓鱼检测)
AutoTool (自动工具检测)
AutoArmor (自动盔甲检测)
AutoClicker (自动点击检测)
AutoFarm (自动农场检测)
AutoWalk (自动行走检测)
AutoSoup (自动喝汤检测)
配置示例
常见问题

🔍 模块概述

自动化检测模块负责监控和识别各种自动化作弊行为，这些行为通过脚本或宏来自动执行游戏内的各种操作，无需玩家手动干预。该模块通过分析玩家的操作模式、点击频率、反应时间等数据，来检测各种自动化作弊。

所有自动化检测模块的配置都位于plugins/鍏夎氨Spectrum/checks.yml文件中的automation部分。

🎣 AutoFish (自动钓鱼检测)

功能描述

检测玩家是否使用自动钓鱼作弊，能够自动抛竿、收竿，无需手动操作。

检测原理

分析钓鱼操作的时间间隔和规律性
监测钓鱼浮标的状态变化与收竿行为的关系
比较预期的钓鱼反应时间与实际反应时间
检测异常的钓鱼成功率
分析钓鱼行为与游戏内事件的同步性

配置参数详解

yaml

automation:
  autofish:
    # 是否启用自动钓鱼检测
    enabled: true
    
    # 检测阈值（0-1之间）
    threshold: 0.6
    
    # 违规积累速度
    violation-rate: 1.0
    
    # 最大违规次数
    max-violations: 15
    
    # 重置违规计数的时间间隔（秒）
    violation-reset-time: 300
    
    # 最小预期反应时间（毫秒）
    min-reaction-time: 100
    
    # 最大预期反应时间（毫秒）
    max-reaction-time: 1000
    
    # 操作规律性阈值（0-1之间）
    regularity-threshold: 0.8
    
    # 自动钓鱼检测的惩罚类型
    punishment: warning
    
    # 异步检测开关
    async: false
    
    # 调试模式开关
    debug: false
    
    # 玩家权限绕过检测
    bypass-permission: 鍏夎氨Spectrum.bypass.autofish

惩罚设置

自动钓鱼检测支持的惩罚类型：

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

常见误报原因及解决方案

误报原因	解决方案
高网络延迟	增加`threshold`值，或调整`max-reaction-time`值
钓鱼插件	在`compatibility.yml`中添加兼容设置
玩家手动钓鱼技巧	增加`regularity-threshold`值

🔧 AutoTool (自动工具检测)

功能描述

检测玩家是否使用自动工具作弊，能够根据目标方块自动切换到合适的工具。

检测原理

分析物品栏切换的频率和时机
监测方块交互与工具切换的关系
比较预期的工具选择与实际选择
检测异常的物品栏操作速度
分析工具效率与方块类型的匹配度

配置参数详解

yaml

automation:
  autotool:
    # 是否启用自动工具检测
    enabled: true
    
    # 检测阈值（0-1之间）
    threshold: 0.6
    
    # 违规积累速度
    violation-rate: 1.0
    
    # 最大违规次数
    max-violations: 15
    
    # 重置违规计数的时间间隔（秒）
    violation-reset-time: 300
    
    # 最小预期工具切换时间（毫秒）
    min-tool-switch-time: 50
    
    # 工具效率匹配阈值（百分比）
    tool-efficiency-threshold: 70
    
    # 自动工具检测的惩罚类型
    punishment: warning
    
    # 异步检测开关
    async: false
    
    # 调试模式开关
    debug: false
    
    # 玩家权限绕过检测
    bypass-permission: 鍏夎氨Spectrum.bypass.autotool

惩罚设置

自动工具检测支持的惩罚类型：

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

常见误报原因及解决方案

误报原因	解决方案
玩家快速切换技巧	增加`threshold`值，或调整`min-tool-switch-time`值
物品栏管理插件	在`compatibility.yml`中添加兼容设置
服务器延迟导致的工具同步问题	启用`latency-compensation`

🛡️ AutoArmor (自动盔甲检测)

功能描述

检测玩家是否使用自动盔甲作弊，能够在受到伤害或战斗开始时自动装备或切换盔甲。

检测原理

分析盔甲装备和卸除的时机
监测伤害事件与盔甲操作的关系
比较预期的盔甲切换时间与实际时间
检测异常的盔甲操作速度
分析盔甲类型与伤害来源的匹配度

配置参数详解

yaml

automation:
  autoarmor:
    # 是否启用自动盔甲检测
    enabled: true
    
    # 检测阈值（0-1之间）
    threshold: 0.6
    
    # 违规积累速度
    violation-rate: 1.0
    
    # 最大违规次数
    max-violations: 15
    
    # 重置违规计数的时间间隔（秒）
    violation-reset-time: 300
    
    # 最小预期盔甲切换时间（毫秒）
    min-armor-switch-time: 100
    
    # 盔甲效率匹配阈值（百分比）
    armor-efficiency-threshold: 70
    
    # 自动盔甲检测的惩罚类型
    punishment: warning
    
    # 异步检测开关
    async: false
    
    # 调试模式开关
    debug: false
    
    # 玩家权限绕过检测
    bypass-permission: 鍏夎氨Spectrum.bypass.autoarmor

惩罚设置

自动盔甲检测支持的惩罚类型：

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

常见误报原因及解决方案

误报原因	解决方案
玩家快速装备技巧	增加`threshold`值，或调整`min-armor-switch-time`值
盔甲管理插件	在`compatibility.yml`中添加兼容设置
服务器延迟导致的盔甲同步问题	启用`latency-compensation`

🖱️ AutoClicker (自动点击检测)

功能描述

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

检测原理

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

配置参数详解

yaml

automation:
  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`中添加兼容设置

🌾 AutoFarm (自动农场检测)

功能描述

检测玩家是否使用自动农场作弊，能够自动种植、收获和管理农作物。

检测原理

分析玩家在农场区域的行为模式
监测种植和收获操作的频率和规律性
比较预期的农场操作时间与实际时间
检测异常的方块交互模式
分析作物状态与玩家操作的同步性

配置参数详解

yaml

automation:
  autofarm:
    # 是否启用自动农场检测
    enabled: true
    
    # 检测阈值（0-1之间）
    threshold: 0.6
    
    # 违规积累速度
    violation-rate: 1.0
    
    # 最大违规次数
    max-violations: 15
    
    # 重置违规计数的时间间隔（秒）
    violation-reset-time: 300
    
    # 农场操作规律性阈值（0-1之间）
    farm-regularity-threshold: 0.8
    
    # 最小预期种植/收获时间（毫秒）
    min-farm-operation-time: 50
    
    # 自动农场检测的惩罚类型
    punishment: warning
    
    # 异步检测开关
    async: false
    
    # 调试模式开关
    debug: false
    
    # 玩家权限绕过检测
    bypass-permission: 鍏夎氨Spectrum.bypass.autofarm

惩罚设置

自动农场检测支持的惩罚类型：

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

常见误报原因及解决方案

误报原因	解决方案
玩家熟练的农场操作	增加`threshold`值，或调整`farm-regularity-threshold`值
自动化农场插件	在`compatibility.yml`中添加兼容设置
红石机械辅助	在`compatibility.yml`中添加兼容设置

🚶 AutoWalk (自动行走检测)

功能描述

检测玩家是否使用自动行走作弊，能够自动移动、跟随路径或保持特定方向移动。

检测原理

分析玩家的移动模式和路径
监测方向变化的频率和规律性
比较预期的手动控制与实际移动行为
检测异常的移动精度和稳定性
分析环境交互与移动的同步性

配置参数详解

yaml

automation:
  autowalk:
    # 是否启用自动行走检测
    enabled: true
    
    # 检测阈值（0-1之间）
    threshold: 0.6
    
    # 违规积累速度
    violation-rate: 1.0
    
    # 最大违规次数
    max-violations: 15
    
    # 重置违规计数的时间间隔（秒）
    violation-reset-time: 300
    
    # 移动稳定性阈值（0-1之间）
    movement-stability-threshold: 0.85
    
    # 方向变化频率阈值（变化/秒）
    direction-change-threshold: 0.5
    
    # 自动行走检测的惩罚类型
    punishment: warning
    
    # 异步检测开关
    async: false
    
    # 调试模式开关
    debug: false
    
    # 玩家权限绕过检测
    bypass-permission: 鍏夎氨Spectrum.bypass.autowalk

惩罚设置

自动行走检测支持的惩罚类型：

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

常见误报原因及解决方案

误报原因	解决方案
玩家使用方向键固定移动	增加`threshold`值，或调整`movement-stability-threshold`值
导航插件	在`compatibility.yml`中添加兼容设置
服务器延迟导致的移动平滑	启用`latency-compensation`

🍲 AutoSoup (自动喝汤检测)

功能描述

检测玩家是否使用自动喝汤作弊，能够在生命值低下时自动饮用治疗物品。

检测原理

分析玩家的生命值变化与物品使用的关系
监测物品使用的时机和频率
比较预期的反应时间与实际反应时间
检测异常的物品栏操作速度
分析治疗物品使用的规律性

配置参数详解

yaml

automation:
  autosoup:
    # 是否启用自动喝汤检测
    enabled: true
    
    # 检测阈值（0-1之间）
    threshold: 0.6
    
    # 违规积累速度
    violation-rate: 1.0
    
    # 最大违规次数
    max-violations: 15
    
    # 重置违规计数的时间间隔（秒）
    violation-reset-time: 300
    
    # 最小预期反应时间（毫秒）
    min-reaction-time: 100
    
    # 治疗物品使用规律性阈值（0-1之间）
    soup-regularity-threshold: 0.8
    
    # 自动喝汤检测的惩罚类型
    punishment: warning
    
    # 异步检测开关
    async: false
    
    # 调试模式开关
    debug: false
    
    # 玩家权限绕过检测
    bypass-permission: 鍏夎氨Spectrum.bypass.autosoup

惩罚设置

自动喝汤检测支持的惩罚类型：

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

常见误报原因及解决方案

误报原因	解决方案
玩家快速反应能力	增加`threshold`值，或调整`min-reaction-time`值
治疗插件	在`compatibility.yml`中添加兼容设置
服务器延迟导致的状态同步问题	启用`latency-compensation`

📝 配置示例

以下是自动化检测模块的推荐配置示例：

yaml

automation:
  # 自动钓鱼检测
  autofish:
    enabled: true
    threshold: 0.6
    min-reaction-time: 100
    max-reaction-time: 1000
    punishment: warning
    
  # 自动工具检测
  autotool:
    enabled: true
    threshold: 0.6
    min-tool-switch-time: 50
    punishment: warning
    
  # 自动盔甲检测
  autoarmor:
    enabled: true
    threshold: 0.6
    min-armor-switch-time: 100
    punishment: warning
    
  # 自动点击检测
  autoclicker:
    enabled: true
    threshold: 0.7
    max-click-rate: 15.0
    click-pattern-analysis: true
    punishment: warning
    
  # 自动农场检测
  autofarm:
    enabled: true
    threshold: 0.6
    farm-regularity-threshold: 0.8
    punishment: warning
    
  # 自动行走检测
  autowalk:
    enabled: true
    threshold: 0.6
    movement-stability-threshold: 0.85
    punishment: warning
    
  # 自动喝汤检测
  autosoup:
    enabled: true
    threshold: 0.6
    min-reaction-time: 100
    punishment: warning

❓ 常见问题

如何减少自动化检测的误报？

调整检测阈值：增加threshold值可以降低检测的严格程度
考虑服务器延迟：在config.yml中启用latency-compensation并设置合适的值
为特殊玩家设置白名单：使用/鍏夎氨Spectrum whitelist add <player>命令
配置兼容模式：在compatibility.yml中添加与其他插件的兼容设置
对于熟练玩家，调整相关的反应时间和操作速度参数

如何优化自动化检测的性能？

对于性能较低的服务器，可以禁用一些非核心的自动化检测模块
调整检测频率：在config.yml中增加check-interval值
启用异步检测：对于计算密集型的检测模块，将async设置为true
降低数据采样率：在不影响检测效果的前提下，适当降低数据采样频率

如何应对新型自动化作弊？

定期更新鍏夎氨Spectrum反作弊插件以获取最新的检测算法
监控服务器日志，及时发现异常的玩家行为模式
使用/鍏夎氨Spectrum debug <player>命令分析特定玩家的行为
向鍏夎氨Spectrum开发团队报告新型作弊行为，以便在未来版本中添加相应的检测

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

自动化检测模块详细文档 ​

📋 目录 ​

🔍 模块概述 ​

🎣 AutoFish (自动钓鱼检测) ​

功能描述 ​

检测原理 ​

配置参数详解 ​

惩罚设置 ​

常见误报原因及解决方案 ​

🔧 AutoTool (自动工具检测) ​

功能描述 ​

检测原理 ​

配置参数详解 ​

惩罚设置 ​

常见误报原因及解决方案 ​

🛡️ AutoArmor (自动盔甲检测) ​

功能描述 ​

检测原理 ​

配置参数详解 ​

惩罚设置 ​

常见误报原因及解决方案 ​

🖱️ AutoClicker (自动点击检测) ​

功能描述 ​

检测原理 ​

配置参数详解 ​

惩罚设置 ​

常见误报原因及解决方案 ​

🌾 AutoFarm (自动农场检测) ​

功能描述 ​

检测原理 ​

配置参数详解 ​

惩罚设置 ​

常见误报原因及解决方案 ​

🚶 AutoWalk (自动行走检测) ​

功能描述 ​

检测原理 ​

配置参数详解 ​

惩罚设置 ​

常见误报原因及解决方案 ​

🍲 AutoSoup (自动喝汤检测) ​

功能描述 ​

检测原理 ​

配置参数详解 ​

惩罚设置 ​

常见误报原因及解决方案 ​

📝 配置示例 ​

❓ 常见问题 ​

如何减少自动化检测的误报？ ​

如何优化自动化检测的性能？ ​

如何应对新型自动化作弊？ ​

自动化检测模块详细文档

📋 目录

🔍 模块概述

🎣 AutoFish (自动钓鱼检测)

功能描述

检测原理

配置参数详解

惩罚设置

常见误报原因及解决方案

🔧 AutoTool (自动工具检测)

功能描述

检测原理

配置参数详解

惩罚设置

常见误报原因及解决方案

🛡️ AutoArmor (自动盔甲检测)

功能描述

检测原理

配置参数详解

惩罚设置

常见误报原因及解决方案

🖱️ AutoClicker (自动点击检测)

功能描述

检测原理

配置参数详解

惩罚设置

常见误报原因及解决方案

🌾 AutoFarm (自动农场检测)

功能描述

检测原理

配置参数详解

惩罚设置

常见误报原因及解决方案

🚶 AutoWalk (自动行走检测)

功能描述

检测原理

配置参数详解

惩罚设置

常见误报原因及解决方案

🍲 AutoSoup (自动喝汤检测)

功能描述

检测原理

配置参数详解

惩罚设置

常见误报原因及解决方案

📝 配置示例

❓ 常见问题

如何减少自动化检测的误报？

如何优化自动化检测的性能？

如何应对新型自动化作弊？