Troubleshooting

• Check that the resource started without red errors.
• Check that no other character select is running.
• Check that the folder is named exactly sc_multicharacter.
• Check that web/dist/ is complete. Download the package again if needed.
• Check F8 for nui://sc_multicharacter errors.

Set Config.Multichar = true in es_extended/shared/config/main.lua and restart the server. See Framework Setup.

Another resource already selected a character for the player. Disable every other character select resource and reconnect.

The console names the resource that duplicates character select or identity. Stop it and remove its ensure line from server.cfg.

Set the framework in config/core.lua, for example Config.Framework = 'esx'. Make sure sc_multicharacter starts after the framework.

sv_licenseKey comes from another account than the one that bought the resource. See Installation.

• Start your clothing resource before sc_multicharacter.
• Set Config.Appearance to a specific key instead of 'auto'.
• If your resource is not listed, add an adapter. See Integrations.
• With Config.Debug = true, adapter errors show in F8.

Not every clothing resource has a supported editor, for example qb_clothing and um_clothing. Check the table in Integrations or add editor to your adapter.

• Check that the inventory is running and detected (Config.Inventory, Config.StartingItems.grant).
• Item names in item must exist in your inventory.
• Grant your own items in GiveStartingItems, not in OnCharacterCreated.
• Vehicles never go to the inventory. Handle them in OnStartingItemsGranted.

• Start screenshot-basic before sc_multicharacter.
• Set Config.SpawnSelector.photos = true.
• Remove the image field from locations, because it takes priority over automatic photos.
• Take every photo with /scspawnshots.

• Bot token and server id are in config/discord-secrets.lua.
• Server Members Intent is enabled for the bot.
• The bot is on your Discord server.
• Config.Discord.checkRoles = true.
• The player has Discord running while playing.

• Check ACE and Config.AdminGroups. See Commands and Permissions.
• Server commands also need command.<name> or add_ace group.admin command allow.
• Try the same command from the server console without /.

Set Config.AutoFixDatabase = true and restart, or run scfixdb from the console. With auto repair off, the console prints the SQL to run.

• web/dist/loadingscreen.json has a syntax error. Check it in a JSON validator.
• Run refresh and restart sc_multicharacter after a change.
• Image and music paths are relative to web/dist/, for example loadingbg/1.jpg.

• The path in theme.lua starts with logo/ and is relative to web/dist/.
• The file name matches, including letter case.
• A missing file silently falls back to the SleepyCode logo.

• web/dist/audio/menu-theme.mp3 exists.
• The player enabled music in the settings (gear icon).
• Music starts only after the first click in the UI.

They sent too many rejected requests in a short time, usually a cheat or macro.

If it is a false positive, set Config.Security.violations.kick = false and report it with logs from Config.Debug = true.

Yes. Colors, radius, font, logo, opacity, and animations are in config/theme.lua, and every text is in locale/*.json. Screen layout is part of the build and cannot be edited.

No. The UI ships as a ready build in web/dist/. Common changes are covered by the config. See Theme and Branding.

Yes. On ESX, the resource uses the same char<N>:<license> format in users, so existing characters show up right away. QBCore and Qbox use players, ox_core uses characters.

No. With Config.AutoFixDatabase = true, the resource creates the tables and columns it needs.

No. The folder must be named sc_multicharacter.

Use setslots <id> <count>, Config.SlotOverrides, or Discord roles in Config.SlotsByDiscordRole. See Characters and Slots.

Yes. Discord is only needed for role slots, the staff list, and the player name with avatar.

No. Set Config.AirplaneIntro.enabled = false in config/arrival.lua, or limit it to the first character with onlyFirstCharacter = true.

Use OnStateChanged and the busy field in bridge/client/editable.lua. See Examples. From another resource, use the IsBusy() export.

Not noticeably. Characters save every 5 minutes and on disconnect. Heavy parts such as the camera and UI only run during character select.