Lumo Clothing

Clothing, barber and tattoo shops, outfits and the character creator with a live 3D preview.

Version 1.0.3 · Frameworks QBCore · Qbox · ESX · standalone · Requires oxmysql, ox_lib

Installation · Config files · Exports & events · Changelog

Clothing, barber and tattoo shops, outfits and the first-time character creator, with a live 3D preview and a themed React interface.

QBCore · Qbox · ESX · Standalone (detected automatically) · by Lumo · https://lumo-server.tebex.io/

Version 1.0.0 · one folder, no lumo-bridge or any other Lumo resource needed

---

Features

• Clothing, barber and tattoo shops with a live preview camera, categories, search, colours and textures
• Character creator for new characters (face, heritage, hair, features, clothes)
• Outfits: save, rename, favourite, delete; separate per character
• Shop owners: players can own shops, set a price margin, manage stock
• Admin panel (/lumo_admin): add, move, enable and price shops and items in game
• Job lockers: grade-aware duty uniforms for police, EMS, mechanics …
• RP systems (each can be switched off): clothing ownership, wear and dirt with laundromats, brand tiers, clothing descriptions as police evidence, property wardrobes, clothes as inventory items (take off, trade, wear), hair ties and a hat-clipping fix
• Tables created automatically on first start (MariaDB and MySQL 8), with default shops
• Drop-in replacement for qb-clothing: keeps the qb-clothing: events, the playerskins table and the qb-clothes:client:CreateFirstCharacter creator event
• ESX: answers the esx_skin / skinchanger events, so ESX job cloakrooms keep working
• Standalone: works with no framework; shopping is free unless you plug in your own money (see Standalone)
• Catalog thumbnails taken in game with lumo-greenscreener (included as its own zip, free and GPL; only needed while you take pictures)

Requirements

Resource	Needed?
oxmysql	Required
ox_lib	Required (menus, progress bars, prompts)
qb-core / qbx_core / es_extended	Optional, detected automatically (standalone works too)
An inventory	Optional. Only for clothes-as-items and the hair tie / detergent items
ox_target / qb-target / lumo-interact	Optional. Without one, an [E] prompt is used
lumo-greenscreener (included zip)	Optional. Only while taking catalog pictures; start it before lumo-clothing (how)
lev_laundromat (free MLO)	Optional. The default laundromat location

Installation (short version)

1. Put the lumo-clothing folder in your resources folder.
2. Stop the clothing script you are replacing: qb-clothing, illenium-appearance, fivem-appearance, or on ESX esx_skin + skinchanger. Only one appearance script may run.
3. In server.cfg, after oxmysql, ox_lib and your framework, and before your character selector / spawn:

   ensure oxmysql
   ensure ox_lib
   ensure qb-core            # or qbx_core / es_extended / nothing
   ensure lumo-clothing
   ensure lumo-multicharacter # or your character selector

4. Start the server. The tables and default shops are created on their own. The console shows:

   [lumo-clothing] database tables ready

Full step-by-step guide for every framework: Installation.

Commands

Command	Who	What
/lumo_admin	Admin	Shop and item admin panel
/openshop [id]	Admin	Open a shop from anywhere
/testcreation [0/1]	Admin	Open the character creator (male/female)
/giveclothing [id] [slot] [drawable] [texture]	Admin	Give a garment item
/washmachine	Admin	Save a washing machine spot where you stand
/lumo_debug on/off	Admin / console	Debug logging
/takeoff [slot], /wear [slot], /undress	Everyone	Clothes as items
/hairtie	Everyone	Tie hair back
/describe [id] [ref]	Police on duty	Clothing description as evidence

Admin = the framework's admin/god group (QBCore, Qbox, ESX), the ACE permission lumo.clothing.admin, or in standalone the ACE group group.admin:

add_ace group.admin lumo.clothing.admin allow

Configuration

Two files, both left readable in every edition:

• shared.lua: shops, prices, the creator, job lockers, every RP system, theme colours. Each section is commented.
• bridge/config.lua: framework layer: force a framework, inventory and target choice, standalone money and jobs. Most servers never touch it.

Performance mode (no shop peds, markers or blips; shops through commands/exports):

setr lumo:perf 1

For developers

• Keeps qb-clothing's events: qb-clothing:client:loadPlayerClothing, qb-clothing:client:loadOutfit, qb-clothes:client:CreateFirstCharacter, and the playerskins / player_outfits tables.
• Client exports: OpenCharacterCreation(gender), IsCharacterCreationActive(), OpenShop(shopId, type), OpenWardrobe(), GetSkin(), ReloadSkin().
• RP-system exports and events: Features.

Troubleshooting (top 5)

• Two clothing menus / skin resets after spawn: another appearance script still runs. See step 2 above.
• Console says framework: standalone on a QBCore/Qbox/ESX server: your core starts after this script. Ensure it first.
• No shops on the map: check the console for database setup lines; with setr lumo:perf 1 there are no peds or blips by design.
• Taking clothes off does nothing on ESX: ESX's own inventory cannot hold item metadata; use ox_inventory, or switch Lumo.ClothingItems off.
• New characters spawn without the creator: the character selector must start after lumo-clothing.

More in Support.

Docs

• Installation, every framework
• Feature reference (RP systems, exports)
• Standalone mode
• Troubleshooting and support
• Changelog

Build the interface (open-source edition)

The compiled UI ships in web/dist/, so servers need nothing installed. To change it:

cd lumo-clothing/nui
npm ci
npm run build

Store, updates and other releases: https://lumo-server.tebex.io/