Multicharacter troubleshooting and FAQ
Fix common Multicharacter issues: console messages, player loaded without selection, black screen, missing characters, rejected creation.
Start with the server console and F8. If the framework installation is wrong, the resource writes it in red in the console at startup and also shows it to players.
Console messages
| Message | Fix |
|---|---|
| ESX: set Config.Multichar = true in es_extended | Set Config.Multichar = true in es_extended/shared/config/main.lua, then restart the server. |
| Conflict: the resource … must be removed from the server | Remove the named resource from server.cfg. |
| Qbox: set useExternalCharacters = true… | Edit qbx_core/config/client.lua (see Installation). |
| The framework loaded the player before character selection | Check the three points above and the ensure order. |
| No compatible framework detected | Start the framework before the resource. |
| Unable to load / create the character | Read the framework error just above in the console. |
| Unable to delete | On ESX, check ServerConfig.ESX.DeleteTables. |
| Please wait a moment | Action repeated too fast, that is normal. |
The player goes straight into the game
The framework loads the character on its own. Check Config.Multichar (ESX), useExternalCharacters (Qbox), and that no other character selection is running.
Restarting the resource mid-game does not send players back to the selection.
Black screen on connection
- No framework detected: look at the console.
- oxmysql is not started or cannot reach the database.
- Another spawn script (
qb-spawn, a modified spawnmanager) is still running. - The folder was renamed.
Missing characters
- ESX:
ServerConfig.ESX.Prefixdoes not match the start of the identifiers in theuserstable. - The player connects with another Rockstar account.
Creation refused
| Message | Reason |
|---|---|
| X letters minimum, no digits | Name too short, digit or character not accepted. |
| X letters maximum | Name too long. |
| This name is not allowed | The name contains a word from Config.Identity.Blacklist. |
| Allowed age: X to Y years | Date of birth out of range. |
| Invalid date | The date does not exist. |
| This slot is locked | The player already has as many characters as slots. |
Slots and shop
- The VIP does not get their slots: check with
test_ace identifier.license:… multicharacter.slots.vipin the console, and the value ofConfig.Slots.Max. - Tebex purchase without effect: see Tebex delivery.
- “Store not configured”: replace the address in
Config.Shop.Url.
Appearance
- The editor does not open: the appearance system starts after the resource, or
Config.Features.CreatorOnSpawn = false. WithConfig.Debug = true, F8 shows the detected system. - Default ped in the selection: no appearance saved for that character, or it was made with another system (see Switching system).
Weather changing during selection
Your weather script is not paused: adapt ClientHooks.OnSelectionOpen (see Customisation).
FAQ
Do I need to restart the server after a change?
Not for config/ and locales/: restart mrpoulpi_multicharacter is enough. Yes after changing the framework configuration.
Do players see each other during selection? No, each one is alone on their scene.
Can a new character choose where to spawn?
No, it spawns on Config.Spawn.NewCharacter.
If the issue persists, open a ticket on the MrPoulpi Labs Discord with the server console, F8, your framework and your config/ files without the webhook.