世界操作检测模块详细文档

📋 目录

模块概述
BlockFly (方块飞行检测)
FastBreak (快速破坏检测)
FastPlace (快速放置检测)
Nuker (区域破坏检测)
Xray (矿物透视检测)
IllegalInteract (非法交互检测)
配置示例
常见问题

🔍 模块概述

世界操作检测模块负责监控和识别各种与游戏世界交互相关的作弊行为，包括方块飞行、快速破坏、快速放置、区域破坏、矿物透视等。该模块通过分析玩家与方块的交互模式、破坏速度、放置速度、交互距离等数据，来检测各种世界操作作弊。

所有世界操作检测模块的配置都位于plugins/Spectrum/checks.yml文件中的world部分。

🚁 BlockFly (方块飞行检测)

功能描述

检测玩家是否使用方块飞行作弊，能够在不放置方块的情况下悬浮或飞行。

检测原理

分析玩家的移动轨迹和方块支撑情况
监测玩家的空中停留时间和移动模式
比较预期的落地时间与实际落地时间
检测玩家周围方块的变化和支撑状态
分析玩家的跳跃行为和重力影响

配置参数详解

yaml

world:
  blockfly:
    # 是否启用方块飞行检测
    enabled: true
    
    # 检测阈值（0-1之间）
    threshold: 0.6
    
    # 违规积累速度
    violation-rate: 1.0
    
    # 最大违规次数
    max-violations: 10
    
    # 重置违规计数的时间间隔（秒）
    violation-reset-time: 300
    
    # 允许的最大空中停留时间（毫秒）
    max-air-time: 2000
    
    # 允许的最大空中移动距离（方块）
    max-air-distance: 5.0
    
    # 方块飞行检测的惩罚类型
    punishment: warning
    
    # 异步检测开关
    async: false
    
    # 调试模式开关
    debug: false
    
    # 玩家权限绕过检测
    bypass-permission: 鍏夎氨Spectrum.bypass.blockfly

惩罚设置

方块飞行检测支持的惩罚类型：

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

常见误报原因及解决方案

误报原因	解决方案
服务器延迟导致的位置同步问题	启用`latency-compensation`
特殊游戏机制（如鞘翅飞行）	在`compatibility.yml`中添加兼容设置
自定义飞行插件	在`compatibility.yml`中添加兼容设置

🔨 FastBreak (快速破坏检测)

功能描述

检测玩家是否使用快速破坏作弊，能够以异常快的速度破坏方块。

检测原理

分析方块破坏的时间和频率
监测破坏速度与工具的匹配情况
比较预期的破坏时间与实际破坏时间
检测异常的方块破坏顺序和模式
分析方块破坏的声音和粒子效果

配置参数详解

yaml

world:
  fastbreak:
    # 是否启用快速破坏检测
    enabled: true
    
    # 检测阈值（0-1之间）
    threshold: 0.6
    
    # 违规积累速度
    violation-rate: 1.0
    
    # 最大违规次数
    max-violations: 15
    
    # 重置违规计数的时间间隔（秒）
    violation-reset-time: 300
    
    # 允许的最小破坏时间比例（%）
    min-break-time-percentage: 20
    
    # 允许的最大方块破坏速度（方块/秒）
    max-block-break-rate: 3.0
    
    # 快速破坏检测的惩罚类型
    punishment: warning
    
    # 异步检测开关
    async: false
    
    # 调试模式开关
    debug: false
    
    # 玩家权限绕过检测
    bypass-permission: 鍏夎氨Spectrum.bypass.fastbreak

惩罚设置

快速破坏检测支持的惩罚类型：

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

常见误报原因及解决方案

误报原因	解决方案
服务器性能波动	启用`performance-variation-tolerance`
特殊工具或附魔效果	在`compatibility.yml`中添加兼容设置
方块破坏的特殊机制	调整`min-break-time-percentage`值

🧱 FastPlace (快速放置检测)

功能描述

检测玩家是否使用快速放置作弊，能够以异常快的速度放置方块。

检测原理

分析方块放置的时间和频率
监测放置速度与物品栏的匹配情况
比较预期的放置时间与实际放置时间
检测异常的方块放置顺序和模式
分析方块放置的距离和方向

配置参数详解

yaml

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

惩罚设置

