> For the complete documentation index, see [llms.txt](https://spiter.gitbook.io/spiter/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://spiter.gitbook.io/spiter/spiter-8.0/pei-zhi-wen-jian-jiao-cheng.md).

# 配置文件教程

> 仅覆盖 **`message.yml`** 与 **`config.yml`** 两个文件
>
>  颜色代码沿用 Minecraft `&` 转义（如 `&a` 绿、`&c` 红、`&b` 青、`&7` 灰、`&e` 黄、`&l` 粗体、`&n` 下划线、`&8` 深灰）。

***

### 〇、配置文件总览

| 文件               | 作用               |
| ---------------- | ---------------- |
| `config.yml`     | 反作弊主配置           |
| `message.yml`    | 全部玩家/控制台可见文案与占位符 |
| `punishment.yml` | 处罚规则             |
| `loader.yml`     | 许可证/云配置          |

* **热重载命令**：`/spiter reload`
* 修改任意配置后建议重载；插件发现缺失键会用默认值补写

### 颜色代码说明（Minecraft `&` 转义）

配置文件（尤其 message.yml）中的文本沿用 Minecraft 颜色代码，以 `&` 开头，常用对照如下：

| 代码   | 颜色 / 样式 | 代码   | 颜色 / 样式         |
| ---- | ------- | ---- | --------------- |
| `&0` | 黑色      | `&a` | 绿色（亮）           |
| `&1` | 深蓝      | `&b` | 青色（亮）           |
| `&2` | 深绿      | `&c` | 红色（亮）           |
| `&3` | 青色      | `&d` | 粉色              |
| `&4` | 深红      | `&e` | 黄色（亮）           |
| `&5` | 紫色      | `&f` | 白色              |
| `&6` | 金色 / 橙  | `&l` | 粗体              |
| `&7` | 灰色      | `&n` | 下划线             |
| `&8` | 深灰      | `&o` | 斜体              |
| `&9` | 蓝色      | `&m` | 删除线             |
|      |         | `&r` | 重置（清除前面所有颜色/样式） |

教程中出现的 `&7`、`&b`、`&c`、`&e`、`&a`、`&n`、`&l`、`&8` 等均按上表含义理解。

### 通用占位符（可在 message.yml 中使用）

| 占位符           | 含义                | 占位符            | 含义    |
| ------------- | ----------------- | -------------- | ----- |
| `%prefix%`    | 消息前缀（来自 `prefix`） | `%player%`     | 触发玩家名 |
| `%vl%`        | 违规等级（VL）          | `%alertsName%` | 警报检测名 |
| `%checkName%` | 检测名               | `%component%`  | 检测组件名 |
| `%brand%`     | 客户端品牌             | `%version%`    | 客户端版本 |
| `%label%`     | 命令标签              | `%args%`       | 命令参数  |
| `%anticheat%` | 反作弊名              | `%id%`         | 惩罚 ID |

***

### 一、`config.yml` 逐项详解

#### 1. `admin`

* 默认 `['INPUT_ADMIN_NAME_HERE_!']`
* **作用**：反作弊管理员（Staff）玩家名白名单。拥有该名单中的游戏名，才能执行 `/spiter` 管理命令、接收警报
* **取值范围**：任意在线玩家名（区分大小写，按 `getName()` 匹配）；可填多个。
* **使用场景**：把你信任的管理员 ID 放进这里，他们即可使用 alerts/spec/forceban 等指令；若保留默认占位串，则无人拥有管理权限。

### 2. settings.command

默认: spiter\
作用：反作弊主命令名（即 `/<command>` 中的命令词）。\
取值范围：任意合法命令字符串，不含空格；建议保持 spiter。\
使用场景：修改插件主指令，避免与其它插件冲突；旧版别名为 `ac`。 旧版对应：oldconfig `Command.Spiter.commands`（旧值为 \[ac]）/ `Command.Spiter.Name` 。\
当前值: spiter

### 3. settings.vl-cache-expired-minutes

默认: 30\
作用：玩家 VL（违规值）缓存的过期时间（分钟），超过后缓存被清理。\
取值范围：正整数，单位分钟；0 表示不缓存。\
使用场景：控制内存中玩家违规记录的保留时长；数值越大越占内存但跨服/重连识别更连续。\
旧版对应：oldconfig `Database.Setting.Synchronised_Vl.Timer (s): 300`（旧按秒，约 5 分钟）。\
当前值: 30

### 4. settings.exempt-time-on-join

默认: 5000\
作用：玩家刚进服的豁免时间（毫秒），期间不进行检测，避免登录瞬间误判。\
取值范围：非负整数，单位毫秒；0 表示不豁免。\
使用场景：防止玩家登录加载卡顿导致误报；调大可减少对高延迟玩家的误判。\
旧版对应：oldconfig `AlertsManager.JoinBypass: 3000`（旧为 3000 毫秒）。\
当前值: 5000

### 5. settings.enable-alerts-on-join

默认: true\
作用：管理员登录时是否自动开启警报（alerts）。\
取值范围：true / false。\
使用场景：设为 true，管理员一上线就自动接收作弊警报；设为 false 需手动 /alerts 开启。\
旧版对应：oldconfig `AlertsManager.join-on: true`。 当前值: true

### 6. settings.print-logs-to-console

默认: true\
作用：是否把反作弊日志打印到服务器控制台。\
取值范围：true / false。\
使用场景：调试或日常巡查时设为 true；日志量大想减轻控制台噪音可设 false。\
旧版对应：oldconfig `System.AlertsManager-Logs-In-Console: false`。 当前值: true

### 7. settings.player\_bypass\_enable

默认: false\
作用：是否启用「玩家绕过（bypass）」机制（允许特定玩家豁免检测）。\
取值范围：true / false。\
使用场景：测试服或给信任玩家临时豁免时开启；正式服一般保持 false 避免作弊者利用。\
旧版对应：oldconfig `Setting.Check-bypass: true`。 当前值: false

### 8. settings.allow-modern-client-blocking-on\_1\_8

默认: true\
作用：在 1.8 服务端上是否允许现代（高版本）客户端进行格挡（blocking）相关判定。\
取值范围：true / false。\
使用场景：是否取消高版本的客户端去进行格挡\
旧版对应：oldconfig `Check.Autoblock.cancel.highversion_autoblock: false`。 当前值: true

### 9. settings.use-cloud-vl-for-machine-learning

默认: true\
作用：是否将 VL 数据上传云端用于机器学习模型辅助判定。\
取值范围：true / false。\
使用场景：开启可提升启发式/AI 检测准确率（需联网）

旧版对应：oldconfig `prevent_ai_check.using_cloud_vl: true`。 当前值: true

### 10. settings.vl-reset-seconds

默认: 410\
作用：VL 自动重置时间（秒），超时无新违规则清零。\
取值范围：正整数，单位秒。\
使用场景：控制玩家违规值多久归零；数值过小会导致频繁重置、检测变松。\
旧版对应：oldconfig `AlertsManager.vlreset-time (s): 410`。 当前值: 410

### 11. settings.hide-spiter

默认: true\
作用：是否对玩家隐藏插件自身存在\
取值范围：true / false。\
使用场景：设为 true 防止玩家通过插件列表发现用了 Spiter；配合 `misc.blacklist-brands` 进一步隐蔽。\
当前值: true

### 12. settings.exempt-elytra

默认: false\
作用：是否对使用鞘翅（elytra）飞行的玩家豁免移动类检测。\
取值范围：true / false。

### 13. settings.check-scaffold-when-flying

默认: false\
作用：玩家处于飞行状态（ Creative 飞行 / 管理员飞行）时是否仍检测 scaffold（搭路）。\
取值范围：true / false。<br>

### 14跳过<br>

### 15. settings.enable-events

默认: true\
作用：是否启用插件内部事件钩子（供其它插件/扩展监听反作弊事件）。\
取值范围：true / false。\
使用场景：需要第三方插件对接 Spiter 事件时保持 true；无外部依赖可设 false 轻微降耗。<br>

### 16. check.negative-timer.enable

默认: true\
作用：是否启用「负计时器（negative timer / 加速）」检测。\
取值范围：true / false。

### 17. check.negative-timer.tick

默认: 40\
作用：负计时器检测的判定周期（tick），超过该周期偏差即记违规。\
取值范围：正整数（tick）；数值越大越宽松。<br>

### 18. check.negative-timer.exempt-tick

默认: 5\
作用：负计时器检测的豁免 tick 数（起判前的缓冲）。\
取值范围：非负整数。<br>

### 19. check.max-reach-distance

默认: 3.0\
作用：攻击距离上限（方块单位），超过即判定 reach（超距攻击）。\
旧版对应：oldconfig `checks.yml` 的 `Reach (A).module.reach.number: 3.0`。 当前值: 3.0

### 20. check.hitbox

默认: true\
作用：是否启用 hitbox（碰撞箱）检测，判定攻击是否命中合理碰撞箱。\
取值范围：true / false。<br>

### 21. check.invalid-a.ticks

默认: 20\
取值范围：正整数；数值越大越宽松。\
使用场景：检测非法移动/卡墙类作弊；旧版更严（5 tick），新版放宽到 20 降低误判。<br>

### 22. check.invalid-a.air-ticks

默认: 20\
取值范围：正整数。\
使用场景：同上，针对空中状态的异常判定；与 ticks 配合调参。<br>

### 23. check.invalid-a.setback

默认: true\
作用：invalid-a 触发时是否回弹（setback）玩家位置。\
取值范围：true / false。\
使用场景：开启可立即纠正异常位置、阻止利用；关闭则只记录不回弹。\
旧版对应：oldconfig `advanced.yml` 的 `move.invalid.stuck_setback: true`。 当前值: true

### 24. mitigation.reach.enable

默认: true\
作用：是否启用 reach 缓解（mitigation）——对可疑超距攻击做平滑处理而非直接处罚。\
取值范围：true / false。<br>

### 25. mitigation.hit-delay.enable

默认: true\
作用：是否启用攻击间隔（hit-delay）缓解。\
取值范围：true / false。<br>

### 26. mitigation.hit-delay.except

默认: 35\
作用：命中间隔缓解的例外阈值（毫秒），低于该间隔才触发缓解逻辑。\
取值范围：非负整数（毫秒）。<br>

### 27. mitigation-reduce-damage.enable

默认: true\
作用：是否启用「减伤缓解」——对异常低伤害做纠正（防止伤害减免类作弊）。\
取值范围：true / false。<br>

### 28. mitigation-reduce-damage.ignore-deathline

默认: true\
作用：减伤缓解是否忽略「死亡线」（即濒死时的伤害修正）。\
取值范围：true / false。

### 29. mitigation-reduce-damage.default-multiplier

默认: 0.85\
作用：减伤缓解的默认伤害乘数（正常情况施加的伤害系数）。\
取值范围：0.0\~1.0 浮点数；越小伤害越低。\
使用场景：控制缓解后的伤害基线，平衡外挂纠正与正常手感。\
旧版对应：oldconfig `reducedamage.prevent_tolerance_Stage_reducedamage`（分档，Level\_1=0.8 等）。\
当前值: 0.85

### 30. mitigation-reduce-damage.minimal-multiplier

默认: 0.3\
作用：减伤缓解的最低伤害乘数下限。\
取值范围：0.0\~1.0 浮点数；不能大于 default-multiplier。\
使用场景：限制伤害被压到的最低程度，避免把正常攻击也削到过低。\
旧版对应：oldconfig `reducedamage` 分档中的最低档（Level\_5=0.15）。\
当前值: 0.3

### 31. mitigation-extra-velocity-multiplier.x

默认: 1.3\
作用：额外击退速度乘数的 X 轴分量（纠正异常击退）。\
取值范围：正数浮点。\
使用场景：检测/纠正击退修改类作弊；与 y、z 一起调。\
旧版对应：oldconfig `advanced.yml` 的 `Cancel.move.morevelcoty.custom.x`（旧 0.45）或 `magnification.x`（旧 1.5）。\
当前值: 1.3

### 32. mitigation-extra-velocity-multiplier.y

默认: 1.0\
作用：额外击退速度乘数的 Y 轴分量。\
取值范围：正数浮点。\
使用场景：同上，竖向击退修正。\
旧版对应：oldconfig `advanced.yml` 的 `Cancel.move.morevelcoty.custom.y`（旧 0.3）/ `magnification.y`（旧 1.0）。\
当前值: 1.0

### 33. mitigation-extra-velocity-multiplier.z

默认: 1.3\
作用：额外击退速度乘数的 Z 轴分量。\
取值范围：正数浮点。\
使用场景：同上，前后击退修正。\
旧版对应：oldconfig `advanced.yml` 的 `Cancel.move.morevelcoty.custom.z`（旧 0.45）/ `magnification.z`（旧 1.5）。\
当前值: 1.3

### 34. spoof.health

默认: true\
作用：是否对客户端的血量显示做「欺骗（spoof）」，使外挂无法读取真实血量。\
取值范围：true / false。\
使用场景：防止外挂读取血量做精准击杀/自瞄；正常服保持 true。\
旧版对应：oldconfig `advanced.yml` 的 `filters.Health: true`。 当前值: true

### 35. spoof.team

默认: true\
作用：是否对客户端的队伍（team）信息做欺骗，防止外挂通过队伍关系判断敌我。\
取值范围：true / false。\
使用场景：保护队友信息不外泄给外挂；旧版默认 false，新版默认 true 更安全。\
旧版对应：oldconfig `advanced.yml` 的 `filters.Team: false`（旧为 false）。\
当前值: true

### 36. spoof.equipment

默认: true\
作用：是否对装备数据做欺骗，防止外挂读取玩家装备。\
取值范围：true / false。\
使用场景：防止外挂根据装备判断目标价值；正常服保持 true。\
旧版对应：oldconfig `advanced.yml` 的 `filters.Equipment-Data: true`。 当前值: true

### 37. spoof.attack.enable

默认: true\
作用：是否对攻击相关包做欺骗（隐藏真实攻击目标信息）。\
取值范围：true / false。\
使用场景：防止 killaura 类外挂获取准确攻击反馈；正常服保持 true。\
旧版对应：oldconfig `advanced.yml` 的 `filters.Attack.enable: true`。 当前值: true

### 38. spoof.attack.player-only

默认: true\
作用：攻击欺骗是否仅对玩家实体生效（不影响怪物/生物）。\
取值范围：true / false。\
使用场景：开启可避免误伤正常打怪逻辑；关闭则对所有实体做欺骗。\
旧版对应：oldconfig `advanced.yml` 的 `filters.Attack.only_player: true`。 当前值: true

### 39. prevent.phase.enable

默认: true\
作用：是否启用穿墙（phase）拦截——阻止玩家穿墙移动。\
取值范围：true / false。\
使用场景：检测利用穿墙模组卡进墙体的行为；正常服保持 true。\
旧版对应：oldconfig `advanced.yml` 的 `prevent_phase: true`。 当前值: true

### 40. prevent.phase.strict

默认: false\
作用：穿墙拦截是否启用严格模式（更激进的判定）。\
取值范围：true / false。\
使用场景：误判多时设 false；作弊严重时设 true 加强拦截（可能增加误杀）。\
旧版对应：oldconfig `advanced.yml` 的 `prevent_phase_severe: false`。 当前值: false

### 41. prevent.phase.mode

默认: v1\
作用：穿墙拦截的算法模式（v1 / v2/v3)\
取值范围：字符串，当前为 v1。\
旧版对应：无直接对应（新版新增）。\
当前值: v1

