Workstation - Troubleshooting

Incident Patterns and Root Causes

UI does not open at station

Station key/config missing or player not inside Config.InteractionDistance.

Craft start denied

Ingredient count too low, access rule denied, cooldown active or strict payload check failed.

Craft finish denied

Craft timer not ready yet, player too far from station, or inventory carry capacity not sufficient.

No resume after reconnect

Config.Crafting.pauseOnDisconnect disabled or SQL table/migration not applied correctly.

Framework callback not found

Config.Framework mismatch or framework core not started before workstation resource.

Item icon missing in NUI

Image not present at Config.ItemImages.basePath with configured fileType.

Recovery Checklist

# Startup order
ensure oxmysql
ensure es_extended   # or qb-core
ensure smx-workstation

# Verify schema
SELECT * FROM workstation_crafting LIMIT 5;

# Verify config
Config.Framework
Config.Security.strictTypes
Config.Crafting.pauseOnDisconnect

Escalation: Enable debug output with Config.Debug.enabled = true and capture server lines around startCrafting / finishCraft for fast root-cause analysis.