视觉检测模块详细文档

📋 目录

模块概述
XRay (X光透视检测)
ESP (实体轮廓检测)
Fullbright (全屏亮度检测)
NightVision (夜视检测)
[AntiBlindness (防失明检测)](#antib lindness-防失明检测)
Freecam (自由视角检测)
配置示例
常见问题

🔍 模块概述

视觉检测模块负责监控和识别各种与游戏视觉相关的作弊行为，包括X光透视、实体轮廓显示、全屏亮度增强等。该模块通过分析玩家的行为模式、区块加载请求、光线敏感度等数据，来检测各种视觉作弊。

所有视觉检测模块的配置都位于plugins/Spectrum/checks.yml文件中的visual部分。

🔦 XRay (X光透视检测)

功能描述

检测玩家是否使用X光透视作弊，能够看到地下的矿物、宝箱或其他隐藏的方块。

检测原理

分析玩家对特定方块的挖掘和交互模式
监测玩家查看和加载区块的方式
比较预期的探索路径与实际的探索路径
检测异常的方块选择和挖掘行为
分析玩家的射线检测请求模式

配置参数详解

yaml

visual:
  xray:
    # 是否启用X光透视检测
    enabled: true
    
    # 检测阈值（0-1之间）
    threshold: 0.7
    
    # 违规积累速度
    violation-rate: 1.0
    
    # 最大违规次数
    max-violations: 10
    
    # 重置违规计数的时间间隔（秒）
    violation-reset-time: 300
    
    # 矿物方块检测权重
    ore-block-weight: 2.0
    
    # 贵重方块检测权重
    valuable-block-weight: 3.0
    
    # 地下深度检测阈值（方块）
    underground-depth-threshold: 15
    
    # 异常挖掘模式检测
    abnormal-mining-detection: true
    
    # X光透视检测的惩罚类型
    punishment: kick
    
    # 异步检测开关
    async: true
    
    # 调试模式开关
    debug: false
    
    # 玩家权限绕过检测
    bypass-permission: 鍏夎氨Spectrum.bypass.xray

惩罚设置

X光透视检测支持的惩罚类型：

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

常见误报原因及解决方案

误报原因	解决方案
玩家使用声音定位	增加`threshold`值，或调整`ore-block-weight`值
玩家使用矿物追踪物品	在`compatibility.yml`中添加兼容设置
玩家熟悉地形	调整`abnormal-mining-detection`参数

👁️ ESP (实体轮廓检测)

功能描述

检测玩家是否使用ESP作弊，能够显示实体、玩家或方块的轮廓，使其更容易被发现。

检测原理

分析玩家对实体的锁定和跟踪行为
监测玩家的视角移动和实体选择模式
比较预期的实体发现时间与实际时间
检测异常的目标选择和攻击行为
分析玩家的碰撞箱检测请求模式

配置参数详解

yaml

visual:
  esp:
    # 是否启用实体轮廓检测
    enabled: true
    
    # 检测阈值（0-1之间）
    threshold: 0.7
    
    # 违规积累速度
    violation-rate: 1.0
    
    # 最大违规次数
    max-violations: 10
    
    # 重置违规计数的时间间隔（秒）
    violation-reset-time: 300
    
    # 实体锁定检测权重
    entity-lock-weight: 2.0
    
    # 视角追踪检测权重
    aim-tracking-weight: 2.5
    
    # 实体可见性阈值（百分比）
    entity-visibility-threshold: 30
    
    # ESP检测的惩罚类型
    punishment: kick
    
    # 异步检测开关
    async: true
    
    # 调试模式开关
    debug: false
    
    # 玩家权限绕过检测
    bypass-permission: 鍏夎氨Spectrum.bypass.esp

惩罚设置

实体轮廓检测支持的惩罚类型：

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

常见误报原因及解决方案

误报原因	解决方案
玩家使用声音定位	增加`threshold`值，或调整`entity-visibility-threshold`值
玩家有良好的观察能力	调整`entity-lock-weight`值
服务器延迟导致的视角问题	启用`latency-compensation`

💡 Fullbright (全屏亮度检测)

功能描述

检测玩家是否使用全屏亮度作弊，能够在黑暗环境中获得明亮的视觉效果。

检测原理

分析玩家在黑暗环境中的行为和移动模式
监测玩家对光线水平的敏感度变化
比较预期的探索速度与实际的探索速度
检测异常的方块交互和实体发现行为
分析客户端请求的亮度设置和渲染参数

配置参数详解

yaml

visual:
  fullbright:
    # 是否启用全屏亮度检测
    enabled: true
    
    # 检测阈值（0-1之间）
    threshold: 0.6
    
    # 违规积累速度
    violation-rate: 1.0
    
    # 最大违规次数
    max-violations: 15
    
    # 重置违规计数的时间间隔（秒）
    violation-reset-time: 300
    
    # 黑暗环境定义（亮度等级）
    dark-environment-level: 5
    
    # 黑暗中移动速度阈值（方块/秒）
    dark-movement-threshold: 4.0
    
    # 考虑夜视药水效果
    consider-night-vision: true
    
    # 全屏亮度检测的惩罚类型
    punishment: warning
    
    # 异步检测开关
    async: false
    
    # 调试模式开关
    debug: false
    
    # 玩家权限绕过检测
    bypass-permission: 鍏夎氨Spectrum.bypass.fullbright

惩罚设置

全屏亮度检测支持的惩罚类型：

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

常见误报原因及解决方案

误报原因	解决方案
玩家使用大量火把	增加`threshold`值，或调整`dark-movement-threshold`值
玩家使用夜视药水	确保`consider-night-vision`设置为`true`
客户端亮度设置高	在`compatibility.yml`中添加兼容设置

🌙 NightVision (夜视检测)

功能描述

检测玩家是否使用夜视作弊，能够在黑暗环境中看清周围环境，而不需要使用夜视药水。

检测原理

分析玩家在黑暗环境中的视觉相关行为
监测玩家对黑暗环境的适应性和反应速度
比较预期的视觉受限行为与实际行为
检测异常的客户端渲染请求
分析光线变化对玩家行为的影响

配置参数详解

yaml

visual:
  nightvision:
    # 是否启用夜视检测
    enabled: true
    
    # 检测阈值（0-1之间）
    threshold: 0.6
    
    # 违规积累速度
    violation-rate: 1.0
    
    # 最大违规次数
    max-violations: 15
    
    # 重置违规计数的时间间隔（秒）
    violation-reset-time: 300
    
    # 黑暗环境定义（亮度等级）
    dark-environment-level: 5
    
    # 黑暗中交互速度阈值
    dark-interaction-threshold: 1.5
    
    # 考虑夜视药水效果
    consider-night-vision: true
    
    # 夜视检测的惩罚类型
    punishment: warning
    
    # 异步检测开关
    async: false
    
    # 调试模式开关
    debug: false
    
    # 玩家权限绕过检测
    bypass-permission: 鍏夎氨Spectrum.bypass.nightvision

惩罚设置

夜视检测支持的惩罚类型：

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

常见误报原因及解决方案

误报原因	解决方案
玩家使用大量火把	增加`threshold`值，或调整`dark-interaction-threshold`值
玩家使用夜视药水	确保`consider-night-vision`设置为`true`
客户端亮度设置高	在`compatibility.yml`中添加兼容设置

🧿 AntiBlindness (防失明检测)

功能描述

检测玩家是否使用防失明作弊，能够忽略或减少失明、迟缓等负面效果的视觉影响。

检测原理

分析玩家在负面效果影响下的行为变化
监测异常的移动和交互模式
比较预期的视觉受限行为与实际行为
检测客户端对负面效果的响应数据
分析效果持续时间与玩家行为的关系

配置参数详解

yaml

visual:
  antib lindness:
    # 是否启用防失明检测
    enabled: true
    
    # 检测阈值（0-1之间）
    threshold: 0.6
    
    # 违规积累速度
    violation-rate: 1.0
    
    # 最大违规次数
    max-violations: 15
    
    # 重置违规计数的时间间隔（秒）
    violation-reset-time: 300
    
    # 失明效果检测权重
    blindness-effect-weight: 2.0
    
    # 迟缓效果检测权重
    slowness-effect-weight: 1.5
    
    # 防失明检测的惩罚类型
    punishment: warning
    
    # 异步检测开关
    async: false
    
    # 调试模式开关
    debug: false
    
    # 玩家权限绕过检测
    bypass-permission: 鍏夎氨Spectrum.bypass.antiblindness

惩罚设置

防失明检测支持的惩罚类型：

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

常见误报原因及解决方案

误报原因	解决方案
玩家使用牛奶桶	确保检测系统考虑了状态效果的移除
玩家适应能力强	调整`blindness-effect-weight`值
服务器延迟导致的效果同步问题	启用`latency-compensation`

🎥 Freecam (自由视角检测)

功能描述

检测玩家是否使用自由视角作弊，能够分离视角和实体位置，查看周围环境而不移动角色。

检测原理

分析玩家的视角移动与实体位置的关系
监测异常的视角旋转和移动模式
比较预期的视角限制与实际视角行为
检测客户端的相机状态和位置数据
分析视角移动速度和范围

配置参数详解

yaml

visual:
  freecam:
    # 是否启用自由视角检测
    enabled: true
    
    # 检测阈值（0-1之间）
    threshold: 0.7
    
    # 违规积累速度
    violation-rate: 1.0
    
    # 最大违规次数
    max-violations: 10
    
    # 重置违规计数的时间间隔（秒）
    violation-reset-time: 300
    
    # 允许的最大视角与实体分离距离（方块）
    max-camera-distance: 5.0
    
    # 允许的最大视角旋转速度（度/毫秒）
    max-camera-rotation-speed: 3.0
    
    # 考虑旁观者模式
    consider-spectator: true
    
    # 自由视角检测的惩罚类型
    punishment: kick
    
    # 异步检测开关
    async: false
    
    # 调试模式开关
    debug: false
    
    # 玩家权限绕过检测
    bypass-permission: 鍏夎氨Spectrum.bypass.freecam

惩罚设置

自由视角检测支持的惩罚类型：

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

常见误报原因及解决方案

误报原因	解决方案
服务器延迟导致的视角同步问题	增加`threshold`值，或启用`latency-compensation`
特殊游戏机制（如末影珍珠）	在`compatibility.yml`中添加兼容设置
旁观者模式玩家	确保`consider-spectator`设置为`true`

📝 配置示例

以下是视觉检测模块的推荐配置示例：

yaml

visual:
  # X光透视检测
  xray:
    enabled: true
    threshold: 0.7
    ore-block-weight: 2.0
    punishment: kick
    
  # 实体轮廓检测
  esp:
    enabled: true
    threshold: 0.7
    entity-lock-weight: 2.0
    punishment: kick
    
  # 全屏亮度检测
  fullbright:
    enabled: true
    threshold: 0.6
    dark-environment-level: 5
    consider-night-vision: true
    punishment: warning
    
  # 夜视检测
  nightvision:
    enabled: true
    threshold: 0.6
    dark-environment-level: 5
    consider-night-vision: true
    punishment: warning
    
  # 防失明检测
  antib lindness:
    enabled: true
    threshold: 0.6
    blindness-effect-weight: 2.0
    punishment: warning
    
  # 自由视角检测
  freecam:
    enabled: true
    threshold: 0.7
    max-camera-distance: 5.0
    consider-spectator: true
    punishment: kick

❓ 常见问题

如何减少视觉检测的误报？

调整检测阈值：增加threshold值可以降低检测的严格程度
考虑游戏机制：确保检测系统考虑了夜视药水、旁观者模式等合法游戏机制
为特殊玩家设置白名单：使用/鍏夎氨Spectrum whitelist add <player>命令
配置兼容模式：在compatibility.yml中添加与其他插件的兼容设置

如何优化视觉检测的性能？

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

如何应对新型视觉作弊？

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

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

视觉检测模块详细文档 ​

📋 目录 ​

🔍 模块概述 ​

🔦 XRay (X光透视检测) ​

功能描述 ​

检测原理 ​

配置参数详解 ​

惩罚设置 ​

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

👁️ ESP (实体轮廓检测) ​

功能描述 ​

检测原理 ​

配置参数详解 ​

惩罚设置 ​

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

💡 Fullbright (全屏亮度检测) ​

功能描述 ​

检测原理 ​

配置参数详解 ​

惩罚设置 ​

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

🌙 NightVision (夜视检测) ​

功能描述 ​

检测原理 ​

配置参数详解 ​

惩罚设置 ​

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

🧿 AntiBlindness (防失明检测) ​

功能描述 ​

检测原理 ​

配置参数详解 ​

惩罚设置 ​

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

🎥 Freecam (自由视角检测) ​

功能描述 ​

检测原理 ​

配置参数详解 ​

惩罚设置 ​

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

📝 配置示例 ​

❓ 常见问题 ​

如何减少视觉检测的误报？ ​

如何优化视觉检测的性能？ ​

如何应对新型视觉作弊？ ​

视觉检测模块详细文档

📋 目录

🔍 模块概述

🔦 XRay (X光透视检测)

功能描述

检测原理

配置参数详解

惩罚设置

常见误报原因及解决方案

👁️ ESP (实体轮廓检测)

功能描述

检测原理

配置参数详解

惩罚设置

常见误报原因及解决方案

💡 Fullbright (全屏亮度检测)

功能描述

检测原理

配置参数详解

惩罚设置

常见误报原因及解决方案

🌙 NightVision (夜视检测)

功能描述

检测原理

配置参数详解

惩罚设置

常见误报原因及解决方案

🧿 AntiBlindness (防失明检测)

功能描述

检测原理

配置参数详解

惩罚设置

常见误报原因及解决方案

🎥 Freecam (自由视角检测)

功能描述

检测原理

配置参数详解

惩罚设置

常见误报原因及解决方案

📝 配置示例

❓ 常见问题

如何减少视觉检测的误报？

如何优化视觉检测的性能？

如何应对新型视觉作弊？