Installation

Follow these steps to install 0r-multicharacterv3 on your FiveM server.

📥 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]/
└── ...

The folder structure doesn't matter as long as FiveM can find the resource.

---

🗄️ 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.)

-- 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:

# 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

Critical: Remove or disable these conflicting resources:

• basic-gamemode

• spawnmanager (if using standalone)

• qb-multicharacter (if migrating)

• Any other spawn/multicharacter scripts

---

🔧 Step 5: Framework Configuration

For QBox (qbx_core)

Edit qbx_core/config/client.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:

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

Always backup your database before migrating!

---

❓ Need Help?

If you encounter issues during installation:

1. Check Common Issues

2. Review the FAQ

3. Join our Discord for support