### 42. prevent.spider

默认: true\
作用：是否拦截「蜘蛛爬墙（spider）」——沿墙垂直攀爬的非法移动。\
取值范围：true / false。\
使用场景：检测利用爬墙模组上墙；正常服保持 true。\
旧版对应：oldconfig `advanced.yml` 的 `prevent_spider: true`。 当前值: true

### 43. prevent.no-slowdown.enable

默认: true\
作用：是否启用「防减速失效（no-slowdown）」拦截——阻止边吃食物/拉弓边全速移动。\
取值范围：true / false。\
使用场景：检测利用延迟或漏洞抵消缓慢效果的外挂；正常服保持 true。\
旧版对应：oldconfig `advanced.yml` 的 `prevent_no_slowdown.enable: true`。 当前值: true

### 44. prevent.no-slowdown.reset-vanilla-use

默认: true\
作用：no-slowdown 检测中是否重置原版使用状态（进食/拉弓）以校正判定。\
取值范围：true / false。\
使用场景：开启可更准确识别真正的减速失效；关闭可能漏检但更稳。\
旧版对应：oldconfig `advanced.yml` 的 `prevent_no_slowdown.reset_vanilla_use?`（同族 cancel\_\* 项）。\
当前值: true

### 45. prevent.no-slowdown.allow-vanilla-glitch

