Admin UI

ItemsDB ships with an in-game management interface. Open it with /itemsdb (requires the command.itemsdb ACE permission).

Permissions

# permissions.cfg
add_ace group.admin command.itemsdb allow

If you already have add_ace group.admin command allow in your config, admins can open the UI without any additional changes.

Features

• Items tab - Browse, search, edit, and create regular items. Fields: name, label, weight, stack, close, consume, degrade, durability, allow armed, description, client image, client usetime/notification/export, server export.
• Weapons tab - Same layout for weapon entries. Fields: name, label, weight, category (Weapons/Ammo/Components/Tints), durability, throwable, ammo name, model, client image.
• Validation - Per-field errors appear inline as you type; the save button is blocked until all fields are valid.
• In-frame toasts - Success/error notifications appear inside the UI frame.
• Auto-sync - Saving or deleting an item immediately updates ox_inventory's server-side ItemList and broadcasts the change to all connected clients. No restart required.

Building After UI Changes (Advanced)

The UI is a Vite + React project in web/. After editing source files:

cd resources/[standalone]/ItemsDB/web
npm run build

Then restart ItemsDB in txAdmin. The built output lands in dist/ which FiveM serves as the NUI page.