Item Authoring Lifecycle And Reference Repairs
What This System Is
Item authoring lifecycle and reference repairs cover how designers create, rename, deprecate, delete, import, and repair item definitions without breaking quests, services, vendor stock, crafting recipes, conditions, or generated item families.
How Authors Use It
Authors create items from templates, imports, or generated item families. Item definitions carry kind, lifecycle state, aliases, taxonomy, trade fields, stackability, and icon references. The item authoring tab projects usages and repair previews before applying catalog changes.
Rules And Invariants
Item ids are durable references. Lifecycle state should communicate whether an item is active, deprecated, test-only, or otherwise restricted. Aliases can help migration but should not hide unresolved references. Rename and delete repairs must preview every affected usage before applying.
Validation And Debugging
Use item catalog validation, import round-trip tests, and item-authoring repair tests when changing items. If a repair misses a usage, inspect the reference index and authoring registry route for that usage family.
Examples
When renaming item.iron_sword, preview references in vendor stock, crafting recipes, quest rewards, and conditions. Apply the repair transaction only after the usage list matches the intended migration.