> For the complete documentation index, see [llms.txt](https://cylexdev.gitbook.io/docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://cylexdev.gitbook.io/docs/cylex-multicharv3/installation-and-configuration/quick-start-first-configuration-after-installation.md).

# Quick Start: First Configuration After Installation

{% stepper %}
{% step %}

### Confirm framework detection
 

Open `config.lua` and find the `Config.Framework` line near the top of the file:

```lua
Config.Framework = "Auto"   -- "Auto" | "esx" | "qb"
```

The default value of `"Auto"` tells Cylex Multicharacter to detect your framework on startup. For most servers this works without any changes.\
\
If auto-detection picks the wrong framework — or if your server console shows framework-related errors on start — set the value manually:

```lua
-- Force ESX
Config.Framework = "esx"

-- Force QBCore or QBox
Config.Framework = "qb"
```

{% hint style="info" %}
You can set `Config.Debug = true` in `config.lua` and restart the resource. The server console will print which framework and clothing script were detected.
{% endhint %}
{% endstep %}

{% step %}

### Set your language
 

Find `Config.DefaultLang` in `config.lua`:

```
Config.DefaultLang = "en"
```

This sets the UI language for all players. Eight languages are included out of the box:

| Value  | Language   |
| ------ | ---------- |
| `"en"` | English    |
| `"de"` | German     |
| `"es"` | Spanish    |
| `"fr"` | French     |
| `"it"` | Italian    |
| `"pl"` | Polish     |
| `"pt"` | Portuguese |
| `"tr"` | Turkish    |

Change the value to match one of the locale files in the `locales/` folder. Players can override this themselves from the in-game settings menu, and their preference is saved locally.
{% endstep %}

{% step %}

### Choose a spawn selector

Find `Config.SpawnSelector` in `config.lua`:

```lua
Config.SpawnSelector = "builtin"
```

The built-in spawn selector shows players a map-style picker with the locations defined in `Config.SpawnLocations`. This works out of the box with no extra dependencies.If you are already running a supported spawn script, you can hand off to it instead:

| Value           | Description                                                      |
| --------------- | ---------------------------------------------------------------- |
| `"builtin"`     | Cylex’s own spawn location picker UI                             |
| `"Auto"`        | Detects your installed spawn script                              |
| `"qs-spawn"`    | Quasar Spawn                                                     |
| `"cd-spawn"`    | Codesign Spawn                                                   |
| `"qb-spawn"`    | QBCore Spawn                                                     |
| `"renzu-spawn"` | Renzu Spawn                                                      |
| `"custom"`      | Implement your own handler in `shared/bridge/spawn_selector.lua` |
| `false`         | Spawns at last location automatically — no selector shown        |

{% hint style="info" %}
If you set `Config.SpawnSelector = "Auto"` and the wrong script is detected, set the value explicitly to the correct script name.
{% endhint %}
{% endstep %}

{% step %}

### Restart the server and verify
 

Save `config.lua`, then restart the server.

Connect a test client and confirm the following:

* The character select screen opens automatically on connect
* The UI language matches your `Config.DefaultLang` setting
* Creating a new character completes without errors
* Selecting a character opens the spawn selector (or spawns directly if you set `Config.SpawnSelector = false`)
* The server console shows no red error lines related to `cylex_multicharv3`

{% hint style="info" %}
Press **F8** in-game to open the browser console. If the UI is blank or behaving unexpectedly, JavaScript errors here point to the cause.
{% endhint %}
{% endstep %}
{% endstepper %}

\
What to Configure Next

Your server is now running with a working character select screen. The next step is tailoring the experience to your server — adjusting character slot limits, customising the creation form fields, setting up Discord logging, and configuring the cinematic preview scenes.\ <br>

{% content-ref url="/pages/rDlwEN7WzOGhXSbYX3SF" %}
[General Configuration Reference](/docs/cylex-multicharv3/installation-and-configuration/general-configuration-reference.md)
{% endcontent-ref %}