默认: false\
作用：是否允许原版已知的减速小漏洞（不视为作弊）。\
取值范围：true / false。\
使用场景：设为 false 把原版小漏洞也纠正（更严格）；设为 true 容忍原版行为。\
旧版对应：oldconfig `advanced.yml` 的 `prevent_no_slowdown.cancel_discard_feeding_status_reset` 等（反向）。\
当前值: false

### 46. prevent.no-slowdown.strict-mode.enable

默认: true\
作用：no-slowdown 严格模式是否启用（更激进判定）。\
取值范围：true / false。\
使用场景：作弊严重时开启；误判多时关闭。\
旧版对应：oldconfig `advanced.yml` 的 `prevent_no_slowdown.strict_mode: false`。 当前值: true

### 47. prevent.no-slowdown.strict-mode.reset-item-use

默认: true\
作用：严格模式下是否重置物品使用状态以辅助判定。\
取值范围：true / false。\
使用场景：配合严格模式更准确识别减速失效；关闭则更宽松。\
旧版对应：oldconfig `advanced.yml` 的 `prevent_no_slowdown.strict_mode_fix: true`。 当前值: true

### 48. prevent.blink.enable

默认: true\
作用：是否拦截blink\
取值范围：true / false。\
旧版对应：oldconfig `advanced.yml` 的 `prevent_blink.enable: true`。 当前值: true

