Item Creator - Troubleshooting

Incident Patterns and Root Causes

Menu does not open

User has no permission in configured ESX/QB admin permission list.

Framework not detected

Config.Framework = auto failed because framework resource is not started.

Item create/update fails

Validation rejected item name/label/weight or table schema does not match expected columns.

Live sync warning after save

Framework or inventory refresh bridge returned optional/required export error.

Inventory bridge missing

Configured adapter resource/export not running or misnamed in Config.InventoryAdapters.

German text looks broken

Locale file appears with encoding artifacts; save config.lua as UTF-8 to keep umlauts intact.

Recovery Checklist

# Verify startup order
ensure oxmysql
ensure es_extended   # or qb-core
ensure smx-itemcreator

# Validate DB schema
DESCRIBE items;

# Check runtime config
Config.Framework
Config.Inventory
Config.ItemTable

Escalation: Check server console lines starting with [smx-itemcreator] after create/update/delete. They include framework and inventory refresh status/reason pairs.