> For the complete documentation index, see [llms.txt](https://dirkscripts.gitbook.io/dirkscripts-documentation/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://dirkscripts.gitbook.io/dirkscripts-documentation/resources/dirk-multichar.md).

# Multicharacter

**dirk\_multichar v1.5** is a complete rewrite around `dirk_lib`'s scriptConfig system. Every value the resource cares about is admin-editable in-game, every UI uses the modern dirk\_cfx-react stack, and every consumer NUI propagates admin saves live without restarting the resource.

***

## Highlights

* **Character selection scene** — fully cinematic camera with configurable atmosphere (weather, time, scenario animations) that applies during selection and restores cleanly on hand-off.
* **Backstory system** — admin-built backstories with their own scenes, items, and Discord-role gated access. Players pick one on character creation and spawn into a scripted intro.
* **Lifestyles** — pre-configured character archetypes that grant unique items, animations and spawn behaviour. Tied directly to the configurator; extendable via exports for custom Lua-side lifestyles.
* **Character States** — define visual states (icon + colour + message) like "Coma" or "In Hospital" that can disable a character or display in-UI status. Apply to any online character from the admin panel.
* **VIP Slots** — extra character slots granted via command or auto-detected Discord roles. Optional `Use ESX Character Slots Table` toggle for ESX-native slot tracking.
* **Spawn Locations** — admin-defined spawn points with FontAwesome icon picker, in-game group/rank gating via `lib.framework`, and randomised internal IDs.
* **Live Script Configurator** — every backstory, spawn location, lifestyle, character state, VIP role and basic setting edited in-game. Undo/redo, audit log, no SQL, no Lua edits, no resource restart.

<figure><img src="/files/2PSaiWcLozOH0DysQKs9" alt=""><figcaption><p>The character selection UI.</p></figcaption></figure>

***

## Where to go next

* New to the resource? Start with [Getting Started](/dirkscripts-documentation/resources/dirk-multichar/getting-started.md).
* Want a tour of every system? Open the [Features](/dirkscripts-documentation/resources/dirk-multichar/features.md) section.
* Ready to tune your server? Jump to the [Live Script Configurator](/dirkscripts-documentation/resources/dirk-multichar/configuration.md).

***

## Framework Support

Built on **dirk\_lib** and fully framework-agnostic. Out-of-the-box support for **QBX\_CORE**, **QB-CORE** and **ES\_EXTENDED**, plus character creation handoff to **illenium-appearance**, **qb-clothing**, **rcore\_clothing**, **tgiann-clothing**, **esx\_skin** and **dirk\_charCreator**. Any other clothing system can be wired in via the exposed functions in `basic.lua`.