Installation

Before you start, make sure you're logged into the CFX portal. This ensures you can download the asset and receive future updates.

Downloading Dependencies

Dependencies are very important — you need to install them before moving on to the installation of our script.

1

ox_lib

GitHub - overextended/ox_lib: A FiveM resource and script library for Lua and JS.GitHub

---

Server.cfg

All dependencies you’ve installed must be started before our script. Make sure to follow the correct start-up order in your server.cfg.

ensure ox_lib
ensure op-multicharacter

---

Additional Steps (Important):

ESX

1. Go to your es_extended

2. Find config file located in shared/config/main.lua

3. Change line:

• From: Config.Multichar = GetResourceState("esx_multicharacter") ~= "missing"

• To: Config.Multichar = true

QBOX

1. Go to your qbx_core

2. Find config located in config/client.lua

• Change useExternalCharacters to true

Before:

After:

1. Find resource: qbx_properties

2. Go to qbx_properties/server/apartmentselect.lua

3. Find event QBCore:Server:OnPlayerLoaded

• Replace this:

  RegisterNetEvent('QBCore:Server:OnPlayerLoaded', function()
      local playerSource = source --[[@as number]]
      local player = exports.qbx_core:GetPlayer(playerSource)
      local hasApartment = MySQL.single.await('SELECT * FROM properties WHERE owner = ?', {player.PlayerData.citizenid})
      if not hasApartment then
          TriggerClientEvent('apartments:client:setupSpawnUI', playerSource)
      end
  end)

• With This:

  RegisterNetEvent('QBCore:Server:OnPlayerLoaded', function()
      local playerSource = source --[[@as number]]
      local player = exports.qbx_core:GetPlayer(playerSource)
      local hasApartment = MySQL.single.await('SELECT * FROM properties WHERE owner = ?', {player.PlayerData.citizenid})
      if not hasApartment then
          --TriggerClientEvent('apartments:client:setupSpawnUI', playerSource)
      end
  end)

QBCore

Only If you're using qb-clothing:

qb-clothing | OTHERPLANET DOCSdocs.otherplanet.dev

---

Final Step

Make sure you deleted other Multicharacter scripts from your server, like esx_multicharacter or qb-multicharacter!