F4 Multicharacter (Escrow)

Cinematic character selection & creation for QBox, QBCore and ESX

Escrow version: the core code is encrypted. All configuration files stay open and editable (full list below).

Documentation: f4-studio.gitbook.io

Your players don't pick a character from a menu on a black screen. The selected character is placed in a hand-built Los Santos location, and the location shows who they are: their name carved into a bench, their mugshot on a wanted poster, their face on the evening news.

Six Hand-Built Scenes

• Sandy Shores Bench: the character's name is carved into the wood

• Del Perro Bus Stop: a wanted poster with a live mugshot and bounty

• Underground Platform: a wanted notice on the metro ad board

• Apartment Living Room: the character is the breaking story on TV, with a news ticker

• Pier Phone Check: the character's social profile on their phone screen

• Nightclub Dance Floor: club lights and a crowd of dancers

Players switch scenes from an in-game menu. You can pick one fixed scene or a random one from a pool. In snowy weather, scenes that have a snow variant swap their props.

Character Creation in a Booking Room

• The ped stands against a height chart, and a booking card on the wall fills in as the player types

• First name, last name, date of birth, nationality, height and gender

• Picking a gender swaps the ped behind a camera flash. The height slider scales the ped against the chart in real time

• 192 nationalities in a searchable list

• Checked live in the UI and again on the server: name length, letters only, capitalization, age limits, plus a name blocklist that also catches tricks like a d m i n

• Accepts Latin, Turkish, Polish, Greek, Cyrillic and Arabic names

Real Character Height

The chosen height is applied to the ped and synced to every player within 150 m through state bags. Includes SetHeight / ClearHeight exports.

Slots

• Every player gets a default number of slots. Extra slots show as locked: visible but not usable

• Give extra slots to individual players by license, Discord, Steam or FiveM ID, then reload with one console command (no restart)

• The server blocks creation in locked slots

• Deleting a character closes the gap in the list. The citizen ID never changes, so vehicles, houses and inventories stay linked

Per-Player Weather & Time

Weather and time on the character screen apply to that player only, and the server's weather is never changed. Players can change it from an in-game menu. Renewed-Weathersync, qb-weathersync and qbx_weathersync pause automatically for that player and resume on spawn.

Appearance & Spawning

• Detects illenium-appearance, fivem-appearance, bl_appearance, qb-clothing, esx_skin / esx_clothing and skinchanger automatically, or you can plug in your own

• The scene ped wears the selected character's saved outfit

• The scene ped is a separate NPC, so the player's real ped is never changed

• Works with qbx_apartments, qb-apartments, qbx_properties, qb-spawn, qbx_spawn, ESX spawn menus or your own event

• Spawn through the apartment flow, at the last position or at a fixed point

• The clothing screen never opens twice on apartment setups

Everything Else

• /logout to switch characters without reconnecting

• Each player on the character screen gets a private routing bucket

• Deleting a character requires typing its first name. You can turn deletion off or limit it to the Del key

• Starter items and money for new characters

• Loading screen with your own logo, plus a 20-second failsafe so nobody gets stuck on a black screen

• Discord logs for join, leave (with session length), creation and deletion. Webhook URLs never leave the server

• 8 languages: English, Turkish, German, French, Polish, Greek, Bulgarian, Arabic

• The UI comes prebuilt, so there is no build step

Framework Support

• QBox: creation and login go through qbx_core's own callbacks, so starter items, apartments and qbx_core logs keep working

• QBCore

• ESX: uses the same char<slot>:<license> scheme as esx_multicharacter, so existing characters carry over

• The framework is detected automatically

Requirements

• ox_lib, oxmysql

• qbx_core, qb-core or es_extended

• Optional: an appearance resource and a weather sync resource

Documentation

Installation, configuration and troubleshooting guide: https://f4-studio.gitbook.io/documentation/resources/f4-xmulticharacter

About the Escrow Version

Protected by FiveM Asset Escrow. The core code (scenes, cameras, height system, creation flow and validation) is encrypted and can't be read or edited. Everything you need to configure your server stays open and fully editable:

• shared/config.lua: all settings

• shared/server_config.lua: Discord webhooks

• shared/slots.lua: per-player slot grants

• shared/names.lua: blocked names

• shared/nationalities.lua: nationality list

• locales/*.lua: all languages, and you can add your own

• client/open.lua, server/open.lua: hooks for appearance and the spawn selector

• client/framework/*.lua, server/framework/*.lua: framework bridges

• client/spawn.lua: apartment and spawn handoff

• server/logs.lua: Discord embeds

The resource is delivered to the Cfx.re account linked at checkout.

Need full access to the code? Get the Open Source version.