One place to change almost any Cuxial Emotes setting, manage emote zones and edit the menu data without touching files. Most changes apply immediately.
Open it with /emoteadmin. Close it with Esc or the X. The /emotezones command opens the same panel straight on the Zones tab.
Permission and command
| Option | Default | What it does |
|---|---|---|
commands.admin | name = "emoteadmin", restricted = "group.admin" | Command name and the ACE group allowed to run it |
commands.zones | name = "emotezones", restricted = "group.admin" | Command that opens the panel on the Zones tab |
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 on start |
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 and the data files become the factory values: what you change in the panel wins, and Reset puts each section back to the file value. The cuxial_emotes_settings and cuxial_emotes_audit tables are created on first start.
Tabs
| Tab | What it does |
|---|---|
| Overview | Catalog size, players online, using emotes and with an active sync, available features (relations, diseases, zones), changed sections and the latest panel activity |
| Emotes | The emotes, saving, limits and deadCheck options: blocking in vehicles, quick emotes, what is saved per player and the limits |
| Sync & commands | Paired emotes (sync), /animedit, /syncpos, command names and default keys |
| Relations | The relations options, which only act while the cuxial_emotes_dlc add-on is running |
| Interface | Accent color, blur, walking with the menu open and days of the "new" badge |
| Zones | Searchable list and a detail card per zone: name, icon, shape and emotes. Create, edit, redraw, enable, disable, delete with confirmation and Go to the zone |
| Data | Editors for data/photomode.lua (photo mode), data/tags.lua (search tags), data/manifest.lua (menu categories) and data/bypass.lua (per-character exceptions) |
| System | Resource information, startup settings, audit log with the detail of every change, and backup |
The emote catalog (data/emotes/*) is not edited from the panel.
Zones
To create a zone, press Place: the panel hides, you draw the shape in the world with the zone creator, and when you finish you return to the card to save. Changing the name, icon or emotes does not require redrawing. Go to teleports you to the center of the zone.
Opening the panel and editing existing zones does not need the cuxial_emotes_dlc add-on, but creating zones does. Without the add-on, creating a zone returns an error.
Data
Each editor validates its content before saving. The checks are:
| Section | What is checked |
|---|---|
| Photo mode | Numeric ranges, minimum below maximum, control lists and filters made of letters, numbers, _ and - |
| Tags | Lowercase words, numbers and _, 2 to 32 characters, up to 64 |
| Menu (categories) | A subset without duplicates of the factory categories; labels of 1 to 32 characters |
| Bypass | Boolean Enable and up to 500 identifiers. The factory character cannot be removed |
What applies live and what needs a restart
| Applies on save | Needs a resource restart |
|---|---|
emotes (except quickAnims), saving, deadCheck, sync, report, relations, zones.global | quickAnims, limits.setSlots, limits.setAnims |
ui (the accent shows when the menu is reopened) | commands.emote.name, commands.cancel, commands.menu, commands.set, commands.zones, commands.admin |
Photo mode, tags, bypass, and the manifest labels, icons and hideInAll | enabled and name of animEdit and syncPos, keys, admin, debug, and the manifest category order and visible categories |
Settings that need a restart are saved immediately and the panel flags them; they take effect when cuxial_emotes restarts.
Backup
Under System > Backup:
- Export all settings to a JSON file. It contains no secrets.
- Import a JSON file. Before anything is applied you get a per-section preview (unchanged, changes, invalid). If any section is invalid or the file changes nothing, nothing is imported. Every import is recorded in the audit log.
- Reset all puts everything back to the values in
shared/config.luaand thedatafolder. It asks for double confirmation.
Audit log
Every panel action (settings and data saved, reset or imported, and everything done with zones) is recorded with who, when, on what and the exact change. Filter it by action, target and actor. It is kept for admin.auditDays days.