### 49

### 50. prevent.blink.fix\_blink

默认: true\
作用：是否启用 blink 修正\
取值范围：true / false。\
使用场景：开启可主动纠正闪烁玩家而不只记录；正常服保持 true。\
旧版对应：无直接对应（新版新增）。\
当前值: true

### 51. prevent.blink.fix\_lag

默认: true\
作用：是否在服务器卡顿时对 blink 做额外修正（防延迟误判）。\
取值范围：true / false。\
当前值: true

### 52. prevent.sprint-abuse

默认: true\
作用：是否拦截冲刺滥用（sprint-abuse）——非法维持冲刺状态。\
取值范围：true / false。\
使用场景：检测利用漏洞无限冲刺；正常服保持 true。\
旧版对应：oldconfig `advanced.yml` 的 `prevent_jumpreset_cancel`（同族，部分相关）。\
当前值: true

### 53. prevent.backtrack.enable

默认: true\
作用：是否拦截回溯（backtrack）——外挂回退自身位置躲避攻击。\
取值范围：true / false。\
使用场景：检测 killaura 常用的位置回溯；正常服保持 true。\
旧版对应：oldconfig `advanced.yml` 的 `detect_and_prevent_backtrack: true`。 当前值: true

### 54. prevent.illegal-blocking

默认: true\
作用：是否拦截非法格挡（illegal-blocking）——不合法的开盾/格挡行为。\
取值范围：true / false。\
使用场景：检测修改格挡逻辑的外挂；正常服保持 true。\
旧版对应：oldconfig `Check.Autoblock.cancel.Illegal_Block: true`。 当前值: true

### 55. prevent.jump-reset-abuse

默认: true\
作用：是否拦截跳跃重置滥用（jump-reset-abuse）——借跳跃重置取消击退。\
取值范围：true / false。\
使用场景：检测利用跳跃取消击退的外挂；正常服保持 true。\
旧版对应：oldconfig `advanced.yml` 的 `prevent_jumpreset_cancel: true`。 当前值: true

### 56. tolerance.movement

默认: balanced\
作用：移动检测的容差档位（宽松度）。\
取值范围：severe / moderate / balanced / permissive / lenient / disabled（严格→禁用）。\
使用场景：高延迟服选 permissive/lenient 减少误判；硬核服选 severe/moderate。新版默认 balanced，旧版默认 Moderate。\
旧版对应：oldconfig `advanced.yml` 的 `movement_tolerance: Moderate`（旧为 Moderate）。\
当前值: balanced

### 57. tolerance.ghostblock

默认: balanced\
作用：幽灵块（ghostblock）检测的容差档位。\
取值范围：severe / moderate / balanced / permissive / lenient / disabled。\
使用场景：同 movement，控制 ghostblock 检测严格度。\
旧版对应：oldconfig `advanced.yml` 的 `Ghost_BlockFly: Balanced`。 当前值: balanced

### 58. tolerance.backtrack-cancel

默认: balanced\
作用：回溯取消检测的容差档位。\
取值范围：severe / moderate / balanced / permissive / lenient / disabled。\
使用场景：控制 backtrack 取消判定的严格度。旧版为 Severe。\
旧版对应：oldconfig `advanced.yml` 的 `prevent_backtrack_cancel: Severe`（旧为 Severe）。\
当前值: balanced

### 59. tolerance.baritone

默认: balanced\
作用：Baritone（自动走位外挂）检测的容差档位。\
取值范围：severe / moderate / balanced / permissive / lenient / disabled。\
使用场景：控制 Baritone 类自动寻路检测严格度。\
旧版对应：oldconfig `advanced.yml` 的 `prevent_baritone_cancel: Balanced`。 当前值: balanced

