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
| Option | Default | What it does |
|---|---|---|
commands.admin | name = "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.auditDays | 90 | Days 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
| Tab | What it does |
|---|---|
| Overview | Pending minor requests, who is on the loading screen or in the selection right now, and the latest panel actions |
| Minors | List of requests by status with search. Approve, reject or revoke (rejecting and revoking require a reason) and adjust each minor's height growth |
| Players | Find 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 |
| Slots | Default 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 screen | Start key, tips, key guide, music, background (video or image) and interface texts, with a preview |
| Registration | Limits of the creation form and ID card, minor characters, starter items and nationalities |
| Scenes | Selection locations, spawn points, scene vehicles, time and weather. Points are placed in the world with a cursor and can be visited |
| System | Resource 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:
| Source | When it counts |
|---|---|
| Default | Always: characters.slots |
| Discord user | Their ID is in discordSlots.users |
| Discord role | They have a role from discordSlots.roles (needs the bot configured and the player online) |
| License rule | A rule exists for their license |
| Character rule | A rule exists for the citizenid of any of their characters. The rule travels with the character if it moves account |
| Discord rule | A rule exists for their Discord ID. Also works with the player offline |
| Role rule | A 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.
| Media | How to add it |
|---|---|
| Resource file | Copy 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 |
| Link | A 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.luaand thedatafolder. 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.
