> 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/getting-started.md).

# Getting Started

{% hint style="danger" %}
**DEPENDENCIES**

* [dirk\_lib](https://github.com/DirkDigglerz/dirk_lib)
* [oxmysql](https://github.com/overextended/oxmysql)
* A supported framework + clothing system (see below)
  {% endhint %}

{% hint style="info" %}
**Frameworks, inventories, clothing**

`dirk_multichar` supports everything `dirk_lib` supports for frameworks. Clothing handoff is detected automatically against the resources you have running. See the lists below.
{% endhint %}

***

<details>

<summary>Supported Frameworks</summary>

* [QBX\_CORE](https://github.com/Qbox-project/qbx_core)
* [QB-CORE](https://github.com/qbcore-framework/qb-core)
* [ES\_EXTENDED](https://github.com/esx-framework/esx_core)

</details>

<details>

<summary>Supported Clothing Systems</summary>

Every clothing system `dirk_lib` supports works out-of-the-box:

* `illenium-appearance`
* `qb-clothing`
* `rcore_clothing`
* `tgiann-clothing`
* `esx_skin`
* `dirk_charCreator`

Any other clothing system can be wired in by overriding the relevant functions in `basic.lua`.

</details>

***

{% stepper %}
{% step %}
**Install dirk\_lib**

Make sure [dirk\_lib](/dirkscripts-documentation/resources/dirk-lib.md) is installed and auto-detecting the correct framework and clothing system. Watch your server console for the detection output.
{% endstep %}

{% step %}
**Drop dirk\_multichar into your resources folder**

Standard `cfx-server-data/resources/` layout. No additional asset packs required.
{% endstep %}

{% step %}
**Start Order**

```properties
ensure your_framework
ensure oxmysql
ensure your_clothing_system

ensure dirk_lib
ensure dirk_multichar
```

{% endstep %}

{% step %}
**Done**

Start the server, log in and you'll land on the multichar selector. Defaults ship a fully playable setup — every value is editable live via the [Live Script Configurator](/dirkscripts-documentation/resources/dirk-multichar/configuration.md).
{% endstep %}
{% endstepper %}

***

## First-Time Setup

On first start, `dirk_multichar` writes its scriptConfig into `dirk_lib`'s `dirk_scriptConfig` database table via `oxmysql`. Defaults ship:

* Cinematic selection scene + default camera atmosphere
* Sensible default backstory, spawn location and lifestyle entries
* Standard character states (Coma, etc.)
* VIP-slot system disabled by default — opt in via the configurator's **VIP Roles** tab

Everything is tweakable from the [Live Script Configurator](/dirkscripts-documentation/resources/dirk-multichar/configuration.md) — changes apply live, no resource restart required.