> 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/installation.md).

# Installation

Install ace\_advanced\_multipacks with ox\_inventory.

## Requirements

* [ox\_lib](https://github.com/overextended/ox_lib)
* [ox\_inventory](https://github.com/overextended/ox_inventory)

## Steps

{% stepper %}
{% step %}

### Place the resource

Copy `ace_advanced_multipacks` into your `resources` directory.

{% hint style="warning" %}
Don't rename the folder. The item exports are called as `ace_advanced_multipacks.aceopenpack_<bag>`.
{% endhint %}
{% endstep %}

{% step %}

### Set the start order

The resource must start **after `ox_lib`** and **before `ox_inventory`**:

{% code title="server.cfg" %}

```properties
ensure ox_lib
ensure ace_advanced_multipacks
ensure ox_inventory
```

{% endcode %}
{% endstep %}

{% step %}

### Add the items to ox\_inventory

Copy the contents of `ace_advanced_multipacks/inv-data.txt` into `ox_inventory/data/items.lua`.

Each entry looks like this:

{% code title="ox\_inventory/data/items.lua" %}

```lua
['backpack'] = {
    label = 'Ace Backpack',
    weight = 5000,
    stack = false,
    consume = 0,
    client = {
        export = 'ace_advanced_multipacks.aceopenpack_backpack'
    }
},
```

{% endcode %}
{% endstep %}

{% step %}

### Add the item images

Copy the images from `ace_advanced_multipacks/_Images/` into `ox_inventory/web/images/`. The file names already match the item names (`backpack.png`, `gunpack1.png`, …).
{% endstep %}

{% step %}

### (Optional) Add bags to a shop

Copy the contents of `ace_advanced_multipacks/shop-data.txt` into the `inventory` list of a shop in `ox_inventory/data/shops.lua`:

{% code title="ox\_inventory/data/shops.lua" %}

```lua
{ name = 'backpack', price = 100 },
{ name = 'fannypack', price = 700 },
-- ...
```

{% endcode %}
{% endstep %}

{% step %}

### Restart the server

Restart the whole server, not just the resource, so ox\_inventory loads the new items.
{% endstep %}
{% endstepper %}

## What's included

| Path               | Purpose                                  |
| ------------------ | ---------------------------------------- |
| `config.lua`       | Bags, ped whitelist, messages (editable) |
| `weapons_list.lua` | Item groups used by bag rules (editable) |
| `inv-data.txt`     | Generated ox\_inventory item entries     |
| `shop-data.txt`    | Generated ox\_inventory shop entries     |
| `_Images/`         | Inventory item images                    |
| `stream/`, `meta/` | Male and female bag clothing models      |