Installation

Installation

  1. Place pf_multicharacter in your resources folder
  2. Add ensure pf_multicharacter to your server.cfg (after your framework and ox_lib)
  3. Apply the framework-specific configuration below
  4. Configure script/shared/config/main.lua to your liking

Framework Setup

Each framework requires specific settings to disable its built-in character selection.

ESX

Enable multicharacter support in es_extended/config.lua:

Config.Multichar = true

QBCore

No special configuration required. Works out of the box as long as qb-core is started before this resource.

If you are using qb-spawn, it will automatically be detected and used for spawn selection after character select.

Qbox (qbx_core)

You must enable external character management in qbx_core/config/server.lua:

return {
    useExternalCharacters = true,
}

Without this setting, qbx_core's built-in character selection will conflict with pf_multicharacter.

ox_core

Add the following convars to your server.cfg:

set ox:characterSelect 0
set ox:characterSlots 5
ConvarPurpose
ox:characterSelect 0Disables ox_core's built-in character selection screen
ox:characterSlots 5Sets the maximum number of character slots (match maxCharacters in config)

Note: ox_core is archived by Overextended. Support is provided as-is.