Skip to content

Staff panel

The Cuxial Multichar admin panel: minors, players, character slots, loading screen, registration, scenes and backups, all live.

One place to review minor requests, manage an account's characters, grant extra slots, edit the loading screen and change almost any setting of the resource without touching files or restarting.

Open it with /mcadmin, in game and also from the character selection. Close it with Esc or the X.

Permission and command ​

OptionDefaultWhat it does
commands.adminname = "mcadmin", restricted = "group.admin"Command name and the ACE group allowed to run it
admin.permission"admin"Permission the server checks on every panel action, through Bridge.HasPermission
admin.auditDays90Days the audit log is kept. It is purged automatically every night

You need both: the command's group and the permission. Without the permission the server rejects every panel action even if the command opens.

The panel stores its settings in the database. shared/config.lua becomes the factory value: whatever you change in the panel wins, and Reset returns each section to the file's value. The tables cuxial_multichar_settings, cuxial_multichar_slots, cuxial_multichar_accounts and cuxial_multichar_audit are created on first start.

Settings marked needs restart (for example command names) are saved immediately but only change when the resource restarts. Everything else applies live.

Tabs ​

TabWhat it does
OverviewPending minor requests, who is on the loading screen or in the selection right now, and the latest panel actions
MinorsList of requests by status with search. Approve, reject or revoke (rejecting and revoking require a reason) and adjust each minor's height growth
PlayersFind an account by name, citizenid, license or Discord, including offline accounts. Profile with their characters, slots and a breakdown of why they have that number. Actions on a character: send to the selection, rename, move to another license and delete
SlotsDefault slots and cap, plus rules by license, character, Discord user or Discord role. Includes a tester to see how many slots an account would get
Loading screenStart key, tips, key guide, music, background (video or image) and interface texts, with a preview
RegistrationLimits of the creation form and ID card, minor characters, starter items and nationalities
ScenesSelection locations, spawn points, scene vehicles, time and weather. Points are placed in the world with a cursor and can be visited
SystemResource information, Discord logs, audit with the detail of every change, and backup

Every action on a character asks for confirmation and is stored in the audit log with the old and new value. If a logs webhook is set, Discord is notified too.

Character slots ​

Each account gets as many slots as the highest value given by any of these sources, never above the characters.maxSlots cap:

SourceWhen it counts
DefaultAlways: characters.slots
Discord userTheir ID is in discordSlots.users
Discord roleThey have a role from discordSlots.roles (needs the bot configured and the player online)
License ruleA rule exists for their license
Character ruleA rule exists for the citizenid of any of their characters. The rule travels with the character if it moves account
Discord ruleA rule exists for their Discord ID. Also works with the player offline
Role ruleA rule exists for a Discord role they have. Only with the player online and the bot configured

Rules in the Slots tab count even if discordSlots.enabled is false.

Lowering an account's slots hides the extra characters, it does not delete them. The selection shows the first ones by creation order, and hidden ones cannot be loaded or deleted. Raise the slots again and they come back. In the player profile they are marked "Hidden by slots".

The tester accepts a license, a citizenid or a Discord ID, and shows the winning source, the slots used and the hidden characters. With the player offline, Discord roles show as unknown.

Loading screen ​

Changes apply to the next connection, without restarting the resource.

  • Start key: the key the player presses to "Start". It is picked from a list of valid keys; the default is Enter (loading.startKey). Space no longer starts the loading screen unless you pick it.
  • Music and background: each track and the background accept two kinds of media.
MediaHow to add it
Resource fileCopy the file to web/public/sounds/music, web/public/video or web/public/img, run pnpm build and pick it in the panel list. Only files that exist after building are offered
LinkA direct https:// address to the file. http://, spaces and odd characters are rejected

Use .webm video and .ogg audio. music.shuffle (on by default) starts from a random track.

Backup ​

In System, the backup tab lets you:

  • Export all settings to a JSON file. It contains no secrets: the saved webhook is not exported.
  • Import a JSON. Before anything is applied you get a preview per section (unchanged, changes, invalid). If any section is invalid or the file changes nothing, nothing is imported. Every import is stored in the audit log.
  • Reset everything returns all settings to the values in shared/config.lua and the data folder. It asks for double confirmation and also removes the saved webhook.

Audit ​

Every panel action (saved settings, minors, characters, slot rules, teleports, imports) is recorded with who, when, on what and the exact change. Filter by action, target and who did it. Entries are kept for admin.auditDays days.

Discord logs ​

In System > Logs you can save the webhook from the panel. The saved webhook wins over the cuxial_multichar_webhook convar; if neither exists nothing is sent. For safety the panel never shows the saved address again: it can only be replaced or removed.

© Cuxial