### 60. tolerance.noslow

默认: balanced\
作用：no-slowdown 检测的容差档位。\
取值范围：severe / moderate / balanced / permissive / lenient / disabled。\
使用场景：控制减速失效检测严格度。旧版 advanced 中 level 为 Balanced。\
旧版对应：oldconfig `advanced.yml` 的 `prevent_no_slowdown.level: Balanced`。 当前值: balanced

### 61. autoclicker-check.enable

默认: true\
作用：是否启用自动点击（autoclicker）检测。\
取值范围：true / false。\
使用场景：检测连点器/宏；正常服保持 true。\
旧版对应：oldconfig `Check.cps.*` / `advanced.yml` 的 `click.enable: true`。 当前值: true

### 62. autoclicker-check.cps-limit.left-click.enable

默认: true\
作用：是否对左键（攻击/破坏）启用 CPS 上限检测。\
取值范围：true / false。\
使用场景：控制左键连点检测开关；关闭则只检测右键或不检测左键。\
旧版对应：oldconfig `Check.cps.left_bypass` / `advanced.yml` 的 `click.left_bypass`（旧为 true 即绕过）。\
当前值: true

### 63. autoclicker-check.cps-limit.left-click.max-cps

默认: 25\
作用：左键每秒最大点击数（CPS）上限，超过即判定自动点击。\
取值范围：正整数；\
旧版对应：oldconfig `Check.cps.left_limit: 25` / `advanced.yml` 的 `click.left_limit: 27`。 当前值: 25

### 64. autoclicker-check.cps-limit.right-click.enable

默认: true\
作用：是否对右键（使用/放置）启用 CPS 上限检测。\
取值范围：true / false。\
使用场景：控制右键连点检测开关。\
旧版对应：oldconfig `Check.cps.right_bypass` / `advanced.yml` 的 `click.right_bypass`（旧为 true 即绕过）。\
当前值: true

### 65. autoclicker-check.cps-limit.right-click.max-cps

默认: 30\
作用：右键每秒最大点击数（CPS）上限。\
取值范围：正整数；常见 15\~40。\
使用场景：右键连点（如快速喝药/放置）检测；比左键略宽松。\
旧版对应：oldconfig `Check.cps.right_limit: 40` / `advanced.yml` 的 `click.right_limit: 80`。 当前值: 30

### 66. transaction.kick-when-exception

默认: true\
作用：Transaction（交易/窗口）包出现异常时是否踢出玩家。\
取值范围：true / false。\
使用场景：防止利用异常 transaction 包崩溃或作弊；正常服保持 true。\
旧版对应：oldconfig `advanced.yml` 的 `servercrash.handle_Transaction_error: true`。 当前值: true

### 67. transaction.obfuscate-id

默认: false\
作用：是否对 transaction ID 做混淆（防止外挂读取真实 ID）。\
取值范围：true / false。\
使用场景：开启可增加外挂读取窗口状态的难度；旧版默认 true，新版默认 false。\
旧版对应：oldconfig `advanced.yml` 的 `Transaction_id_Obf: true`（旧为 true）。\
当前值: false

### 68. transaction.max-tolerate-delay

默认: 25\
作用：transaction 包容忍的最大延迟（tick），超出即判定异常。\
取值范围：正整数（tick）。\
旧版对应：oldconfig `advanced.yml` 的 `unstable_connection_limit: 18`。 当前值: 25

### 69. transaction.max-waiting

默认: 450\
作用：transaction 最大等待时间（tick），超时未确认即处理。\
取值范围：正整数（tick）。\
旧版对应：oldconfig `advanced.yml` 的 `connection_queue_limit: 220`。 当前值: 450

### 70. setback.movement.enable

默认: true\
作用：移动类违规是否执行回弹（setback）。\
取值范围：true / false。\
使用场景：开启可立即把异常移动玩家拉回合法位置；关闭则只记录。\
旧版对应：oldconfig `advanced.yml` 的 `move_setback.enable: true`。 当前值: true

### 71. setback.movement.setback-threshold

默认: -1\
作用：触发回弹的 VL 阈值；-1 表示每次违规都回弹。\
取值范围：整数；-1 为总是回弹，正数表示累计到该 VL 才回弹。\
使用场景：-1 最严格；设正数可减少回弹频率、降低卡顿感。\
旧版对应：oldconfig `advanced.yml` 的 `move_setback.vl: -1`。 当前值: -1

### 72. setback.movement.reset-threshold-after-setback

默认: true\
作用：回弹后是否重置 VL 阈值计数。\
取值范围：true / false。\
使用场景：开启避免回弹后立刻再次触发；正常服保持 true。\
旧版对应：oldconfig `advanced.yml` 的 `move_setback.vl_enable: false`（反向相关）。\
当前值: true

### 73. setback.movement.force-when-flag

默认: false\
作用：标记（flag）时是否强制回弹（忽略其它条件）。\
取值范围：true / false。\
使用场景：设为 true 每次标记都强制拉回（更硬核）；false 则按阈值/条件。\
旧版对应：oldconfig `advanced.yml` 的 `force_move_setback_on_alerts: false`。 当前值: false

### 74. setback.ghostblock

默认: true\
作用：幽灵块违规是否回弹。\
取值范围：true / false。\
使用场景：开启可纠正 ghostblock 异常位置；正常服保持 true。\
旧版对应：oldconfig `advanced.yml` 的 `Ghostblocksetback` / `Ghostblockcheck.Ghostblocksetback: true`。 当前值: true

