Error Reference & Diagnostics
This page maps common Nord Inventory messages and integration return codes to their likely cause.
User-facing external-use errors
| Message | Meaning | What to check |
|---|---|---|
Invalid inventory request. |
Generic fallback for an unmapped/invalid action | First related console error, stale definition, slot/session validity |
External use export configuration is invalid. |
Nord could not normalize the external export descriptor | Resource/export/side fields |
External resource "X" is not started. |
Target resource state is not started |
ensure order, resource folder name, startup failure |
External export X:Y failed. |
The called export threw an error | Target resource console stack trace |
External export X:Y rejected the item use. |
Export explicitly returned false |
Resource validation logic |
The item use handler failed. |
Registered Lua callback errored | Server stack trace in registering resource |
The item use request expired. |
Pending use token timed out before completion | frozen client/progress flow, delayed callback, stale event |
The definition for this item is not available. |
Definition missing or disabled | DB/reference/runtime registry ownership |
Registration return codes
database_authoritative
A runtime RegisterItem attempted to use a name already owned by nord_inventory_custom_items.
Correct fix: keep the database item and attach only its runtime handler with RegisterUseExport / RegisterUsableItem, or deliberately remove/revert the DB definition if the external resource should own it.
reference_disabled
An administrator disabled the reference/base item. Runtime registration is not allowed to silently reactivate it.
Correct fix: restore the item from Admin Studio if it should be active again.
invalid_export
The handler string/table cannot be normalized into a valid external export descriptor.
Check:
resource name
export name
side = client | server
invalid_items
RegisterItems did not receive a table.
invalid_item / invalid_name
The requested item name is empty or fails Nord's item-name sanitization.
invalid_inventory
An integration export could not resolve the requested inventory target.
FiveM funcref error
SCRIPT ERROR: @nord_inventory/shared/utils.lua:...: Cannot index a funcref
Nord Inventory handles Cfx function references safely. If this appears, assume a mixed/partial update first.
Recommended recovery:
stop nord_carplay # or the registering resource
stop nord_inventory
replace the complete nord_inventory folder
start nord_inventory
start nord_carplay
CarPlay-specific rejection
Wrong configuration:
Resource: nord_carplay
Export: UseCarplay
Execution side: Server
for the documented client installation flow.
Correct Admin Studio configuration:
Resource: nord_carplay
Export: carplay
Execution side: Client
Remove on use: Off
The CarPlay server removes the item only after installation succeeds.
Diagnostic rule
Always fix the first relevant stack trace or specific external-use notification before the generic Invalid inventory request. message. Generic fallback messages are often consequences, not the original cause.