Troubleshooting

Frontend does not update

• rebuild frontend with npm run build
• confirm web/dist exists
• restart the resource after rebuilding

Pass photo upload fails

Check:

• screenshot-basic
• FiveManage convars
• booth config
• endpoint/token validity
• mock mode if testing locally

Photobooth prop floats on first load

This was fixed in the production flow, but if it reappears:

• verify booth coordinates
• verify collision/ground is available in the target area
• relog/restart once to confirm whether it is a world collision timing issue

Template document does not appear

Check:

• dnd_identitydocs_config.templates_json
• player job and grade
• callback documents:getTemplates
• runtime DB template vs fallback config precedence

Template Manager cannot open or save

Check:

• Config.TemplateManager.MinGradeByJob
• player job and grade
• schema validation for fields (name, key, type)
• duplicate field keys

Print fails

Check:

• request status is ready_to_print
• target player ID is valid
• ox_inventory item exists if item mode is used
• printer cooldown

Holder / show nearby fails

Check:

• nearby player radius
• metadata validity
• holder mode vs item mode
• locale / error formatter output

Database tables are missing

Check:

• oxmysql is running
• DB user has create/update permissions
• installation/db.sql was imported if auto-create did not run