GhiaccioScripts

Multicharacter

Commands, exports & events

Staff commands, relog, exports for other resources and Tebex integration.

#Player commands

CommandDescription
/relogBack to the character selection, with a server-side countdown. Name: Config.Relog.command
/personaggiStarts the relog too. Name: Config.Select.command
/gmc camdebugCamera 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 pause changeCharacter cooldown. 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.

CommandACE (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):

text
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:

lua
-- 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.