库存检测模块详细文档

📋 目录

模块概述
InventoryMove (物品栏移动检测)
ItemDupe (物品复制检测)
ItemMod (物品修改检测)
FastClick (快速点击检测)
AutoRefill (自动填充检测)
CheatItems (作弊物品检测)
配置示例
常见问题

🔍 模块概述

库存检测模块负责监控和识别各种与物品栏和物品操作相关的作弊行为，包括物品复制、物品修改、快速操作等。该模块通过分析玩家的物品栏操作模式、物品属性变化、物品数量异常等数据，来检测各种库存作弊。

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

📦 InventoryMove (物品栏移动检测)

功能描述

检测玩家是否使用物品栏移动作弊，能够以异常的速度或方式移动、整理或操作物品栏中的物品。

检测原理

分析物品栏操作的频率和速度
监测物品移动的模式和规律性
比较预期的操作时间与实际操作时间
检测异常的物品栏操作序列
分析物品栏状态变化的一致性

配置参数详解

yaml

inventory:
  inventorymove:
    # 是否启用物品栏移动检测
    enabled: true
    
    # 检测阈值（0-1之间）
    threshold: 0.6
    
    # 违规积累速度
    violation-rate: 1.0
    
    # 最大违规次数
    max-violations: 15
    
    # 重置违规计数的时间间隔（秒）
    violation-reset-time: 300
    
    # 允许的最大物品移动速度（物品/秒）
    max-item-move-rate: 20.0
    
    # 最小预期操作时间（毫秒）
    min-operation-time: 30
    
    # 物品栏移动检测的惩罚类型
    punishment: warning
    
    # 异步检测开关
    async: false
    
    # 调试模式开关
    debug: false
    
    # 玩家权限绕过检测
    bypass-permission: 鍏夎氨Spectrum.bypass.inventorymove

惩罚设置

物品栏移动检测支持的惩罚类型：

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

常见误报原因及解决方案

误报原因	解决方案
玩家熟练的物品栏操作	增加`threshold`值，或调整`max-item-move-rate`值
物品栏管理插件	在`compatibility.yml`中添加兼容设置
服务器延迟导致的操作同步问题	启用`latency-compensation`

🔄 ItemDupe (物品复制检测)

功能描述

检测玩家是否使用物品复制作弊，能够复制物品或增加物品数量。

检测原理

分析物品数量的异常变化
监测物品创建和销毁的模式
比较预期的物品流动与实际物品流动
检测异常的物品ID和数据值组合
分析物品复制的时间和位置模式

配置参数详解

yaml

inventory:
  itemdupe:
    # 是否启用物品复制检测
    enabled: true
    
    # 检测阈值（0-1之间）
    threshold: 0.7
    
    # 违规积累速度
    violation-rate: 1.0
    
    # 最大违规次数
    max-violations: 5
    
    # 重置违规计数的时间间隔（秒）
    violation-reset-time: 300
    
    # 物品数量变化阈值
    quantity-change-threshold: 5
    
    # 检测物品ID重复
    detect-id-duplication: true
    
    # 物品复制检测的惩罚类型
    punishment: ban
    
    # 异步检测开关
    async: true
    
    # 调试模式开关
    debug: false
    
    # 玩家权限绕过检测
    bypass-permission: 鍏夎氨Spectrum.bypass.itemdupe

惩罚设置

物品复制检测支持的惩罚类型：

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

常见误报原因及解决方案

误报原因	解决方案
物品合成或分解	在`compatibility.yml`中添加兼容设置
服务器延迟导致的物品同步问题	启用`latency-compensation`
特殊游戏机制（如末影箱）	调整`quantity-change-threshold`值

🔧 ItemMod (物品修改检测)

功能描述

检测玩家是否使用物品修改作弊，能够修改物品的属性、附魔、名称等。

检测原理

分析物品属性的异常变化
监测物品附魔和NBT标签的合法性
比较预期的物品属性与实际物品属性
检测异常的物品创建和使用
分析物品修改的时间和位置模式

配置参数详解

yaml

inventory:
  itemmod:
    # 是否启用物品修改检测
    enabled: true
    
    # 检测阈值（0-1之间）
    threshold: 0.7
    
    # 违规积累速度
    violation-rate: 1.0
    
    # 最大违规次数
    max-violations: 5
    
    # 重置违规计数的时间间隔（秒）
    violation-reset-time: 300
    
    # 检测非法附魔
    detect-illegal-enchants: true
    
    # 检测非法物品名称
    detect-illegal-names: true
    
    # 检测过大数据值
    detect-excessive-data: true
    
    # 物品修改检测的惩罚类型
    punishment: ban
    
    # 异步检测开关
    async: true
    
    # 调试模式开关
    debug: false
    
    # 玩家权限绕过检测
    bypass-permission: 鍏夎氨Spectrum.bypass.itemmod

惩罚设置

物品修改检测支持的惩罚类型：

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

常见误报原因及解决方案

误报原因	解决方案
自定义物品插件	在`compatibility.yml`中添加兼容设置
服务器版本差异导致的物品数据变化	在`compatibility.yml`中添加版本兼容设置
特殊活动物品	使用`/鍏夎氨Spectrum whitelist additem <item>`命令添加白名单

🖱️ FastClick (快速点击检测)

功能描述

检测玩家是否使用快速点击作弊，能够以异常高的频率点击物品栏中的物品。

检测原理

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

配置参数详解

yaml

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

惩罚设置

快速点击检测支持的惩罚类型：

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

常见误报原因及解决方案

误报原因	解决方案
高性能鼠标	增加`max-click-rate`值
玩家快速点击技巧	调整`min-click-interval-std`值
物品栏管理插件	在`compatibility.yml`中添加兼容设置

