# Soul Harvest Debug Commands

This document lists the development and regression-testing commands provided by Soul Harvest 3.0.

## Requirements

- Commands are available only in worlds whose name contains `-debug`, for example `SoulHarvest-debug`.
- The caller must be an active in-world player whose character data has finished synchronizing with the server.
- In multiplayer, the server validates commands and owns all character-progression changes.
- Back up test characters first; debug commands do not create backups.

## Command list

| Command | Effect |
| --- | --- |
| `/reaperdebugitems` | Spawns one of every player-holdable item from this mod at the player and legally issues one point for each uncapped Awakening, Boundary, and Dominion Seal stage. |
| `/reaperdebuggive` | Spawns 999 Soul Essence and fills the Awakening, Boundary, and Dominion Seal ledgers to the per-character cap of 6. |
| `/reaperdebugreset` | Rolls back all six branch stages, all 18 form skills, and every character-owned common sickle node, then clears temporary form-combat state. |

## `/reaperdebugitems` details

- The command dynamically enumerates the current build's registered `ModItem` content, so future ordinary items are included automatically.
- Ordinary items, equipment, the current Harvest Sickle, and legacy save-compatibility items are spawned at the player's position for pickup.
- The Death Domain is not spawned. It is a virtual Death Altar entry representing character-owned domain progression, not a holdable item.
- Soul Seal receipts are not forged directly. One point for each stage is issued through the authoritative character ledger, which creates or queues the matching receipt.
- A stage already at its six-point issue cap does not increase; other uncapped stages still receive one point.
- Use `/reaperdebuggive` when all three Soul Seal stages should be filled to their caps at once.

## Suggested test flow

1. Create a test world with `-debug` in its name.
2. Run `/reaperdebugitems` to spawn the full item set.
3. Run `/reaperdebuggive` to prepare Soul Essence and full Soul Seal resources.
4. Use the Death Altar to test stages, skills, Death Domain progression, and equipment upgrades.
5. Run `/reaperdebugreset` when the character progression route needs to be tested again.