> For the complete documentation index, see [llms.txt](https://docs.menanak47.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.menanak47.com/multi-framework/ak47_outfitbag.md).

# ak47\_outfitbag

The ultimate portable wardrobe experience for FiveM servers.

{% embed url="<https://youtu.be/t0TvVg8wWUA>" %}

This script completely revamps outfit and clothing management with portable outfit bags, sleek interactive menus, unique bag metadata, and full outfit sharing mechanics. Powered by `ak47_lib`, it features multi-framework support, customizable bag tiers, gender detection, and target interactions.

***

### 🔥 Key Features

Designed to improve roleplay immersion and convenience across your server:

#### 🎒 Portable Wardrobes On The Go

* **Deploy Anywhere:** Carry outfit bags in your inventory and place them down anywhere in the world with realistic placement animations and progress bars.
* **Multiple Bag Tiers:** Configurable bag types including Small Outfit Bag (5 slots, duffel bag prop) and Large Outfit Bag (10 slots, large outfit bag prop).
* **Anti-Clutter Collision Check:** Built-in distance detection prevents placing multiple bags on top of each other.

#### 👔 Seamless Outfit Management

* **Save Current Clothes:** Quickly save your current outfit (including masks, torso, pants, shoes, bags, vests, and props) directly into the bag.
* **Custom Outfit Naming:** Name each saved outfit with an intuitive input prompt.
* **Instant Outfit Changing:** Switch outfits on the spot with smooth changing animations and progress bar feedback.
* **Safe Outfit Deletion:** Owners can easily remove outfits with an alert confirmation to prevent accidental deletion.

#### 🔒 Unique Bag & Sharing Mechanics

* **Item-Bound Metadata (Unique Bag):** Stored outfits can be tied directly to the bag item itself. If the bag is traded, sold, or stolen, all saved outfits stay inside the bag!
* **Wardrobe Sharing:** Large bags allow the owner to toggle between "Share Bag" and "Make private", giving nearby friends or crew members access to view and wear outfits.
* **Owner Permissions:** Only the owner has permission to pick up the bag, toggle sharing privacy, or delete saved outfits.

#### 🚻 Smart Gender Detection

* **Visual Indicators:** Recognizes whether an outfit is Male or Female and displays dedicated color-coded icons (blue Mars / pink Venus).
* **Glitch Prevention:** Restricts players from equipping outfits of the opposite gender, preventing invisible body parts or broken ped models.

#### 👗 Wide Clothing Script Compatibility

* Works out of the box with the most popular clothing resources:
  * `illenium-appearance`
  * `fivem-appearance`
  * `qb-clothing`
  * `codem-appearance`
  * `esx_skin`
* Open bridge files allow you to easily adapt to any custom clothing resource.

#### 🛠️ Technical Excellence

* **Multi-Framework:** Seamlessly works with ESX, QBCore, and QBX.
* **Target Support:** Compatible with `ox_target`, `qb-target`, and `qtarget`.
* **Auto-Despawn System:** Automated cleanup thread removes unattended bags after a configurable timeout to keep your server clean and optimized.
* **Automatic Database Setup:** Automatically creates the required MySQL table on startup with zero manual SQL execution required.

***

### 💻 Framework:

* ESX, QB, QBX

***

### ⚙️ Dependencies:

* ak47\_lib: <https://github.com/MenanAk47/ak47_lib/releases/latest>

***

### ⚙️ How To Install:

* Download ak47\_outfitbag from your cfx portal.
* Add the script in your resources folder.
* Add items based on your framework instruction.
* Add item images into inventory.
* Start the script in your server.cfg below framework files.
* Make sure you have all dependencies.
* Restart the server.

***

### 🔗 Links & Support:

* **📖 Documentation:** <https://docs.menanak47.com/multi-framework/ak47_outfitbag>
* **🛒 Buy Now (Tebex):** <https://menanak47.tebex.io/package/6543504>
* **💬 Discord Support:** <https://discord.gg/menanak47>

***

### 📝 Note:

* We don't support custom framework. Make sure you are using official framework update.
* Renaming the script is not allowed. It may break the functionalities.
* Don't upload the script with FileZilla, Use Winscp if you are using FTP for file uploading