Inventory - Troubleshooting

Incident Patterns and Root Causes

Inventory UI does not open

Check resource folder name. NUI paths and image URLs expect smx-inventory.

Database errors on start

oxmysql missing or startup order wrong. Ensure DB bridge starts first.

Images are missing in UI

Item image files are not present in html/assets/items/ or names do not match item names.

Storage marker visible but unusable

Storage access is job-restricted and current player job is not in the configured jobs list.

Weapon systems not working

Durability/ammo/attachment item names are missing in framework item definitions.

Admin command denied

User group does not match Config.AdminGroups (and in QB mode, permission check also applies).

Recovery Checklist

# Validate startup order
ensure oxmysql
ensure es_extended   # or qb-core
ensure smx-inventory

# Verify resource name and routes
# Config.ImagePath -> nui://smx-inventory/html/assets/items/

# Validate one admin action
/admingiveitem [id] bread 1

Escalation: If an issue persists, capture server logs around smx-inventory:server:moveItem or smx-inventory:server:useItem because most runtime failures are routed through those handlers.