Global Multicharacter
Global Multicharacter is a FiveM character selector with a cinematic preview, a passport creation flow, a tiled spawn map, and starter apartments. It is built for Qbox and stays compatible with QBCore, ESX, and ox_core through configurable bridges. It installs without editing other resources, aside from one optional line so the core selector does not open at the same time.
Overview
After GTA's native load, the loadscreen closes and the selector takes over. Each character is shown as an animated ped in a real location — Grove Street, Legion Square, Del Perro Pier, Mirror Park, Vespucci Beach, or Paleto Bay — with optional companion NPCs in the scene. The camera, animation, and companions are defined per location in `config.lua`.
With several characters, a list sits on the left and a profile card on the right. With a single character, the list is skipped and only the card and Play remain.
Play opens a spawn map in the same tile style as Global Garages: last location, Los Santos, Sandy Shores, Paleto Bay, and Grapeseed. Clicking a point zooms the map; Spawn here places the player.
Create character opens a passport. Next unfolds it so the player fills in first name, last name, birthday, nationality, and gender. Done stays disabled until the form is complete. The server checks the name and stamps the passport Approved or Rejected (joke names, memes, and profanity). An approved passport receives a unique code (`GN-XXXXXX` by default). The map then switches to starter apartments — Del Perro Heights, 4 Integrity Way, Richard Majestic, and Tinsel Towers. Choosing one spawns the player there and opens the configured clothing creator. If `qbx_properties` is running, that apartment is registered as their property.
Slot panel
Ranks `admin` and `god` can open `/admin:multicharacter` to see connected players, how many characters they own, and how many slots they have. **+1 SLOT** adds one slot, up to the configured maximum. A player who has filled every slot does not see Create character.
`/logout` returns to the selector only when the player has more than one character. During Play or Create the selector does not reopen, so Qbox does not kick the player for a second `Login`.
Compatibility
Set in `config.lua` (`auto` detects whatever is already started):
**Frameworks: **Qbox, QBCore, ESX, ox_core
Appearance: global_clothing, illenium-appearance, qb-clothing, fivem-appearance, ox_appearance, rcore_clothing
**Notifications: **ox_lib, QBCore, ESX, origen_notify, okokNotify, mythic_notify, native
Properties: qbx_properties (optional; assigns the chosen apartment on creation)
Languages: Spanish and English
`config.lua`, `locales/`, and every file under `bridge/` are listed in `escrow_ignore`.
Requirements
- oxmysql
- ox_lib
- A supported framework
No SQL import. The passport identifier is stored in the character's `charinfo`. On Qbox, set `useExternalCharacters = true` in the core client config so both selectors do not open together. On ESX, stop any other multicharacter or identity resource that duplicates the login flow.