快速放置检测支持的惩罚类型：

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

常见误报原因及解决方案

误报原因	解决方案
服务器性能波动	启用`performance-variation-tolerance`
玩家熟练的放置技巧	调整`max-block-place-rate`值
建筑辅助插件	在`compatibility.yml`中添加兼容设置

💣 Nuker (区域破坏检测)

功能描述

检测玩家是否使用区域破坏作弊，能够同时破坏多个方块或特定区域的方块。

检测原理

分析方块破坏的空间分布和模式
监测破坏区域的大小和形状
比较预期的破坏模式与实际破坏模式
检测异常的方块破坏序列
分析破坏的方块类型和用途

配置参数详解

yaml

world:
  nuker:
    # 是否启用区域破坏检测
    enabled: true
    
    # 检测阈值（0-1之间）
    threshold: 0.7
    
    # 违规积累速度
    violation-rate: 1.0
    
    # 最大违规次数
    max-violations: 5
    
    # 重置违规计数的时间间隔（秒）
    violation-reset-time: 300
    
    # 允许的最大区域破坏大小（方块数）
    max-area-size: 10
    
    # 区域检测的时间窗口（毫秒）
    detection-window: 1000
    
    # 区域破坏检测的惩罚类型
    punishment: ban
    
    # 异步检测开关
    async: true
    
    # 调试模式开关
    debug: false
    
    # 玩家权限绕过检测
    bypass-permission: 鍏夎氨Spectrum.bypass.nuker

惩罚设置

区域破坏检测支持的惩罚类型：

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

常见误报原因及解决方案

误报原因	解决方案
TNT或苦力怕爆炸	在`compatibility.yml`中添加兼容设置
大爆炸插件	在`compatibility.yml`中添加兼容设置
特殊挖掘技巧	调整`max-area-size`值

💎 Xray (矿物透视检测)

功能描述

检测玩家是否使用矿物透视作弊，能够直接看到地下的矿物和资源。

检测原理

分析玩家的移动和查看方向
监测玩家对矿物方块的兴趣和互动模式
比较预期的矿物发现概率与实际发现概率
检测异常的挖掘路径和模式
分析玩家的区块加载和探索行为

配置参数详解

yaml

world:
  xray:
    # 是否启用矿物透视检测
    enabled: true
    
    # 检测阈值（0-1之间）
    threshold: 0.7
    
    # 违规积累速度
    violation-rate: 1.0
    
    # 最大违规次数
    max-violations: 10
    
    # 重置违规计数的时间间隔（秒）
    violation-reset-time: 600
    
    # 矿物发现概率阈值（%）
    ore-discovery-threshold: 70
    
    # 检测查看方向
    detect-view-direction: true
    
    # 矿物透视检测的惩罚类型
    punishment: ban
    
    # 异步检测开关
    async: true
    
    # 调试模式开关
    debug: false
    
    # 玩家权限绕过检测
    bypass-permission: 鍏夎氨Spectrum.bypass.xray

惩罚设置

矿物透视检测支持的惩罚类型：

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

常见误报原因及解决方案

误报原因	解决方案
幸运玩家	调整`ore-discovery-threshold`值
辅助工具（如指南针）	在`compatibility.yml`中添加兼容设置
洞穴探索技巧	在`compatibility.yml`中添加兼容设置

👆 IllegalInteract (非法交互检测)

功能描述

检测玩家是否使用非法交互作弊，能够与正常情况下无法交互的方块或实体进行交互。

检测原理

分析玩家与方块或实体的交互距离
监测交互的角度和方向
比较预期的交互范围与实际交互范围
检测异常的交互目标和模式
分析交互的结果和影响

配置参数详解

yaml

world:
  illegalinteract:
    # 是否启用非法交互检测
    enabled: true
    
    # 检测阈值（0-1之间）
    threshold: 0.7
    
    # 违规积累速度
    violation-rate: 1.0
    
    # 最大违规次数
    max-violations: 5
    
    # 重置违规计数的时间间隔（秒）
    violation-reset-time: 300
    
    # 允许的最大交互距离（方块）
    max-interact-distance: 5.0
    
    # 检测穿透交互
    detect-through-blocks: true
    
    # 非法交互检测的惩罚类型
    punishment: kick
    
    # 异步检测开关
    async: false
    
    # 调试模式开关
    debug: false
    
    # 玩家权限绕过检测
    bypass-permission: 鍏夎氨Spectrum.bypass.illegalinteract