🔄 AutoRefill (自动填充检测)

功能描述

检测玩家是否使用自动填充作弊，能够自动从物品栏中补充消耗的物品。

检测原理

分析物品消耗和补充的时机
监测物品栏状态的变化模式
比较预期的物品补充时间与实际时间
检测异常的物品栏操作速度
分析物品消耗与补充的同步性

配置参数详解

yaml

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

惩罚设置

自动填充检测支持的惩罚类型：

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

常见误报原因及解决方案

误报原因	解决方案
玩家熟练的物品栏操作	增加`threshold`值，或调整`min-refill-time`值
物品栏管理插件	在`compatibility.yml`中添加兼容设置
服务器延迟导致的物品同步问题	启用`latency-compensation`

🚫 CheatItems (作弊物品检测)

功能描述

检测玩家是否持有或使用具有作弊属性的物品，如飞行药水、无限物品、自定义物品等。

检测原理

分析物品的属性和NBT标签
监测物品的使用效果和行为
比较预期的物品属性与实际物品属性
检测非法的物品ID和数据值组合
分析物品来源和使用模式

配置参数详解

yaml

inventory:
  cheatitems:
    # 是否启用作弊物品检测
    enabled: true
    
    # 检测阈值（0-1之间）
    threshold: 0.7
    
    # 违规积累速度
    violation-rate: 1.0
    
    # 最大违规次数
    max-violations: 5
    
    # 重置违规计数的时间间隔（秒）
    violation-reset-time: 300
    
    # 检测飞行药水
    detect-fly-potions: true
    
    # 检测非法附魔
    detect-illegal-enchants: true
    
    # 检测自定义物品
    detect-custom-items: true
    
    # 作弊物品检测的惩罚类型
    punishment: kick
    
    # 异步检测开关
    async: true
    
    # 调试模式开关
    debug: false
    
    # 玩家权限绕过检测
    bypass-permission: 鍏夎氨Spectrum.bypass.cheatitems

惩罚设置

作弊物品检测支持的惩罚类型：

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

常见误报原因及解决方案

误报原因	解决方案
服务器自定义物品	在`compatibility.yml`中添加兼容设置
特殊活动物品	使用`/鍏夎氨Spectrum whitelist additem <item>`命令添加白名单
物品数据版本差异	在`compatibility.yml`中添加版本兼容设置

📝 配置示例

以下是库存检测模块的推荐配置示例：

yaml

inventory:
  # 物品栏移动检测
  inventorymove:
    enabled: true
    threshold: 0.6
    max-item-move-rate: 20.0
    punishment: warning
    
  # 物品复制检测
  itemdupe:
    enabled: true
    threshold: 0.7
    quantity-change-threshold: 5
    punishment: ban
    
  # 物品修改检测
  itemmod:
    enabled: true
    threshold: 0.7
    detect-illegal-enchants: true
    detect-illegal-names: true
    punishment: ban
    
  # 快速点击检测
  fastclick:
    enabled: true
    threshold: 0.6
    max-click-rate: 20.0
    punishment: warning
    
  # 自动填充检测
  autorefill:
    enabled: true
    threshold: 0.6
    min-refill-time: 50
    punishment: warning
    
  # 作弊物品检测
  cheatitems:
    enabled: true
    threshold: 0.7
    detect-fly-potions: true
    detect-illegal-enchants: true
    punishment: kick

❓ 常见问题

如何减少库存检测的误报？

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

如何优化库存检测的性能？

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

如何应对新型库存作弊？

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

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

库存检测模块详细文档 ​

📋 目录 ​

🔍 模块概述 ​

📦 InventoryMove (物品栏移动检测) ​

功能描述 ​

检测原理 ​

配置参数详解 ​

惩罚设置 ​

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

🔄 ItemDupe (物品复制检测) ​

功能描述 ​

检测原理 ​

配置参数详解 ​

惩罚设置 ​

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

🔧 ItemMod (物品修改检测) ​

功能描述 ​

检测原理 ​

配置参数详解 ​

惩罚设置 ​

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

🖱️ FastClick (快速点击检测) ​

功能描述 ​

检测原理 ​

配置参数详解 ​

惩罚设置 ​

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

🔄 AutoRefill (自动填充检测) ​

功能描述 ​

检测原理 ​

配置参数详解 ​

惩罚设置 ​

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

🚫 CheatItems (作弊物品检测) ​

功能描述 ​

检测原理 ​

配置参数详解 ​

惩罚设置 ​

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

📝 配置示例 ​

❓ 常见问题 ​

如何减少库存检测的误报？ ​

如何优化库存检测的性能？ ​

如何应对新型库存作弊？ ​

库存检测模块详细文档

📋 目录

🔍 模块概述

📦 InventoryMove (物品栏移动检测)

功能描述

检测原理

配置参数详解

惩罚设置

常见误报原因及解决方案

🔄 ItemDupe (物品复制检测)

功能描述

检测原理

配置参数详解

惩罚设置

常见误报原因及解决方案

🔧 ItemMod (物品修改检测)

功能描述

检测原理

配置参数详解

惩罚设置

常见误报原因及解决方案

🖱️ FastClick (快速点击检测)

功能描述

检测原理

配置参数详解

惩罚设置

常见误报原因及解决方案

🔄 AutoRefill (自动填充检测)

功能描述

检测原理

配置参数详解

惩罚设置

常见误报原因及解决方案

🚫 CheatItems (作弊物品检测)

功能描述

检测原理

配置参数详解

惩罚设置

常见误报原因及解决方案

📝 配置示例

❓ 常见问题

如何减少库存检测的误报？

如何优化库存检测的性能？

如何应对新型库存作弊？