### 75. setback.velocity

默认: true\
作用：速度（击退）类违规是否回弹。\
取值范围：true / false。\
使用场景：纠正异常击退/速度修改；正常服保持 true。\
旧版对应：oldconfig `advanced.yml` 的 `velocity_setback: true`。 当前值: true

### 76. setback.optimize.enable

默认: true\
作用：是否启用回弹优化（合并/降频回弹以减少卡顿）。\
取值范围：true / false。\
使用场景：高负载服保持 true 可显著降低回弹带来的延迟抖动。\
旧版对应：oldconfig `advanced.yml` 的 `optimize_network_move.enable: true`。 当前值: true

### 77. setback.optimize.ticks

默认: 10\
作用：回弹优化的处理周期（tick）。\
取值范围：正整数（tick）。\
使用场景：控制回弹批处理间隔；数值越小越及时、越大越省性能。\
旧版对应：oldconfig `advanced.yml` 的 `optimize_network_move.tick: 10`。 当前值: 10

### 78. anti-crasher.tabcomplete.max-size

默认: 256\
作用：Tab 补全返回条目的最大数量，超出拒绝以防止崩溃。\
取值范围：正整数。\
使用场景：限制恶意 Tab 补全导致的服务端崩溃/卡死；正常保持 256。\
旧版对应：oldconfig `advanced.yml` 的 `servercrash.max_tab_complete_size: 256`。 当前值: 256

### 79. anti-crasher.tabcomplete.max-text-length

默认: 64\
作用：Tab 补全文本的最大长度，超出拒绝。\
取值范围：正整数。\
使用场景：防止超长补全文本造成处理异常；正常保持 64。\
旧版对应：oldconfig `advanced.yml` 的 `servercrash.max_tab_complete_text_length: 64`。 当前值: 64

### 80. anti-crasher.check-invalid-position

默认: true\
作用：是否检查非法坐标（如 NaN/极端坐标）以防止崩溃。\
取值范围：true / false。\
使用场景：拦截发送非法位置的崩溃包；正常服保持 true。\
旧版对应：oldconfig `advanced.yml` 的 `servercrash.invalid_move_c`（同族）。\
当前值: true

### 81. anti-crasher.check-large-movement

默认: true\
作用：是否检查超大位移（瞬间长距离移动）以防止崩溃/瞬移。\
取值范围：true / false。\
使用场景：拦截利用大位移包崩溃服务端或瞬移；正常服保持 true。\
旧版对应：oldconfig `advanced.yml` 的 `servercrash.invalid_move_b` / `invalid_move_c`。 当前值: true

### 82. misc.haste-server

默认: api.mclo.gs\
作用：日志上传到的 Haste 服务器域名（用于分享崩溃/日志）。\
取值范围：合法 Haste 服务域名；可自定义。\
使用场景：管理员上传日志排查问题时使用；更换为自建 Haste 服务也可。\
旧版对应：oldconfig `System.Haste-Server: paste.md-5.net`（旧为 paste.md-5.net）。\
当前值: api.mclo.gs

### 83. misc.clickable-message.enable

默认: true\
作用：是否启用可点击消息（点击警报直接执行命令，如传送到玩家）。\
取值范围：true / false。\
使用场景：管理员点警报即可 /tp 到作弊者，方便巡查；关闭则消息不可点击。\
旧版对应：oldconfig `AlertsManager.Click_Command: /ac spec %player%`。 当前值: true

### 84. misc.clickable-message.commands

默认: /tp %player%\
作用：点击消息时执行的命令（%player% 会被替换为目标玩家）。\
取值范围：任意合法命令字符串，支持 %player% 占位符。\
使用场景：改成 `/spec %player%` 等适配你的管理指令；注意权限。\
旧版对应：oldconfig `AlertsManager.Click_Command`（旧为 /ac spec %player%）。\
当前值: /tp %player%

### 85. misc.brand-message.enable

默认: true\
作用：玩家进服时是否发送其客户端品牌（brand）提示消息。\
取值范围：true / false。\
使用场景：开启可在聊天看到谁用 Vape/ Lunar 等客户端；配合黑名单封禁很有用。\
旧版对应：oldconfig `Brand.Enabled: true` / `Check.Brand.Message`。 当前值: true

### 86. misc.brand-message.commands

默认: /tp %player%\
作用：点击品牌提示消息时执行的命令。\
取值范围：任意合法命令字符串，支持 %player%。\
使用场景：与 clickable-message 同理，常用于快速抵达目标玩家。\
旧版对应：oldconfig `Brand.Command: /ac spec %player%`。 当前值: /tp %player%

### 87. misc.freeze-logout-command

默认: \[]\
作用：玩家被「冻结（freeze）」检查时退出游戏要执行的命令列表（为空则不执行）。\
取值范围：命令字符串列表；支持 %player% 等占位符。\
使用场景：对接受 Staff 检查却退游的玩家执行封禁等惩罚；留空表示只记录不处罚。\
旧版对应：oldconfig `Freeze.player-quit-command.command`（旧为 kick 命令）。\
当前值: \[] （空列表）

### 88. misc.blacklist-brands

默认: \[CM-Pack, Blazing-Pack, Crystalware, Vivecraft, Vape-Crack]\
作用：客户端品牌黑名单，匹配到的品牌将被标记/处理。\
取值范围：品牌名字符串列表；可增删。\
使用场景：把已知作弊客户端（Vape 等）列入黑名单，配合 brand-commands 自动处理。\
旧版对应：oldconfig `Client.Blocked-Brands`（同列表）。\
当前值: \[CM-Pack, Blazing-Pack, Crystalware, Vivecraft, Vape-Crack]

