Installation

Requirements

OneSync.
ug-core with the characters module enabled. The accounts, jobs and gangs modules are optional: without accounts everything is free, without jobs and gangs there are no job stores or uniforms.
ug-lib, for store points, prompts, key bindings and the shared theme.
oxmysql. The resource creates its tables, ug_appearances and ug_outfits, on the first start.

Download

Download ug-appearance-vX.Y.Z.zip from the releases and extract it into your resources folder, for example resources/[ug]/ug-appearance.

Building from source

The repository does not contain the built page. Build it once with Node.js 20.19 or newer:

cd resources/[ug]/ug-appearance/web
npm ci
npm run build

The build goes to web/dist, which the manifest serves.

Start order

server.cfg

ensure oxmysql
ensure ug-lib
ensure ug-core
ensure ug-appearance
ensure ug-multicharacter

Start ug-appearance before ug-multicharacter. Character selection then uses the creator and shows every character in its own look. See Character selection. To let staff open the full editor on any player, grant the ACE:

server.cfg

add_ace group.admin ug-appearance.admin allow

Run only one appearance resource. Others that set ped components, open clothing menus or save skins conflict with this one.

First start

The server console prints:

[INFO] Generated config.lua.
[ug-appearance] v1.0.0 ready: 28 stores, 2 models.

When a player opens a store or saves, their F8 console prints:

[ug-appearance] Editor opened: clothing.
[ug-appearance] Saved clothing for 160.

When something is wrong, the resource logs every problem and stays idle instead of half working:

[ERROR] config.lua: unknown key "maxOutfit". Did you mean "maxOutfits"?
[ERROR] Config invalid: 1 error(s). ug-appearance stays idle.

[ERROR] ug-core's characters module is disabled. Enable it in ug-core's config/modules.lua.
[ERROR] ug-appearance stays idle.

The default store coordinates are the game’s shop doors. Check each one on your server and move the ones your map changes. See Stores and uniforms.

Getting started

Server owners

Requirements

Download

Start order

First start

​Requirements

​Download

​Start order

​First start

Requirements

Download

Start order

First start