Database & Persistence

Database & Persistence

Persistent item/storage state and safe restart behavior.

Applies to: Nord Inventory v2.0.0

Database item persistence

Item-definition precedence is strict and restart-safe:

1. If nord_inventory_custom_items contains a row for an item name, that row owns the definition.
2. shared/items.lua / shared/weapons.lua are consulted only if no database row exists for that name.
3. Resource startup is read-only for item definitions. It never seeds, updates, replaces, or deletes DB item rows.
4. A disabled DB row remains authoritative and blocks file fallback.
5. The only way to restore the reference definition is an explicit Revert action, which deletes the DB override row.

This prevents edited base items from returning to file defaults after restart nord_inventory.