Skip to content
⌘ K

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:

text
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.

  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

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:

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

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