### 89. misc.brand-commands

默认: \['kick %player% Unsupported client!']\
作用：检测到黑名单品牌时执行的命令列表。\
取值范围：命令字符串列表，支持 %player% / %brand% 占位符。\
使用场景：发现黑名单客户端直接 kick/ban；例如 `ban %player% 1d 不支持的客户端`。 旧版对应：oldconfig `Client.Blocker-Command` / `Check.Client.Blocker-Command`。 当前值: \['kick %player% Unsupported client!']

### 90. disabled-components

默认: \[example.check.a]\
作用：被禁用的检测组件 ID 列表（用于关闭特定实验性/不需要的检测）。\
取值范围：组件 ID 字符串列表；填 `example.check.a` 为占位示例。\
使用场景：若某检测误判严重，可把其组件 ID 加入此列表临时关闭；移除示例项即启用全部。\
旧版对应：oldconfig `advanced.yml` 的 `disabled_components`（旧为 move.openai 等）；新版结构调整后仅保留占位示例。\
当前值: \[example.check.a]

### 91. other.log\_exception

默认: false\
作用：是否记录异常堆栈到日志（调试用）。\
取值范围：true / false。\
使用场景：排查插件报错时设 true；正常运行设 false 避免日志膨胀。\
旧版对应：无直接对应（新版新增）。\
当前值: false

### 92.settings.compatible\_with\_1\_7\_10

默认: false\
作用：是否兼容低版本->高版本（尽量不要开，除非发现修复不好）\
取值范围：true / false。\
当前值: false

***

## 第二部分：message.yml

> 下列文本中的 `&` 颜色代码按本教程开头「颜色代码说明」解读；`%xxx%` 为占位符，运行时由插件替换。

### 1. prefix

默认: '&7\[\&bSpiter&7]'\
作用：所有 Spiter 消息的统一前缀。\
取值范围：任意含 `&` 颜色代码的字符串。\
使用场景：统一插件消息风格；想换名字/颜色直接改这里（如 `&7[&cAntiCheat&7]`）。\
旧版对应：oldconfig `messages.yml` 的 `Prefix`（旧残留为 `&3Polar |`），新版统一为 Spiter 前缀。\
当前值: '&7\[\&bSpiter&7]'

### 2. console.lag-notice

默认: '%prefix% &7Server is lagging!'\
作用：服务器卡顿时在控制台/相关位置提示的信息。\
取值范围：含占位符与颜色代码的字符串。\
使用场景：服务器 TPS 下降时提醒管理员；可改为中文「服务器卡顿中！」。\
旧版对应：oldconfig `messages.yml` 的 `server-lag-warning-message`（旧为 `&cThe Server is Lag?`）。\
当前值: '%prefix% &7Server is lagging!'

### 3. player.alerts.msg

默认: '%prefix% &7%player% failed \&b%alertsName% &8❘ &3x%vl%'\
作用：警报消息格式（管理员开启 alerts 后看到的作弊提示）。\
取值范围：含 %player% / %alertsName% / %vl% 的字符串。\
使用场景：定制警报展示；`&8❘` 为分隔符，可换成其它符号。\
旧版对应：oldconfig `messages.yml` 的 `AlertsManager.Layout` / `Setting.SendAlertsManager.Layout`。 当前值: '%prefix% &7%player% failed \&b%alertsName% &8❘ &3x%vl%'

### 4. player.alert.enable

默认: '%prefix% \&bAlerts has been enabled.'\
作用：管理员开启 alerts 时的回执消息。\
取值范围：含颜色代码的字符串。\
使用场景：反馈 /alerts 开启成功；可汉化为「警报已开启」。\
旧版对应：oldconfig `messages.yml` 的 `AlertsManager.Alerts-Enabled`。 当前值: '%prefix% \&bAlerts has been enabled.'

### 5. player.alert.disable

默认: '%prefix% \&cAlerts has been disabled.'\
作用：管理员关闭 alerts 时的回执消息。\
取值范围：含颜色代码的字符串。\
使用场景：反馈 /alerts 关闭；可汉化为「警报已关闭」。\
旧版对应：oldconfig `messages.yml` 的 `AlertsManager.Alerts-Disabled`。 当前值: '%prefix% \&cAlerts has been disabled.'

### 6. player.notice.msg

默认: '%prefix% &7%player% failed \&b%checkName%&7(\&b%component%&7) \&bx%vl%'\
作用：notice（组件级通知）消息格式。\
取值范围：含 %player% / %checkName% / %component% / %vl% 的字符串。\
使用场景：比 alerts 更细粒度的提示，展示具体检测组件；可定制。\
旧版对应：oldconfig `messages.yml` 的 `Setting.Send_Other_Alerts_Manager.Layout`。 当前值: '%prefix% &7%player% failed \&b%checkName%&7(\&b%component%&7) \&bx%vl%'

### 7. player.notice.enable

默认: '%prefix% \&bNotice has been enabled.'\
作用：开启 notice 时的回执消息。\
取值范围：含颜色代码的字符串。\
使用场景：反馈 notice 开启；可汉化。\
旧版对应：oldconfig `messages.yml` 的 `NotifyManager.Notify-Enabled`。 当前值: '%prefix% \&bNotice has been enabled.'

### 8. player.notice.disable

