> For the complete documentation index, see [llms.txt](https://docs.northscripts.dev/site/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.northscripts.dev/site/documentation/resources/ox-inventory-rework/admin-guide.md).

# Admin guide

#### Commands

| Command                      | Syntax                                                                     | Permission                                    |
| ---------------------------- | -------------------------------------------------------------------------- | --------------------------------------------- |
| `/giveitem` (`/additem`)     | `<id> <item> [count] [type]`                                               | `group.admin`                                 |
| `/removeitem`                | `<id> <item> [count] [type]`                                               | `group.admin`                                 |
| `/setitem`                   | `<id> <item> [count] [type]`                                               | `group.admin`                                 |
| `/givecloth`                 | `<id> <slot> <drawable> <texture>`                                         | `group.admin` (only when clothing is enabled) |
| `/takeinv`                   | `<id>` — confiscates the inventory                                         | `group.admin`                                 |
| `/restoreinv` (`/returninv`) | `<id>` — gives back what was confiscated                                   | `group.admin`                                 |
| `/clearinv`                  | `<invId \| me>` — wipes everything, **worn clothing included**             | `group.admin`                                 |
| `/clearinvitems`             | `<invId \| me>` — wipes items but **keeps worn clothing and the backpack** | `group.admin`                                 |
| `/saveinv`                   | `[true]` — saves every inventory; `true` also locks them until restart     | `group.admin`                                 |
| `/viewinv`                   | `<invId>` — read-only look at any inventory                                | `group.admin`                                 |
| `/clearevidence`             | `<locker>`                                                                 | police boss                                   |
| `/trunkmapping`              | `<model>`                                                                  | see 6.3                                       |
| `convertinventory`           | `esx \| esxproperty`                                                       | server console                                |
| `/trunkdebug`                | —                                                                          | client, only when `Config.Debug = true`       |

`/givecloth` slots are `hat`, `glasses`, `mask`, `chain`, `tshirt`, `torso`, `pants`, `earrings`, `bulletproof`, `backpack`, `arms`, `watch`, `gloves`, `shoes`.

Example: `/givecloth 12 torso 15 0`

`giveitem`, `removeitem`, `setitem` and `givecloth` are sent to the `admin` Discord log.

#### &#x20;Permissions (ACE)

```cfg
add_ace group.admin group.admin allow
add_principal identifier.license:xxxxxxxx group.admin
```

#### Trunk mapping

Vehicles without a mapping use an estimated trunk size (`Config.Trunk`). For a precise fit, map the trunk:

1. `/trunkmapping sultan`. The vehicle spawns in front of you with the boot open.
2. **Left mouse** drags a face of the box, **Shift + drag** moves the whole box, **Ctrl** snaps to 5 cm, and **right mouse** looks around.
3. **Enter** saves, **Del** resets to the default, and **Backspace** cancels.

The mapping is saved in `data/trunkmapping.json` and sent live to every player.

Who can use it (any one of these is enough):

* ACE `command.trunkmapping`, e.g. `add_ace group.admin command.trunkmapping allow`;
* a group listed in `Config.TrunkMapping.Groups`, whether it is a framework group, an ACE group, a job or a gang.