Jixryo Clothing

Jixryo Clothing is the resource jixryo_clothing, version 1.2.1. Clothes are ox_inventory items worn in the inventory's WEARING, Armour and Bag slots. GTA's clothing stores have a live try-on with a camera, a cart and a server-priced checkout. Your own clothes wait in a wardrobe with saved outfits and an outfit bag, jobs keep uniforms at their lockers, new characters get a character creator, barbers, the plastic surgeon and ped shops change how you look, and a body clinic for height and build is built but switched off. With illenium-appearance off the server it takes its place: the same saved looks in the same table, its exports, events and callbacks, so character select and other scripts keep working with no data moved.

The README is plain that the appearance (phase 4) and vests, bags, decals, wardrobes, outfits and uniforms (phase 5) have been tested out of game only. The in-game checks at the end of this page are the list to run on a test server before going live.

#What players get

• Clothes are items. One unique item per kind: clothing_top, clothing_undershirt, clothing_pants, clothing_shoes, clothing_hat, clothing_glasses, clothing_ears, clothing_mask, clothing_neck, clothing_watch, clothing_bracelet, clothing_gloves and clothing_vest, each carrying what it is (GTA's own name where the game has one, the model it fits, the store and price). Worn means in its WEARING slot (1009 to 1020); a vest sits in the Armour slot (1005). Drag it out and it comes off; drag it in, right click Wear or use it and it goes on. Bags, stashes, trunks, trades and searches treat them like any item.
• Vests, bags and decals. A vest (GTA's component 9) is worn in the Armour slot: it looks the part and stops nothing. A bag (component 5) is the backpack in the Bag slot: one bought in a store carries its look, a plain backpack draws none, and a bag never goes in a bag. A decal (component 10: badges, emblems, numbers) goes on the top you leave the store wearing and stays with that top.
• Every ped can wear clothes. GTA's two online models and any other ped (story characters, GTA's peds, add-on peds). A piece fits the model it was bought on ("Made for women."); other peds have no bag.
• Fifteen clothing stores, GTA's own (Binco, Discount Store, Suburban, Ponsonbys and a La Puerta store): walk to the counter and press E, or third-eye the clerk. Every drawable and colour of every kind the store sells (vests at budget stores, bags and decals everywhere but masks), with GTA's own names, filters by type (Hoodies, Tees, Jeans, Sneakers and so on), colour swatches and NEW on the newest collection. Live try-on, a camera that frames what you browse (drag to turn, scroll to zoom, it keeps out of walls), GTA Online's store animations, favourites kept on your PC, a cart with wear now or bag it per piece, keep or leave your old clothes, cash or bank, hold E to pay. Leave without paying and you are back in what you came in with.
• Taking things on and off: the inventory, the Clothing ring in the radial menu, and /hat, /glasses, /ear, /mask, /neck, /top, /shirt, /gloves, /watch, /bracelet, /pants, /shoes and /vest. Each takes that piece off into your pockets (or the bag when they are full) or puts the one you took off last back on, with GTA's own gesture. No item messages for your own clothes going on and off.
• Your wardrobe: one per character, the same wherever it opens (a wardrobe point, a house's wardrobe, the outfit bag). It holds clothes, vests and armour, and bags only when empty. Its page lists every piece you have for the ped you are on, wherever it is (on you, pockets, bag, wardrobe): pick one to see it on, Enter puts it on for real and what you had on goes in, X then Enter puts a kind away, I opens it as an inventory to move many at once.
• Outfits: save what you wear (N), wear one in one go (Enter: its pieces come out of your wardrobe, pockets or bag, kinds it leaves bare are put away, a piece you no longer have is named), delete (Del). In a store they only show on you. Up to 30 per character.
• The outfit bag: use it standing still, it goes down in front of you and your wardrobe opens; closing picks it up.
• Job uniforms: at the job's lockers pick a uniform to see it on you, Enter puts it on (your own clothes go in your wardrobe), "Your own clothes" gives it back. Uniform pieces are made for you and locked to the job: no dropping, giving, storing or taking them off you. Off duty or out of the job, the uniform goes back by itself.
• The character creator (new characters only, alone in a routing bucket, then back in the one they came from): man or woman (or a listed ped), parents and resemblance, the 20 face features, hair, brows, facial hair, makeup and the other details, eyes, first clothes (free, as items), height and build when the clinic is on, then a review and hold E. Saved once.
• Seven barbers at illenium's spots (hair, beard, brows, makeup, chest hair) and the plastic surgeon at Pillbox Hill (parents, face, skin, eyes). Each part you change has its own price, you see the total before you pay, and leaving without paying puts your face back.
• Ped shops (none until you place one): become a ped from the shop's list for its price. Each ped keeps its own look, and your own character is always offered back, free.
• /reloadskin puts your saved look back on (once illenium is off the server).

#What staff get

For group.god, group.admin or the ACE jixryo.clothing:

Every staff change, outfit save and uniform change goes to Jixryo Core's audit log.

#Install

1. The Jixryo ox_inventory fork is needed. Its slot layout file in its data folder has the WEARING slots 1009 to 1020 and the Armour and Bag slots; its clothing items file has the clothing items with clothing_vest; and its two quiet-move exports move your own clothes without item messages. An older fork without the quiet moves still works: the console says so once and the messages show.

2. Order in server.cfg.

   ensure ox_lib
   ensure oxmysql
   ensure qbx_core
   ensure ox_inventory
   ensure jixryo_core
   ensure jixryo_clothing

   Copy

3. qbx_radialmenu: in its client config remove the Clothing submenu (id = 'clothesMenu' under General) and empty clothingCommands. They change clothes with raw natives, past the items, and register the same command names.

4. The outfit bag: stop the old outfit bag script (wasabi's or qs-outfitbag). This resource takes the outfitbag item's use through qbx_core, which keeps one use per item: whichever starts last wins.

5. Deleting a character deletes their outfits too: add {'jixryo_clothing_outfits', 'citizenid'} to characterDataTables in qbx_core's server config.

6. Wardrobes and lockers: add your wardrobe points (motels, apartments) to Config.wardrobe.points and each job's lockers to Config.uniforms.lockers. None are set. House wardrobes need nothing: they open through illenium's outfit-menu events once illenium is off.

7. Replacing illenium-appearance: below.

8. Staff: add_ace group.admin jixryo.clothing allow (or rely on group.god and group.admin, which Config.staff already lists).

9. If your respawn clears inventories (wasabi_ambulance and the like), add the clothing_* items to its keep list, or people respawn in their underwear.

10. Items. The clothing items come from the fork's clothing items file; vests and bags are the inventory's own armour and backpack items too. Nothing to add by hand.

11. The database. The tables jixryo_clothing_outfits, jixryo_clothing_uniforms, and playerskins on a server that never had illenium, are made on the first start through Jixryo Core's migrations (three steps).

12. Restart the whole server after updating this resource, not just the resource: other scripts keep the exports they found when they started.

Replacing illenium-appearance. While it runs, it keeps the looks (creator, barbers, surgeon, saved skin, its outfit menus) and this resource does the clothing, wardrobes and lockers, keeping the saved skin's clothes equal to the worn items. Once it is off the server this resource does everything (the console says which at start).

1. Remove ensure illenium-appearance from server.cfg and delete or move its folder. Keep its tables: looks stay in playerskins in the same format.
2. Restart the server.
3. On each character's first login the clothes in their saved skin become items in their slots, once per character. A vest becomes a clothing_vest, a decal goes on their top, a bag only gives its look to the bag they wear.
4. Type clothing importuniforms in the server console once: illenium's management_outfits become uniforms at the job's lockers (the online models; ones already there are skipped).

Config.appearance.enabled = false keeps this resource on clothing only even with illenium gone, for servers with another appearance script.

#How other scripts' calls behave

The manifest declares provide 'illenium-appearance': scripts asking for illenium's resource state, exports and events get this resource once illenium is off the server.

Its own server exports:

Client export: useClothing(_, slot) is the clothing items' client.export in the fork's items file: on from the pockets, off when used in its slot.

#Its own API

Callbacks (ox_lib, client to server):

Events:

State: GlobalState.jixryoAppearance is true while this resource does the looks; the player state bag jixryoBody carries height and build while the clinic is on.

Database: playerskins (illenium's, one row per ped model, one active), jixryo_clothing_outfits (sets of your own pieces by item id), jixryo_clothing_uniforms (a job's uniforms with the lowest grade that may take them). The character's own record (migrated, starter, created, body, uniform) is qbx metadata under jixryo_clothing. Each character's wardrobe is an ox_inventory stash owned by their citizen id.

Audit actions: clothing.buy, clothing.starter, clothing.create, clothing.look, clothing.ped, clothing.body, clothing.migrate, clothing.outfit_save, clothing.uniform_on, clothing.uniform_off, clothing.uniform_save, clothing.uniform_delete, clothing.staff_give, clothing.staff_starter, clothing.staff_creator, clothing.staff_ped.

#Commands and keybinds

The resource registers no key mappings; the prompts read E directly while you stand at a counter.

#Configuration

config.lua is read by the client to show things and checked again by the server on every action.

#Security

• Every action is checked on the server from source: who is asking, that they are still at the store, shop, wardrobe or lockers (within 8 m), what that place sells or changes, the model they are on, and the money.
• Prices are the server's. Each piece, part or ped is priced again from config; the page never sends a price, and a total higher than the one the page showed is refused. Money is taken first; if anything after fails it is refunded and nothing is given. A decal is refused before any money moves when there is no top of yours to put it on. One checkout or save at a time per player, with a nonce so a double click cannot pay twice.
• A barber takes only hair, beard, brows, makeup and chest hair from the page; the surgeon only parents, face, skin and eyes; everything else stays as saved. The clothes in a saved look always come from the worn items.
• The creator saves once per character (or again after staff /clothing creator), only on a man, a woman or a listed creator ped, and only the model the server sees them as. No tattoos from a client.
• The fit check: a piece made for another model cannot go on, through the inventory, the commands or a script. Locked uniform pieces never leave their wearer: no drop, give, stash, trunk or bag, and nobody takes them off you. The blacklist's wear rules stop found pieces going on.
• The wardrobe holds clothes, vests and armour, and empty bags only, and opens as an inventory only from its own page. Outfits are only ever your own pieces, found by item id. Uniforms: only the job's people from the uniform's grade up take one; only its boss saves or removes them.
• Saves write only model names to playerskins, never a hash. illenium's client-side save and charge events are ignored.
• Known limit: a house's wardrobe or a job's clothing room opens through another script's client event, so the server cannot know where the player stands (Config.wardrobe.fromScripts = false turns those off). It only ever opens their own clothes, or their own job's uniforms.
• Rate limits through Jixryo Core on opening pages (one a second), the clothing commands (the cooldown), the saved-look call and the layout report, and locked calls for the till, the looks, the clinic and the wardrobe.

#Tests

Both suites were run on 2026-10-31.

cd dev-tools/luarun && node run.mjs ../../jixryo_scripts/jixryo_clothing tests/jixryo_clothing.lua

cd dev-tools/luarun && node tests/jixryo_clothing.client.mjs ../../jixryo_scripts/jixryo_clothing

The README adds that each new rule was proven to fail its test when broken, and that luacheck, the native audit and the config paths are clean.

#Check it in game

On a test server, with a staff account:

1. Arms and gloves: put on a few tops, then gloves; /clothing fit prints what the game reports. If bare arms show as gloves or gloves are missing, set Config.gloves.first to the first arms drawable that is a glove.
2. La Puerta is not one of GTA's branded stores: see what is there and set its brand and level.
3. Every store, barber and the surgeon: the prompt shows at the counter or chair and the camera does not sit in a wall. Move a clerk or coords where it does.
4. A new character: the creator opens after the screen fades in, alone in its bucket. The parents' portraits show, each face slider's end labels match what the face does, eye makeup takes a colour, every eye colour shows (the surgeon offers 31; GTA lists a 32nd, untested), first clothes become items, then you land with everyone.
5. Barber and surgeon: change two parts, check the total, pay, relog: the new face is there. Change something and walk away: it goes back.
6. Character select shows each character as they look, clothes included.
7. Taking clothes off and on shows no item messages (if it does, the fork is older than its quiet moves).
8. Vests, bags, decals: buy a vest at a Binco (on in the Armour slot; your armour goes to your pockets), a bag with and without one on, a decal on your top; take the top off and on (the badge comes with it); relog (all still on).
9. Wardrobe and outfits: at a wardrobe point and a house's wardrobe, put a piece on and away, save an outfit, change, wear it again; "Open as inventory"; the outfit bag goes down in front of you and comes back up.
10. Uniforms: as a boss save one; as an officer take it, try to drop or give a piece (refused), go off duty (your own clothes come back).
11. Height and build (Config.body, off): turn it on, then shoot the visible head of a short and a tall character at 5, 20 and 50 m, from the front and the side; melee; get in and out of vehicles. Every head shot must land. If any miss, narrow the ranges and test again; leave it off if they still miss.
12. Ped shops: pick each spot in game, add the shop with its peds, and try one on, buy it and switch back.

If character select prints attempted to load invalid model '<number>', a playerskins row's model is not on your server (an add-on ped you removed). Find it with SELECT citizenid, model FROM playerskins WHERE active = 1; and fix or delete that row.