惩罚设置

非法交互检测支持的惩罚类型：

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

常见误报原因及解决方案

误报原因	解决方案
服务器延迟导致的位置同步问题	启用`latency-compensation`
特殊交互机制	在`compatibility.yml`中添加兼容设置
自定义交互插件	在`compatibility.yml`中添加兼容设置

📝 配置示例

以下是世界操作检测模块的推荐配置示例：

yaml

world:
  # 方块飞行检测
  blockfly:
    enabled: true
    threshold: 0.6
    max-air-time: 2000
    punishment: warning
    
  # 快速破坏检测
  fastbreak:
    enabled: true
    threshold: 0.6
    min-break-time-percentage: 20
    max-block-break-rate: 3.0
    punishment: warning
    
  # 快速放置检测
  fastplace:
    enabled: true
    threshold: 0.6
    max-block-place-rate: 5.0
    min-place-interval: 100
    punishment: warning
    
  # 区域破坏检测
  nuker:
    enabled: true
    threshold: 0.7
    max-area-size: 10
    detection-window: 1000
    punishment: ban
    
  # 矿物透视检测
  xray:
    enabled: true
    threshold: 0.7
    ore-discovery-threshold: 70
    punishment: ban
    
  # 非法交互检测
  illegalinteract:
    enabled: true
    threshold: 0.7
    max-interact-distance: 5.0
    punishment: kick

❓ 常见问题

如何减少世界操作检测的误报？

调整检测阈值：增加threshold值可以降低检测的严格程度
考虑服务器延迟：在config.yml中启用latency-compensation并设置合适的值
配置兼容模式：在compatibility.yml中添加与其他插件的兼容设置
为特定方块或交互设置白名单：使用/鍏夎氨Spectrum whitelist addblock <block>命令
对于建筑服务器，调整快速放置和快速破坏的检测参数

如何优化世界操作检测的性能？

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

如何应对新型世界操作作弊？

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

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

世界操作检测模块详细文档 ​

📋 目录 ​

🔍 模块概述 ​

🚁 BlockFly (方块飞行检测) ​

功能描述 ​

检测原理 ​

配置参数详解 ​

惩罚设置 ​

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

🔨 FastBreak (快速破坏检测) ​

功能描述 ​

检测原理 ​

配置参数详解 ​

惩罚设置 ​

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

🧱 FastPlace (快速放置检测) ​

功能描述 ​

检测原理 ​

配置参数详解 ​

惩罚设置 ​

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

💣 Nuker (区域破坏检测) ​

功能描述 ​

检测原理 ​

配置参数详解 ​

惩罚设置 ​

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

💎 Xray (矿物透视检测) ​

功能描述 ​

检测原理 ​

配置参数详解 ​

惩罚设置 ​

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

👆 IllegalInteract (非法交互检测) ​

功能描述 ​

检测原理 ​

配置参数详解 ​

惩罚设置 ​

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

📝 配置示例 ​

❓ 常见问题 ​

如何减少世界操作检测的误报？ ​

如何优化世界操作检测的性能？ ​

如何应对新型世界操作作弊？ ​

世界操作检测模块详细文档

📋 目录

🔍 模块概述

🚁 BlockFly (方块飞行检测)

功能描述

检测原理

配置参数详解

惩罚设置

常见误报原因及解决方案

🔨 FastBreak (快速破坏检测)

功能描述

检测原理

配置参数详解

惩罚设置

常见误报原因及解决方案

🧱 FastPlace (快速放置检测)

功能描述

检测原理

配置参数详解

惩罚设置

常见误报原因及解决方案

💣 Nuker (区域破坏检测)

功能描述

检测原理

配置参数详解

惩罚设置

常见误报原因及解决方案

💎 Xray (矿物透视检测)

功能描述

检测原理

配置参数详解

惩罚设置

常见误报原因及解决方案

👆 IllegalInteract (非法交互检测)

功能描述

检测原理

配置参数详解

惩罚设置

常见误报原因及解决方案

📝 配置示例

❓ 常见问题

如何减少世界操作检测的误报？

如何优化世界操作检测的性能？

如何应对新型世界操作作弊？