# Installation

### 📥 Step 1: Download

1. Download the latest version from your purchase source
2. Extract the downloaded archive
3. Rename the folder to `0r-multicharacterv3` (remove any version numbers)

***

### 📁 Step 2: Place Resource

Move the `0r-multicharacterv3` folder to your server's resources directory:

```
resources/
├── [framework]/
├── [0resmon]/
│   └── 0r-multicharacterv3/    <-- Place here
├── [standalone]/
└── ...
```

{% hint style="info" %}
The folder structure doesn't matter as long as FiveM can find the resource.
{% endhint %}

***

### 🗄️ Step 3: Database Setup

#### Option A: Automatic Setup

The script will automatically create required tables on first start. However, we recommend manual setup for better control.

#### Option B: Manual Setup (Recommended)

1. Open `insert-me.sql` in the resource folder
2. Execute the SQL in your database management tool (HeidiSQL, phpMyAdmin, etc.)

```sql
-- The SQL file creates:
-- 1. 0r_multicharacterv3 - Stores character slot data
-- 2. 0r_multicharacterv3_code - Stores redeemable codes
```

***

### ⚙️ Step 4: Server Configuration

Add the following to your `server.cfg`:

```cfg
# Make sure these are started BEFORE 0r-multicharacterv3
ensure oxmysql
ensure ox_lib
ensure qb-core          # or es_extended / qbx_core
ensure ox_inventory     # or your inventory
ensure illenium-appearance    # or your clothing script

# Start other scripts
ensure [other_scripts]

# Start multicharacter
ensure 0r-multicharacterv3
```

{% hint style="danger" %}
**Critical:** Remove or disable these conflicting resources:

* `basic-gamemode`
* `spawnmanager` (if using standalone)
* `qb-multicharacter` (if migrating)
* Any other spawn/multicharacter scripts
  {% endhint %}

***

### 🔧 Step 5: Framework Configuration

#### For QBox (qbx\_core)

Edit `qbx_core/config/client.lua`:

```lua
 -- Whether you have an external character management resource. (If true, disables the character management inside the core)
useExternalCharacters = false,
```

#### For ESX

Edit `es_extended/shared/config/main.lua`:

```lua
Config.Multichar = true  -- Enable multicharacter support
```

***

### 🚀 Step 6: First Start

1. Start your server
2. Check the console for any errors
3. Connect to your server
4. You should see the multicharacter selection screen

***

### ✅ Verification Checklist

After installation, verify these work:

* [ ] Character selection screen appears on connect
* [ ] You can create a new character
* [ ] Character data saves to database
* [ ] Clothing/appearance saves correctly
* [ ] Spawn location works
* [ ] No console errors

***

### 🔄 Migrating from Another Multicharacter

#### From qb-multicharacter

1. Stop `qb-multicharacter`
2. Remove from server.cfg
3. Your existing player data will work automatically

#### From esx\_multicharacter

1. Stop `esx_multicharacter`
2. Remove from server.cfg
3. Character data uses the same table structure

{% hint style="warning" %}
Always backup your database before migrating!
{% endhint %}

***

### ❓ Need Help?

If you encounter issues during installation:

1. Check Common Issues
2. Review the FAQ
3. Join our [Discord](https://discord.gg/0resmon) for support