DB-Authoritative Item Definitions

DB-Authoritative Item Definitions

Nord Inventory treats database-backed item definitions as authoritative by item name.

Precedence

1. A row in nord_inventory_custom_items wins for that item name.
2. If no DB row exists, shared/items.lua and shared/weapons.lua act as reference/fallback definitions.
3. A disabled DB row blocks fallback for that name.

Startup behavior

Current releases do not seed, rewrite or delete item definitions from the Lua reference files during normal startup. This prevents Admin Studio changes from turning into hybrid file/DB definitions after a restart.

Saving from Admin Studio

When an item is saved:

• the authoritative DB row is verified;
• runtime registry state is refreshed;
• connected player snapshots and open inventory sessions receive refreshed definitions;
• persisted item instances reconcile metadata defaults and lifecycle state where required.

See the Downloadable Reference Files page for the bundled persistence and precedence notes when migrating or debugging.