# Troubleshooting

#### Characters not loading / database errors

* Make sure `oxmysql` starts **before** `ars_multicharacter`
* Check the server console for SQL errors on startup
* Verify your database user has `CREATE TABLE` and `ALTER TABLE` permissions

#### Appearance / skin not applying

* Check `resource/client/editable.lua` and make sure the correct appearance export is uncommented
* Ensure your appearance resource is started and listed in `fxmanifest.lua` dependencies if required

#### Relog screenshots not uploading

* Ensure `screenshot-basic` is started before `ars_multicharacter`
* Verify the Discord webhook URL or FiveManage API key is correct
* Discord webhooks must be from a channel the bot/webhook has permission to post in

#### Spawn selector not showing

* Confirm `Config.SpawnSelector.enable = true`
* Check `show.always` and `show.onlyNewChar` are set as intended

#### Admin panel not opening

* Confirm the player's framework group matches one of the groups in `Config.AdminPanel.permission`
* Check the command name in `Config.AdminPanel.command` (default: `charpanel`, no slash needed)

#### Framework not detected

* Set `Config.Framework` explicitly instead of `"auto"` if detection fails
* Ensure your framework resource name matches the standard name (`es_extended`, `qb-core`, `qbx_core`)
