# Soul Harvest 调试命令

本文列出 Soul Harvest 3.0 提供的开发与回归测试命令。

## 使用条件

- 命令仅能在世界名称包含 `-debug` 时使用，例如 `SoulHarvest-debug`。
- 命令必须由已经进入世界、且人物数据完成服务端同步的玩家执行。
- 多人模式下由服务端校验和修改人物成长数据。
- 建议先备份测试人物；调试命令不会自动生成备份。

## 命令列表

| 命令 | 作用 |
| --- | --- |
| `/reaperdebugitems` | 在玩家位置生成本模组全部可持有物品各 1 个，并为尚未满额的初醒、破界、统御阶段各合法签发 1 点魂印。 |
| `/reaperdebuggive` | 生成 999 个灵魂精华，并将初醒、破界、统御魂印账本分别补至人物上限 6 点。 |
| `/reaperdebugreset` | 回退六分支阶段、18 项形态技能和全部人物镰刀通用节点，并清空当前形态的临时战斗状态。 |

## `/reaperdebugitems` 细节

- 命令会动态枚举当前版本已经注册的 `ModItem`，因此以后新增的普通物品会自动包含在内。
- 普通物品、装备、当前收魂镰以及为旧存档兼容而保留的旧物品都会在玩家位置生成；请从地面拾取。
- `死亡领域`不会生成。它是死神祭坛用于展示人物领域成长的虚拟条目，不是可以持有的物品。
- 三种魂印不会被直接伪造为无效物品，而是通过人物账本各签发 1 点，并生成或补发对应凭证。
- 单个阶段已经达到 6 点签发上限时不会继续增加；其他未满阶段仍会正常获得 1 点。
- 若需要一次将三阶段魂印全部补满，请使用 `/reaperdebuggive`。

## 推荐测试流程

1. 建立名称包含 `-debug` 的测试世界。
2. 输入 `/reaperdebugitems` 获取全套物品。
3. 输入 `/reaperdebuggive` 准备灵魂精华和完整魂印资源。
4. 通过死神祭坛测试阶段、技能、死亡领域和装备升级。
5. 需要重新测试成长路线时输入 `/reaperdebugreset`。