> For the complete documentation index, see [llms.txt](https://acestudios.gitbook.io/docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://acestudios.gitbook.io/docs/inventory-and-items/advanced-multipacks.md).

# Advanced MultiPacks

Wearable bags with their own storage and item rules, built for ox\_inventory.

**Advanced MultiPacks** (`ace_advanced_multipacks`) adds wearable bags to **ox\_inventory**. Each bag has its own slots and weight, appears on the character as a custom clothing model, and can **allow** or **block** specific items, such as keeping rifles out of a fanny pack or allowing only weapons in a gun case.

|                   |                                                     |
| ----------------- | --------------------------------------------------- |
| **Resource name** | `ace_advanced_multipacks`                           |
| **Version**       | 1.4.1                                               |
| **Inventory**     | `ox_inventory` (required)                           |
| **Frameworks**    | Framework-independent (works through ox\_inventory) |
| **Dependencies**  | `ox_lib`, `ox_inventory`                            |
| **Database**      | Not used by this resource                           |

## Features

* **11 ready-to-use bags**, each with its own male and female clothing model (component 5, bags).
* **Per-bag slots and weight.**
* **Item rules per bag:**
  * `disallowedItems`: block item groups (for example large weapons)
  * `onlyAllowedItems`: allow only item groups (for example small weapons)
* **Editable weapon/item groups** in `weapons_list.lua`: small, medium, large, throwables, utility, handguns, and all weapons.
* **Bag limit.** By default a player can't carry multiple bags (`AllowMultipleBags = false`), and bags can't be stacked inside other items.
* **Ped whitelist.** Only listed ped models can use bags.
* **Automatic item generator.** Writes ox\_inventory `items.lua` entries to `inv-data.txt`.
* **Automatic shop generator.** Writes shop entries to `shop-data.txt`.
* `/fixbag` command to reapply the bag model.

## Included bags

|                                                                                                                                                                                                                                                                                 | Item name      | Label                   | Slots | Weight (config) | Item rule                              |
| :-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------: | -------------- | ----------------------- | :---: | --------------: | -------------------------------------- |
|        <img src="https://2698751888-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FeduQ6kxfGcEoMzSKJnCJ%2Fuploads%2Fgit-blob-bba1071075a8569a06851d222484db62db9cce14%2Fmultipacks-backpack.png?alt=media" alt="Ace Backpack" data-size="original">        | `backpack`     | Ace Backpack            |   10  |           10000 | Blocks large weapons                   |
|        <img src="https://2698751888-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FeduQ6kxfGcEoMzSKJnCJ%2Fuploads%2Fgit-blob-fd08e23a50875cedf0fe4e57c336e5ece4be936a%2Fmultipacks-duffelpack.png?alt=media" alt="Duffle Pack" data-size="original">       | `duffelpack`   | Duffle Pack             |   15  |           20000 | —                                      |
|         <img src="https://2698751888-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FeduQ6kxfGcEoMzSKJnCJ%2Fuploads%2Fgit-blob-d55c1e6072c39a4527be1c6a1c97668f666ebbde%2Fmultipacks-fannypack.png?alt=media" alt="Fanny Pack" data-size="original">        | `fannypack`    | Fanny Pack              |   4   |            5500 | Blocks large, medium & utility weapons |
|          <img src="https://2698751888-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FeduQ6kxfGcEoMzSKJnCJ%2Fuploads%2Fgit-blob-717c383a1e69b79dce2006107c8ef711cb2d5f00%2Fmultipacks-beachbag.png?alt=media" alt="Beach Bag" data-size="original">         | `beachbag`     | Beach Bag               |   8   |            7500 | Blocks large & medium weapons          |
|   <img src="https://2698751888-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FeduQ6kxfGcEoMzSKJnCJ%2Fuploads%2Fgit-blob-f6bd2c84221a9d6eaf9ac8a8475cdbb15285a201%2Fmultipacks-gunpack1.png?alt=media" alt="Weapon Carry Case Small" data-size="original">  | `gunpack1`     | Weapon Carry Case Small |   2   |            9000 | **Only** small weapons                 |
|   <img src="https://2698751888-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FeduQ6kxfGcEoMzSKJnCJ%2Fuploads%2Fgit-blob-69ff81a234eb03ed289d94702d812803e0184a80%2Fmultipacks-gunpack2.png?alt=media" alt="Weapon Carry Case Large" data-size="original">  | `gunpack2`     | Weapon Carry Case Large |   4   |           15000 | **Only** weapons (all groups)          |
|     <img src="https://2698751888-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FeduQ6kxfGcEoMzSKJnCJ%2Fuploads%2Fgit-blob-9584bf00c1629fb3e269a3ce1b2ab8ebcd003aa2%2Fmultipacks-hikingbag1.png?alt=media" alt="Hiking Bag Small" data-size="original">     | `hikingbag1`   | Hiking Bag Small        |   10  |            9000 | Blocks large weapons                   |
|     <img src="https://2698751888-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FeduQ6kxfGcEoMzSKJnCJ%2Fuploads%2Fgit-blob-170489743669e5aa8c071be46e349089e4496552%2Fmultipacks-hikingbag2.png?alt=media" alt="Hiking Bag Large" data-size="original">     | `hikingbag2`   | Hiking Bag Large        |   20  |           30000 | —                                      |
| <img src="https://2698751888-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FeduQ6kxfGcEoMzSKJnCJ%2Fuploads%2Fgit-blob-c8569b61160023409f3beaaa1c97d2c700551724%2Fmultipacks-acemedicbag1.png?alt=media" alt="Paramedic Bag HandHeld" data-size="original"> | `acemedicbag1` | Paramedic Bag HandHeld  |   10  |           15000 | Blocks all weapons                     |
|      <img src="https://2698751888-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FeduQ6kxfGcEoMzSKJnCJ%2Fuploads%2Fgit-blob-4f45bb50c824d1422edd98b928acbb2feba71c46%2Fmultipacks-briefcase1.png?alt=media" alt="Metal Briefcase" data-size="original">     | `briefcase1`   | Metal Briefcase         |   5   |           12000 | Blocks large weapons                   |
|     <img src="https://2698751888-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FeduQ6kxfGcEoMzSKJnCJ%2Fuploads%2Fgit-blob-1730d617259506a55fc0215644bd9b454bd69c1e%2Fmultipacks-briefcase2.png?alt=media" alt="Leather Briefcase" data-size="original">    | `briefcase2`   | Leather Briefcase       |   8   |            8000 | Blocks large weapons                   |

{% hint style="info" %}
Weights are in grams (1000 g = 1 kg). The weight of the **bag item itself** in the player's inventory is set separately in ox\_inventory's `items.lua` (see `inv-data.txt`).
{% endhint %}

{% content-ref url="/pages/8j1nPR3sEIShEuyBVrYz" %}
[Installation](/docs/inventory-and-items/advanced-multipacks/installation.md)
{% endcontent-ref %}

{% content-ref url="/pages/tqc90PGq3qAhMSiSW1g9" %}
[Configuration](/docs/inventory-and-items/advanced-multipacks/configuration.md)
{% endcontent-ref %}
