# 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`.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://dirkscripts.gitbook.io/dirkscripts-documentation/resources/dirk-multichar.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.