默认: '%prefix% \&cNotify has been disabled.'\
作用：关闭 notice 时的回执消息。\
取值范围：含颜色代码的字符串。\
使用场景：反馈 notice 关闭；可汉化。\
旧版对应：oldconfig `messages.yml` 的 `NotifyManager.Notify-Disabled`。 当前值: '%prefix% \&cNotify has been disabled.'

### 9. player.brand.msg

默认: '%prefix% \&b%player% &7joined using &7\[\&e%brand%&7]&7.'\
作用：玩家进服时广播其客户端品牌（brand）的消息。\
取值范围：含 %player% / %brand% 的字符串。\
使用场景：让管理员直观看到谁用 Vape/Lunar 等；可加颜色突出作弊客户端。\
旧版对应：oldconfig `messages.yml` 的 `Check.Brand.Message`。 当前值: '%prefix% \&b%player% &7joined using &7\[\&e%brand%&7]&7.'

### 10. player.brand.info

默认: \['&7Version: \&b%version%', '&7Click to teleport']\
作用：品牌消息 hover（悬停）时显示的信息列表（版本、点击传送提示）。\
取值范围：字符串列表，支持 %version% 等占位符。\
使用场景：悬停查看客户端版本；第二行提示可点击传送（需 misc.clickable-message 开启）。\
旧版对应：oldconfig `messages.yml` 的 `Check.Brand.Hover`。 当前值: \['&7Version: \&b%version%', '&7Click to teleport']

### 11. player.mitigation.enabled

默认: '%prefix% \&bMitigation have been enabled.'\
作用：启用缓解（mitigation）时的回执消息。\
取值范围：含颜色代码的字符串。\
使用场景：反馈 mitigation 开启；可汉化。\
旧版对应：oldconfig `messages.yml` 的 `MitigationManager-Enabled`。 当前值: '%prefix% \&bMitigation have been enabled.'

### 12. player.mitigation.disabled

默认: '%prefix% \&cMitigation have been disabled.'\
作用：关闭缓解时的回执消息。\
取值范围：含颜色代码的字符串。\
使用场景：反馈 mitigation 关闭；可汉化。\
旧版对应：oldconfig `messages.yml` 的 `MitigationManager-Disabled`。 当前值: '%prefix% \&cMitigation have been disabled.'

### 13. player.forceban.ban-message

默认: '%prefix%\&b %player% \&fwas forced banned for admin &7(\&b force &7)\&f.'\
作用：管理员强制封禁（forceban）某玩家时显示的消息。\
取值范围：含 %player% 的字符串。\
使用场景：记录/广播谁被管理员强封；可汉化为中文。\
旧版对应：oldconfig `messages.yml` 的 `Forceban.banned.message`。 当前值: '%prefix%\&b %player% \&fwas forced banned for admin &7(\&b force &7)\&f.'

### 14. player.forceban.unban-message

默认: '%prefix%\&b %player% \&fwas unforced banned for admin &7(\&b unforce &7)\&f.'\
作用：管理员解除强制封禁时显示的消息。\
取值范围：含 %player% 的字符串。\
使用场景：反馈 forceban 解除；可汉化。\
旧版对应：oldconfig `messages.yml` 的 `Forceban.unban.message`。 当前值: '%prefix%\&b %player% \&fwas unforced banned for admin &7(\&b unforce &7)\&f.'

### 15. player.freeze.un-freeze-notice

默认: '%prefix% \&c%player% \&fBanned for being checked by Staff but quitting the game.'\
作用：被冻结检查却退出游戏的玩家被封禁时的提示。\
取值范围：含 %player% 的字符串。\
使用场景：警示逃避 Staff 检查的玩家会被封；可汉化为「因逃避检查已被封禁」。\
旧版对应：oldconfig `messages.yml` 的 `Message.freeze.getbanned-message`。 当前值: '%prefix% \&c%player% \&fBanned for being checked by Staff but quitting the game.'

### 16. player.freeze.notice

默认: '\&fPlease add Staff QQ xxxxxxxxx for checking - Exit the game will be banned!'\
作用：玩家被冻结时收到的提示（要求联系 Staff，否则退游封禁）。\
取值范围：含联系方式的字符串。\
使用场景：把 `xxxxxxxx` 改成你的 Staff QQ/联系方式；用于人工核查可疑玩家。\
旧版对应：oldconfig `messages.yml` 的 `Message.freeze.sendplayer-message`。 当前值: '\&fPlease add Staff QQ xxxxxxxxx for checking - Exit the game will be banned!'

### 18. command.help.header

默认: '\&e\&l⚝ &7Running \&eSpiter Anticheat \&f\&n%version%\&f: '\
作用：/spiter 帮助菜单的标题行。\
取值范围：含颜色代码与 %version% 占位符的字符串。\
使用场景：美化帮助页头部；`&f&n%version%` 为带下划线的版本号。\
旧版对应：oldconfig `messages.yml` 的 `Command.Help.Header` / `Help-Command-Customize`。 当前值: '\&e\&l⚝ &7Running \&eSpiter Anticheat \&f\&n%version%\&f: '

### 19. command.help.format

默认: ' \&e| \&b%label% &7%args%'\
作用：帮助菜单中每条命令的格式（标签 + 参数）。\
取值范围：含 %label% / %args% 的字符串。\
使用场景：定制帮助列表展示；`&e|` 为分隔竖线。\
旧版对应：oldconfig `messages.yml` 的 `Command.Help.Format`（旧含 %description%）。\
当前值: ' \&e| \&b%label% &7%args%'

<br>

<br>