Usage

Players

Placing a bag

Framework / item mode

1. Obtain the outfitbag item (name set by Config.ItemName).
2. Use the item from inventory.
3. Wait for the place progress to finish — the bag prop spawns in front of you.

Standalone mode

Set Config.Framework = 'standalone', then run:

/outfitbag

Command name is set by Config.Command. No inventory item is used.

You can own up to Config.MaxOwnedBags placed bags at once (default 1).

Opening and picking up

Interact with a placed bag:

Pick up is owner-only. After the pickup progress finishes, the item is returned (framework mode) or the bag is removed (standalone).

Outfit menu

Opening a bag shows the NUI with a live ped preview. From there players can:

• Browse saved outfits and preview them
• Change Into Outfit to equip a full look
• Toggle individual pieces (mask, hat, shirt, pants, shoes)
• Save Current Outfit
• Delete outfits (owner / edit access only)
• Lock / Unlock the bag (owner only)

Locked bags can only be used by the player who placed them.

Shared bags

When Config.SharedBagOutfits.Enabled is true and the bag is unlocked:

• Other players can open it and equip outfits
• They cannot save or delete outfits
• With GenderCheck enabled, only outfits for matching gender models are shown

Disconnecting

If you disconnect while a bag is placed, the bag is removed and the item is queued for return when your inventory can carry it again.

Back prop

When Config.BackProp.Enabled is true (and not in standalone), a bag prop attaches to the player while they carry the item.

Setup checklist

1. Start ox_lib, then your framework / inventory / clothing / target stack, then nexra_outfitbag
2. Add the outfitbag item (or enable standalone and use /outfitbag)
3. Place a bag and save a test outfit
4. Confirm equip, piece toggles, lock, and pickup work with your interaction mode