Requirements
Required
qbx_core 1.24 or newer, qb-core or es_extendedomerta_bridge (in the download)ox_liboxmysqlillenium-appearance
Optional
- ox_inventory, qb-inventory or ESX’s own inventory (only for starter items)
- screenshot-basic (only for the thumbnail capture tool)
- bob74_ipl (only for the default line-up room)
Install
Put the omerta_multichar folder in your resources, and the omerta_bridge folder from the download next to it. One copy of omerta_bridge serves every Omerta script: keep the newest.
On Qbox, in qbx_core/config/client.lua, turn off qbx_core’s own character menu and its starting apartment (on QBCore or ESX, follow install/qbcore.md or install/esx.md from the download instead):
qbx_core/config/client.luacharacters = { useExternalCharacters = true, startingApartment = false, -- ...}Leave startingApartment off. When it is on, qbx_properties opens its apartment picker on every load for a citizen without a property, then the appearance menu, and hides the minimap.
Restart the whole server, not just the resource: qbx_core reads both flags at start.
In server.cfg, start omerta_bridge, then omerta_multichar, after oxmysql, ox_lib, your framework and illenium-appearance:
server.cfgensure qbx_coreensure omerta_bridgeensure omerta_multichar
Its two tables, extra slots and starter kits already given, are created at start. Characters stay in your framework’s tables. On Qbox and QBCore, illenium-appearance’s playerskins table must exist. If you already have players, run install/starter-backfill.sql once.
Settings
| Setting | What it does |
|---|---|
Config.Theme | 'amethyst' (default) or 'cyan'. |
Config.Locale | nil lets each player pick English or French; 'en' or 'fr' forces one and hides the picker. |
Config.MaxSlots | The most characters one player can have, extra slots included. 5 by default. The base count comes from the framework (on QBCore and ESX, the omerta:characterSlots convar, 3 by default). |
Config.MaxExtraSlots | The most extra slots one player can be given from the console. 4 by default. |
Config.AllowDelete | Only shows or hides the delete button; off by default. The server still lets owners delete their characters: on Qbox, install/qbx_core.md shows how to block it. |
Config.SlotsCommand | Name of the console command for extra slots. 'charslots' by default. |
Config.AdminAce | ACE group for the admin commands. 'group.admin' by default. |
Commands
| Command | Who can use it | What it does |
|---|---|---|
charslots | Server console | Lists players with extra slots. |
charslots <who> | Server console | Shows one player’s slots and characters. <who> is the server id of an online player or, online or offline, a citizenid (on ESX, the character’s identifier) or a license:, license2: or fivem: identifier. |
charslots add <who> <n> | Server console | Gives n more extra slots, for example from a Tebex package. |
charslots remove <who> <n> | Server console | Takes n extra slots back. |
charslots set <who> <n> | Server console | Sets exactly n extra slots; 0 takes them all back. |
/mcstage | Admins | Prints your position and heading as a line-up anchor line for the config. |
/mcshots [male | female | both] [category | camera | all] [force] | Admins | Captures clothing thumbnails into web/img/thumbs. /mcshots stop ends it. |
Updating
Download the new version from your Keymaster, replace the folder and keep your config.lua, your web/locales files and, if you filmed your own, web/img/thumbs.
Getting help
Open a ticket on this site or on Discord with your server artifact, framework version and the console output.
New ticket