Core Systems

mg-multicharacter

mg-multicharacter

The first thirty seconds a player spends on your server, and every wardrobe they open for the rest of their time on it. A cinematic character selector and a complete appearance engine, in one resource.

You do not install a clothing script alongside it. The engine is built in, so both halves share one ped pipeline, one database schema and one UI. Nothing to reconcile, nothing fighting over the ped, and one thing to update.

Built for QBCore servers that would rather run one resource than a multicharacter, a clothing script, a spawn selector and an apartment script that all have to agree with each other. If your current stack is working and you like it, keep it. If you have ever spent an evening working out which of four resources reset someone's outfit, this is the one that ends that.


Character selection

  • Six cinematic camera scenes, configurable, with live character cards.
  • Portraits captured in your game, on your ped, so the cards look like your server rather than a stock render.
  • Apartment previews photographed the same way. Five addresses set up out of the box.
  • Three unlock tiers, each tied to its own Discord role, so Bronze, Silver and Gold can grant different amounts. One switch opens everything to everyone if you would rather not gate at all.
  • Per character height that carries into the world, emotes on the cards, and a spawn picker with a live camera preview of each location.

This is the screen every player sees before they see anything else you have built. It is worth having it look like yours.

Deleting a character is not the end of the world

Every other multicharacter hard deletes. The player confirms, roughly ninety tables are cascaded, and the character is gone along with their house, their vehicles and their inventory. Restoring it means rebuilding it by hand, badly.

This one flags the character instead. Nothing else is touched, so a restore brings the character back whole rather than approximately. A retention window you set (30 days by default) runs before anything is destroyed for real, and the player is told the exact number of days on a confirmation that also makes them type the character's name.

In practice: the "I deleted the wrong one" ticket stops being a rebuild and becomes two clicks in the admin panel.

The appearance engine

  • 15 clothing stores, 7 barbers, 6 tattoo parlours and the surgeon, all mapped to their real locations.
  • A photograph on every tile. Every component and prop, both genders, shot in game rather than listed as an index number. You capture these once on your own server with the included toolkit, because every server runs a different set of clothing packs and a photograph of a garment you do not have is worth nothing. Budget 30 minutes to 2 hours for this, depending on your server, and longer the more clothing packs you run. The run is automated and resumable, so you can stop it and pick up where you left off, and afterwards /mgthumbs new only shoots what you have added since.
  • 1,433 tattoos, filed under the DLC pack they actually came from, by name. Not "Pack 4547" but Bikers, After Hours, Cayo Perico and thirty three others, resolved from their collection hashes.
  • The real 64 colour GTA palette at the barber, not an approximation, and a session summary that bills only for what you actually changed.
  • Outfits, saved and shared. Saved outfits, job uniform racks, outfit rooms, and shareable outfit codes.
  • The ped undresses in the tattoo studio, so you can see where the ink is going instead of guessing behind a jacket.

Players shop by looking at clothes instead of scrolling through numbers, which is the whole difference between a wardrobe someone enjoys and one they close.

Clothing whitelisting, authored in game

Restrict any garment, prop or hairstyle to a job (optionally at or above a rank), a gang, a permission, a specific character, or nobody at all. Rules are written from the admin panel or by pressing Restrict inside any wardrobe and clicking the item. Either way it applies immediately, server wide, with no config file to edit and no restart.

Each rule can hide an item or show it locked, so you can choose between "this does not exist" and "this is something to work toward". Restricted clothing is stripped when a player loads in, so nobody keeps the uniform by logging out in it, and grants unlock automatically the moment someone joins the job or gang.

Your staff can lock down a police vest at 2am without waiting on whoever owns the config file.

Identity documents

Every character is issued two documents at creation, both carried as inventory items.

  • State Identification Card, carrying a photograph taken at the end of character creation while the ped is still posed and lit, plus name, date of birth, address, expiry, sex, eyes and height, laid out with the real AAMVA field codes.
  • Social Registry Card, carrying a registry number and a signature the player draws or types once. Re-signing is refused, because a signature you can redraw is not a signature.

Both use your own artwork. Replace one image and move the field positions, which are percentages in a single table.

Apartments

Five addresses, built in. No housing script required. Each one is a private instance with a wardrobe for your saved outfits and a stash that works with whichever inventory you run. Eleven interiors are catalogued, so you can give each address a different one or point them all at the same.

Admin panel

In game, ACE gated, no database client required.

  • Characters. Search by Rockstar licence, citizen ID, character name or Discord ID, including for players who are offline. Restore any deleted character still inside its window. Transfer characters to a different Rockstar licence, one at a time or all at once, for a new PC or a recovered account. The citizen ID never changes, so everything keyed to it survives the move intact.
  • Clothing. Every restriction on the server, with the item's photograph and what gates it. Lift one, or browse the same tile grid a shop shows and restrict something without walking anywhere.
  • Access. Slot tiers, Discord role IDs and who counts as an admin, all editable without touching a config file or restarting.

Every destructive action is behind a confirmation, and every one of them is logged. Your moderators get the tools without getting your database password.

Also included

  • Server news on the selection screen, edited in game, stored in the database, live for everyone with no restart.
  • Lobby music, plus personal stations you can sell as a perk so a VIP hears their own.
  • A capture toolkit for photographing your own clothing packs. /mgthumbs new shoots only what is missing after you add one.

Performance

Measured, not asserted. resmon 1, single player, 111 fps:

  • Character selection, with the UI and camera live: 0.05 ms
  • In world, going about your business: 0.06 ms
  • Clothing store open and browsing: 0.07 ms

Under 1% of a frame in the heaviest state. Almost nothing runs while you are simply playing: the shop zones use ox_lib zones rather than a distance check per shop per frame, and there is exactly one per frame loop in the resource. /mg-perf prints all of it on your own server, so you do not have to take my word for any of it.

Server authoritative throughout. Prices, entitlements and restrictions are decided on the server. The client is never asked what something costs or whether it is allowed.

What you can edit

The script is escrowed, but everything you need to configure it stays open: all config files, the appearance engine's settings and shop locations, the SQL, the ped and tattoo catalogues, every catalogue JSON, and every captured photograph. The thumbnails stay open because the resource writes to them itself.

Requirements

  • qb-core (QBCore only)
  • ox_lib
  • oxmysql
  • screenshot-basic (free, first party CitizenFX)
  • qb-interior (ships with QBCore, provides the apartment interiors)

ox_target or qb-target are optional and only needed if you turn targeting on.

Remove any existing appearance resource before installing: illenium-appearance, fivem-appearance, qb-clothing, esx_skin or skinchanger. This replaces all of them.


How you receive it

Delivered through Cfx.re Keymaster. After purchase the resource appears in your Keymaster account under the same Cfx.re account you buy with, ready to download. Just make sure the Cfx account you check out with is the one your server licence belongs to.

A full INSTALL.md comes with it, written to be read once and followed: what to remove first, the admin permissions, the database import, the config walkthrough, the inventory items the two ID cards need, and how to photograph thumbnails for any clothing packs you add. If you get stuck on any of it, that is what the Discord is for.

One thing to plan for. Wardrobe thumbnails are not included and cannot be, because every server runs a different set of clothing packs. Capturing them is a one-time automated job you run on your own server, and it takes roughly 30 minutes to 2 hours (depending on your server) on a stock install, longer if you run a lot of packs. Everything works before you do it; the tiles just fall back to plain icons until then.

Support

Join the Discord and open a ticket: discord.gg/pkm8pvvwK9

$55.00