1 item authoring lifecycle and reference repairs
forgejo-actions edited this page 2026-07-13 19:45:35 +00:00

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.