Tutorial / Tools > World
Create Storage
Turn props into storage or loot containers (crates, lockers, cabinets).
What it does
Create Storage turns a prop into a container, or places a new one on the ground. Players open containers with E. Taking an item puts it in your backpack; money goes to your wallet.
There are two kinds. Storage containers keep what players put in them, also across restarts. Loot containers fill themselves from a loot table and refill after a timer. Only toolbox admins can set up loot containers.
Each container has its own access rule, an optional code and an optional search time. Containers are saved per map and come back after cleanups and restarts.
Where to find it
Q menu > KGX's Admin Toolbox > World > Create Storage.
Toolbox admins can use it. Superadmins can also give it to players in Settings > Player Access. Players then manage only their own containers and can read the loot tables.
Given to a player (v3.6.11.3): Their own containers; read the loot tables.
Controls
| Key | What it does |
|---|---|
| Left-click | Make the aimed prop a container (or place a new one where you aim) |
| Right-click | Edit the aimed container: contents, loot, access |
| Reload | Remove the aimed container (click twice) |
Options
| Option | What it does | Default |
|---|---|---|
| Type | Crate (8 slots), Locker (16 slots), Cabinet (6 slots) or Custom (10 slots). Sets the slots, label color and model. | Crate |
| Model for new ones (empty = the type's model) | Model for containers placed on the ground. Custom needs one. | Empty |
| Use the model I am looking at | Copies the model of the prop under your crosshair into the field above. | |
| Reset to defaults | Puts the type and model back to their defaults. |
The container editor
Right-click a container to open Edit container. Click Save to apply, or Close without saving.
General
| Option | What it does |
|---|---|
| Name above it | Name shown above the container (up to 40 characters). |
| Type (label color) | Crate, Locker, Cabinet or Custom. |
| Model | The container's model. |
| Skin | Model skin, 0 to 64. |
| Slots | 1 to 60. |
| Kind | Storage: keeps what players put in or Loot: fills itself from a loot table (admins). |
| Players can put their own things in | On by default for storage, off for loot. |
| Search time (seconds, 0 = opens at once) | 0 to 15. Players wait for a bar that stops if they walk away. |
| Go to it, Move it to where I am looking, Empty it | Buttons for quick changes. |
Loot
Used when Kind is Loot. Only toolbox admins can change these.
| Option | What it does | Default |
|---|---|---|
| Loot table | Which table it rolls from (World > Loot Tables). | |
| Items per fill (least) | 0 to 20. | 1 |
| Items per fill (most) | 1 to 30. | 3 |
| Refill after (minutes, 0 = never) | 0 to 1440. | 10 |
| Refill timer starts | When it is emptied or When it is first opened. | When it is emptied |
| Loot is | Shared: first come, first served or Per player: everyone gets their own. | Shared |
| Keep its loot across map restarts (else new loot) | Off rolls new loot after a restart. | Off |
| Only refill while nobody is standing next to it | Waits until the area is clear. | On |
Access
| Option | What it does |
|---|---|
| Who can open it | Everyone, Owner, plus the players and ranks below, Whitelist: only the players and ranks below, Blacklist: everyone except the players and ranks below, or Admins only. |
| Code (digits, empty = none) | Up to 8 digits. Others must enter it at the container. |
| Add an online player..., Add a rank..., Remove selected | Fill the Player and Rank lists used by the access rule. |
Contents
A list with Kind, Item and Amount. Admins add items by hand: pick a kind (Weapon, Ammo, Item (entity), Money), enter a class or click Pick..., set the amount, then Add. Remove selected and Remove all clear entries. Players cannot add items here.
How to use it
Turn a prop into a storage crate
- Spawn a crate prop and place it.
- Set Type to Crate (8 slots).
- Aim at the prop and left-click. It keeps its look and spot.
- Press E on it: the container is on the left, your backpack on the right.
Make a loot crate that refills
- Place a container, then right-click it.
- On General, set Kind to Loot: fills itself from a loot table (admins).
- On Loot, pick a Loot table such as Basic supplies and set the items per fill.
- Set Refill after (minutes, 0 = never) and click Save.
- The crate glows while it has loot for you and shows Empty once looted.
Lock a locker to certain players
- Right-click the container and open Access.
- Set Who can open it to Whitelist: only the players and ranks below.
- Add players with Add an online player... or ranks with Add a rank....
- Optionally enter a Code, then click Save.
Remove a container
- Aim at it and press reload.
- Press reload again within 3 seconds. The container and everything in it are removed.
Settings and commands
Change these in Settings > Backpack & Storage (superadmins).
| Setting | What it does | Default | Range |
|---|---|---|---|
kgxat_storage |
1 = storage containers can be opened. With it off, the tool cannot make new ones. | 1 | 0 to 1 |
kgxat_storage_glow |
1 = containers with loot for you glow when you are close. | 1 | 0 to 1 |
kgxat_storage_labels |
1 = container names (and Empty) float above them. | 1 | 0 to 1 |
kgxat_backpack_blacklist |
Comma-separated weapon or item classes that can never go in a backpack or container. | Empty | |
kgxat_limit_storage |
Most containers a non-admin player may own (Settings > Limits). 0 = not allowed. | 2 | 0 to 100 |
Tips and limits
- Players given this tool convert only props they own (not permanent or server-owned ones).
- Saved per map in
data/kgx_admin_toolbox/storage_<map>.json. - You cannot convert players, NPCs, vehicles, weapons, map props or stores. Aim at a prop you spawned.
- Admins can move containers with the physics gun; the new spot is saved. Players cannot move them.
- Admins and the owner can always open a container and skip the code. Only admins skip the search time.
- Five wrong codes lock the container for that player for 15 seconds.
- Changing Kind, the loot table or Loot is starts fresh loot.
- Money from loot is skipped while the economy is off.
- Keys, Admin Keys, Pockets, Hands and money printers can never be stored.
- Containers cannot be made Permanent Entities; they save themselves.
- v3.6.15: containers and vaults do not open for players in a Game Modes match, and stores refuse them, so match weapons cannot be stored or sold.