Tutorial / Tools > World
Storage Vault
Server vaults: everyone opens their own personal vault at them.
What it does
Storage Vault sets up server vaults. Everyone who presses E on a server vault opens their own personal vault. Only they see their things in it, and it is kept for every map.
Nobody can lockpick, move or break a server vault. You can place a new one, or turn any prop, entity or NPC into one.
Players can also buy their own vault in a store (item type "Storage Vault"). The panel holds the settings for both kinds.
Where to find it
Q menu > KGX's Admin Toolbox > World > Storage Vault.
Superadmins only. Other admins, and players given the tool, get "Only superadmins set up server vaults." The settings in the panel are also superadmin only.
Admins only (v3.6.11.3): this tool sets up the server, so it cannot be given to players; it is greyed out in Settings > Player Access.
Controls
| Key | What it does |
|---|---|
| Left-click | Place a server vault (the style picked below) |
| Right-click | Make the aimed prop, entity or NPC a server vault |
| Reload | Take the aimed vault away |
The screen shows Server vault, A player's own vault or Not a vault for the entity under your crosshair.
Options
Style
| Option | What it does | Default |
|---|---|---|
| Model icons | Click a model to use it for new server vaults. Models of games you do not have (Counter-Strike, Left 4 Dead) are not shown. | models/props_c17/lockers001a.mdl |
| Scan map props (pick one the map uses) | Lists safes, lockers, cabinets, crates and similar props the map uses, and sets the one you pick. |
Bought vaults and settings
| Option | What it does | Default | Range |
|---|---|---|---|
| Storage Vaults work | Server vaults and bought ones. kgxat_vault. |
On | |
| Slots in everyone's personal vault | kgxat_vault_slots. |
20 | 1 to 60 |
| Players may buy their own vault | Store item type Storage Vault. kgxat_vault_buy. |
On | |
| Slots in a bought vault | kgxat_vault_home_slots. |
16 | 1 to 60 |
| Bought vaults can be lockpicked | Others can open them with the Lockpick. kgxat_vault_pick. |
On | |
| Seconds the Lockpick needs on a vault | kgxat_vault_pick_time. |
25 | 3 to 300 |
| Seconds a picked vault stays open | For the one who picked it. kgxat_vault_pick_open. |
60 | 10 to 600 |
| Picking a placed vault back into the Pockets | Only when it is empty (default), Never (it stays where it was put down), or Any time (the old way: not safe, see below). kgxat_vault_repocket. |
Only when it is empty | |
| Seconds after putting it down before it can be picked up again | kgxat_vault_move_wait. 0 = no wait. |
120 | 0 to 3600 |
| Bought vaults cannot be put down in spawn zones | kgxat_vault_no_spawnzone. |
On | |
| Owners can throw their empty vault away (Alt + E on it, or !vault remove) | kgxat_vault_discard. |
On | |
| Apply the numbers above | Saves the slider values. |
How to use it
Place a bank vault
- Click a model in the panel, such as a safe or locker.
- Aim at the floor and left-click. The vault stands on the spot, facing you.
- Players press E on it to open their personal vault.
Turn a map prop into a vault
- Aim at a safe or locker that is part of the map.
- Right-click. It stays a map prop and becomes a server vault, kept for this map.
Take a vault away
- Aim at the vault and press reload.
- A server vault stops being a vault. The things in it stay in everyone's personal vault.
- On a player's bought vault, it is removed. They get it back with
!vault, with its contents.
Let players buy their own vault
- Make sure Players may buy their own vault is ticked.
- Add a store item of type "Storage Vault" (Economy > Store Maker).
- A bought vault goes into the buyer's Pockets. They take it out where they like (not in a spawn zone); Alt + E on it picks its style.
- Leave Picking a placed vault back into the Pockets on Only when it is empty. A vault's things are saved for its owner, not inside the vault, so a vault that goes back into the Pockets full is a stash the player carries everywhere. With Never it stays where it was first put down.
Get rid of a bought vault (players)
- Take everything out of the vault.
- Alt + E on it and click Throw this vault away, then Throw it away. Or type
!vault remove(also works while it is in the Pockets). - It is gone from the world and the Pockets, and
!vaultor joining no longer hands it out. Buying one again gives a new one.
Settings and commands
| Setting or command | What it does | Default | Range |
|---|---|---|---|
kgxat_vault |
1 = Storage Vaults work (server vaults and bought ones). | 1 | 0 to 1 |
kgxat_vault_slots |
Slots in everyone's personal vault. | 20 | 1 to 60 |
kgxat_vault_buy |
1 = players may buy their own vault. | 1 | 0 to 1 |
kgxat_vault_home_slots |
Slots in a vault a player bought. | 16 | 1 to 60 |
kgxat_vault_pick |
1 = bought vaults can be opened by others with the Lockpick. | 1 | 0 to 1 |
kgxat_vault_pick_time |
Seconds the Lockpick needs on a vault. | 25 | 3 to 300 |
kgxat_vault_pick_open |
Seconds a picked vault stays open for the one who picked it. | 60 | 10 to 600 |
kgxat_vault_repocket |
A placed bought vault back into the Pockets: 0 = never, 1 = only when empty, 2 = any time. | 1 | 0 to 2 |
kgxat_vault_move_wait |
Seconds after putting a bought vault down before it can be picked up again. | 120 | 0 to 3600 |
kgxat_vault_no_spawnzone |
1 = bought vaults cannot be put down in spawn zones. | 1 | 0 to 1 |
kgxat_vault_discard |
1 = owners can throw their empty bought vault away. | 1 | 0 to 1 |
!vault |
Chat. Puts your bought vault back in your pockets after a restart or cleanup (not while Storage Vaults are off). | ||
!vault remove |
Chat. Throws your empty bought vault away (from the world or the Pockets). |
Tips and limits
- Personal vaults are kept for every map in
vaults.json. - Spawned props made vaults become a vault of their own. Map props and permanent props are kept for the map. Other things stay a vault only until a restart.
- Each player can own one bought vault. With no room in their Pockets, the sale fails.
- Only the owner puts things in a bought vault. Others open it only with the Lockpick, and the owner is told.
- A bought vault stays in the pockets on death. After a restart or cleanup,
!vault(also on joining) puts it back. While Storage Vaults are off nothing is handed out. - Trying to pick a vault up too early or full says why: "You can pick your vault up again in ...", "Empty your vault first: only an empty vault goes back into your Pockets." or "Your vault stays where you put it."