Multicharacter
Commands, exports & events
Staff commands, relog, exports for other resources and Tebex integration.
#Player commands
| Command | Description |
|---|---|
/relog | Back to the character selection, with a server-side countdown. Name: Config.Relog.command |
/personaggi | Starts the relog too. Name: Config.Select.command |
/gmc camdebug | Camera diagnostics in F8; in game only, no permission |
#Relog (/relog)
The player goes back to character selection with their state saved. The command, the optional key (Config.Relog.key, empty by default; uses RegisterKeyMapping, rebindable in Settings > Key Bindings > FiveM) and the Relog button of the pause menu (shortcut R) only send the request: the server decides.
Flow, with no second confirmation: the server validates, the ped is frozen (controls disabled, invincible) and a countdown of Config.Relog.countdownSec seconds (5) appears. At zero the relog runs with a fade out, a wait for the scene and a fade in.
- Same blocks as
Config.Pause.changeCharacter: dead, cuffed, recent damage, in vehicle,allowedAce. - The clock is the server's. The client cannot shorten it; the server re-checks every 250 ms and repeats every rule (ACE, cooldown, vehicle) before the logout.
- Cancel: if the player dies or is cuffed meanwhile (or presses Esc/Backspace) the countdown stops and the ped is released.
- Cooldown:
Config.Relog.cooldownSec, or the pausechangeCharactercooldown. A failed logout never starts the cooldown. - Save on ESX, QBCore and Qbox: save, framework logout, then selection. If the logout is not confirmed the player stays in game.
#Staff commands /gmc
Usable from chat, server console, txAdmin and Tebex. The command name is Config.Staff.command. <target> = server ID, license:.., license2:.., fivem:.., discord:.., steam:.. or the character key. Online or offline.
| Command | ACE (prefix ghiaccio_multichar.) |
|---|---|
info <target>, log <target> [n], backup list <target> | staff.view |
slots add|remove|set <target> <n> [--days D] [reason] | staff.slots |
char lock|unlock <target> <char> [reason] | staff.chars |
char delete <target> <char> [reason] | staff.delete (confirmation code, 14-day backup) |
char wipe <target> <char> [--keep-appearance] [reason] | staff.wipe (confirmation code, 14-day backup) |
backup restore <id> | staff.restore (confirmation code) |
scene (lists loaded scenes and the ones in use) | scene |
camdebug (camera diagnostics in F8, in game only) | none |
selftest, reload, import esx|qb|qbox [--apply] | admin (import console only) |
Destructive actions print a summary and a code to confirm with /gmc confirm <code> within 60 s. From the console --yes skips the confirmation. Players cannot delete their own characters.
#gmc selftest
Checks the framework, oxmysql, migrations, invalid config (including the RPC timeout), conflicting resources, the ESX provide, Qbox (the 2 config lines and the 2 delete doors), the appearance adapter and valid scenes. Levels: error, warning, info, ok.
#Tebex integration
No API key is needed. The Tebex package runs a console command; the transaction reference makes it idempotent (one purchase = one grant):
gmc slots add fivem:{id} 1 --yes tebex:{transaction}For a player who never joined, the grant stays pending and applies on first join. For timed slots add --days 30. Set Config.Slots.unlockUrl to the package link so the "Unlock" button opens it.
#Client exports
Other resources can integrate with the pause menu:
-- Block the pause menu while your resource has its own menu open
exports.ghiaccio_multichar:SetPauseBlocked(true)
-- ...and release it
exports.ghiaccio_multichar:SetPauseBlocked(false)
-- Add an extra entry to the pause menu.
-- id <= 32 chars (the prefix "link:" is reserved), label <= 40, event <= 80.
-- Returns true on success, false if the arguments are invalid.
exports.ghiaccio_multichar:AddPauseItem({
id = 'my_menu',
label = 'My menu',
event = 'my_resource:openMenu', -- local client event, triggered with the item id when clicked
})A resource that stops releases its blocks and removes its pause items automatically.
#Server exports and events
The resource has no server exports. Its network events (client-server RPC with nonces, state and notification events) are an internal protocol and not a supported API.