Troubleshoot multicharacter loading
Use this flow when character selection is blank, stuck, or fails while loading a character.
Evidence to collect
- Commits for
qb-core,qb-multicharacter, spawn, apartment, clothing, and housing resources - First client and server errors, plus failed NUI/network callbacks
- Start order and whether the failure affects new, existing, or every character
- A staging reproduction with one known character record
Safe diagnostic
- Reproduce with browser/NUI console and server console visible.
- Follow the first error into the pinned source; do not patch later nil errors first.
- Verify dependencies are started and their event names match the caller commit.
- Compare local modifications and test a clean upstream resource set on staging.
Fix
Align the involved resources to a tested commit set and port local changes deliberately. Correct the first broken callback or dependency, then retest select, create, delete, logout, and reconnect flows.
Rollback
Restore the full previously working resource set. Restore database data only if a reviewed migration changed it; a UI/runtime rollback normally should not overwrite character records.
Sources
Last updated on