# Requirements

### 📋 Required Dependencies

#### Core Dependencies

| Resource | Download                                          |
| -------- | ------------------------------------------------- |
| ox\_lib  | [GitHub](https://github.com/overextended/ox_lib)  |
| oxmysql  | [GitHub](https://github.com/overextended/oxmysql) |

{% hint style="warning" %}
**ox\_lib** and **oxmysql** are **required** for the script to function. Make sure they are started before 0r-multicharacterv3 in your server.cfg.
{% endhint %}

***

### 🎮 Framework (Choose One)

You need **one** of the following frameworks installed:

| Framework        | Minimum Version | Download                                              |
| ---------------- | --------------- | ----------------------------------------------------- |
| QBCore           | Latest          | [GitHub](https://github.com/qbcore-framework/qb-core) |
| QBox (qbx\_core) | Latest          | [GitHub](https://github.com/Qbox-project/qbx_core)    |
| ESX              | Latest          | [GitHub](https://github.com/esx-framework/esx_core)   |

***

### 📦 Inventory (Choose One)

You need **one** of the following inventory systems:

| Inventory         |
| ----------------- |
| ox\_inventory     |
| qb-inventory      |
| ps-inventory      |
| qs-inventory      |
| codem-inventory   |
| origen\_inventory |
| core\_inventory   |
| tgiann-inventory  |
| jpr-inventory     |

{% hint style="info" %}
Your inventory must be started **before** 0r-multicharacterv3 in your server.cfg
{% endhint %}

***

### 🎨 Clothing Script (Choose One)

For character appearance, you need **one** of these clothing scripts:

| Clothing Script     |
| ------------------- |
| bl\_appearance      |
| illenium-appearance |
| fivem-appearance    |
| rcore\_clothing     |
| qb-clothing         |
| skinchanger         |
| crm-appearance      |

***

### 🖥️ Server Requirements

* **FiveM Artifacts**: Build 5848 or newer recommended
* **OneSync**: Enabled (Infinity recommended)
* **MySQL**: MariaDB 10.5+ or MySQL 8.0+

***

### 📁 Recommended Resource Order

Your `server.cfg` should load resources in this order:

```cfg
# Database
ensure oxmysql

# Core Library
ensure ox_lib

# Framework (choose one)
ensure qb-core
# ensure es_extended
# ensure qbx_core

# Inventory (choose one)
ensure ox_inventory
# ensure qb-inventory

# Clothing (choose one)
ensure illenium-appearance

# Multicharacter (AFTER all above)
ensure 0r-multicharacterv3
```

{% hint style="danger" %}
**Important:** Do NOT start `basic-gamemode` or similar spawn scripts. They will conflict with 0r-multicharacterv3.
{% endhint %}

***

### ✅ Checklist

Before proceeding to installation, verify:

* [ ] ox\_lib is installed and running
* [ ] oxmysql is installed and running
* [ ] A compatible framework is installed
* [ ] A compatible inventory is installed
* [ ] A compatible clothing script is installed
* [ ] basic-gamemode is removed or disabled