Installation

ML Clothing is a clothing and armor system with a bundled advanced inventory addon. Clothing pieces, armor plates, and bags are real inventory items that equip into fixed slots. Persistence of worn appearance is delegated to your appearance script or to inventory item metadata; the resource itself creates no clothing table.

Quick Start

Place ml_clothing in your resources folder and start it after its dependencies.

1ensure oxmysql
2ensure ox_lib
3ensure ml_bridge
4ensure ox_inventory
5ensure ml_clothing

The ox_inventory line is the included advanced inventory that ships with the product. It is not a separate download.

Database

ML Clothing does not create a clothing or appearance table. Worn outfits are saved through the detected appearance script, or through inventory item metadata when running in native mode.

The one table the resource creates belongs to the admin panel audit log. It is created automatically on first start; no manual SQL import is required.

1CREATE TABLE IF NOT EXISTS ml_invadmin_audit (
2    id INT NOT NULL AUTO_INCREMENT PRIMARY KEY,
3    created_at TIMESTAMP NOT NULL DEFAULT CURRENT_TIMESTAMP,
4    admin VARCHAR(64),
5    admin_src INT,
6    action VARCHAR(64),
7    detail TEXT
8)

Item Registration

The clothing pieces, armor plates, and bag are inventory items. Register them in your inventory items file. The item definitions ship in _INSTALL/items.lua, and matching icons ship in _INSTALL/images/.

Clothing items (each stack = false, close = true):

• hat: Hat, 300 g
• mask: Mask, 200 g
• glasses: Glasses, 100 g
• earrings: Earrings, 50 g
• chain: Chain, 100 g
• watch: Watch, 150 g
• bracelet: Bracelet, 100 g
• undershirt: Undershirt, 250 g
• jacket: Jacket, 500 g
• bodyarmor: Body Armor, 1500 g
• gloves: Gloves, 150 g
• pants: Pants, 400 g
• shoes: Shoes, 600 g
• bag: Bag, 800 g
• decals: Decals, 50 g

Armor plate items (each stack = true, close = true):

• lightplate: Light Plate, 500 g. 25% armor when inserted in a plate carrier
• heavyplate: Heavy Plate, 1200 g. 50% armor when inserted in a plate carrier
• brokenplate: Broken Plate, 400 g. No protection, can be repaired

Verify

Start the server and confirm the resource comes up without errors. With Config.Debug = true you should see the appearance detection line in the server console, for example:

1[SERVER] Detected appearance script: bl_appearance

or, when no appearance script is running:

1[SERVER] No appearance script detected, using native mode

Then in game:

• A clothing item (for example jacket) equips into its fixed slot when used, and the ped component updates.
• bodyarmor opens a plate carrier stash where plate items can be inserted.
• A bag opens its own stash sized from the bag drawable.