Upgrade Guide

Use this page when updating an older Nord Inventory installation to the current resource files.

1. Back up first

Back up:

• the complete nord_inventory resource;
• your database;
• intentional server-specific config edits;
• custom item images.

2. Replace the complete resource

Do not copy only shared/utils.lua, only the NUI or only one core file. Several updates changed contracts together, especially external use handling and cross-resource callbacks.

3. Preserve server-only admin config

Review:

server/config.lua

Keep license identifiers server-only.

4. Migrate UI provider configuration

Current builds use one simple resource name per bridge:

Config.Notify = 'nord_inventory'
Config.TextUI = 'nord_inventory'
Config.Target = 'auto'

Config.Interaction controls interaction mode/key only.

5. External item-use integrations

Current builds support:

• Internal (Nord) behavior;
• External client exports;
• External server exports;
• RegisterUseExport for existing items;
• OX-shaped client = { export = ... } / server = { export = ... } definitions.

Server exports are completed directly on the server.

6. Cross-resource callback compatibility

Current builds safely support Cfx function references passed through exports to:

• RegisterUsableItem;
• RegisterItem(..., useHandler);
• RegisterHook.

If you see Cannot index a funcref, first check for a mixed or partial resource update.

7. Source-aware item deletion

Source-aware deletion uses:

nord_inventory_disabled_reference_items

Base/reference items are disabled instead of edited or deleted from Lua. Database-only items are deleted from the custom table. Disabled base items can be restored.

Nord creates the table automatically, and the current SQL file also includes it.

8. Test integrations

Before production, test:

• scripts using RegisterUsableItem;
• scripts using RegisterItem / RegisterItems;
• external client/server exports;
• AddItem / RemoveItem / search / metadata helpers;
• Nord Staff bridge;
• Nord CarPlay item installation when used;
• restart persistence and Admin Studio deletion/restore.