# Smoke Bunker: org and storage

> Org funds, members, roles and permissions, ownership, the stash and placeable storage.

The numbers are config defaults.

## Roles and permissions

A member has one role and can also hold permissions. Roles, highest to lowest: `OWNER`, `OFFICER`, `MEMBER`, `PROSPECT`. Permissions: `SELL`, `RAID`, `RESEARCH`, `WITHDRAW`. The owner always has all of them.

| Role | Permissions it starts with |
| --- | --- |
| `OWNER` | All, cannot be changed. |
| `OFFICER` | `SELL`, `RAID`, `RESEARCH`. |
| `MEMBER` | `SELL`. |
| `PROSPECT` | None. New invites join as prospects. |

Setting a role gives the member that role's permissions; switch them on or off per member afterwards. Anyone with access can open the terminal. What each action needs:

| Action | What it needs |
| --- | --- |
| Deposit org funds | `MEMBER` rank |
| Withdraw org funds | `WITHDRAW` permission (officers need it too) |
| Order supplies, buy a marketplace listing | `WITHDRAW` permission, or `OFFICER` rank |
| Accept, re-roll or abort a supply run, repair a camera, acknowledge alerts | `MEMBER` rank |
| Sell stock, list or pull a marketplace listing | `SELL` permission |
| Start or fast-track research | `RESEARCH` permission |
| Craft at the workshop | `RESEARCH` permission, or `OFFICER` rank |
| Launch a raid | `RAID` permission |
| Choose the production line, buy upgrades and customizations, manage staff and guards, rotate the keypad code, seal or open the blast doors, manage members and their access, edit stash rules, buy, rename or pick up placeable storage | `OFFICER` rank |
| Transfer, sell or abandon the bunker | `OWNER` role |

An officer can manage members and prospects. Only the owner can make someone an officer or change `WITHDRAW`.

## The Org & Audit page

### Org funds

Type an amount, press `Deposit` or `Withdraw`, then confirm. The money moves from or to your bank account.

Wages, upkeep, supply orders, upgrades, raid gear and fast-tracking research come out of org funds. A new bunker starts with none.

### Members

`Invite Nearest Player` invites the closest player within 5 metres. An org holds up to 20 members. A character can belong to one bunker org only.

Each member row shows the role and a button per permission. `Promote` and `Demote` move a member along `PROSPECT`, `MEMBER`, `OFFICER`. `Remove` takes them out of the org after you confirm, and they lose access at once.

Revoking someone's access on the Security page keeps them in the org. `Membership` lists them as revoked with a `Restore` button.

### Gang mode

A gang bunker takes its members and roles from the gang grades. `Invite Nearest Player` is off, but you can still edit permissions. If the owner leaves the gang, ownership moves to the member with the best grade.

### Ownership

The `Ownership` card is owner-only. Pick a member and press a button:

- `Transfer` makes that member the owner and makes you an officer.
- `Sell Bunker` pays your bank account part of the price plus the org funds: by default 60% of the current site price plus the whole balance. Everyone loses access.
- `Abandon` removes the bunker with no payout.

Selling and abandoning need an empty stash and no marketplace listing, crafting job, mission or raid. A message names what is in the way.

### Audit trail

`Audit Trail` lists member actions (spending, selling, raiding, withdrawing) with name and time.

## The Logs page

The Logs page lists recent bunker events. By default the server deletes log lines older than 14 days (`logs.retainDays`) at start.

## Storage

The Storage page lists the bunker stash, filterable by category: `WEAPON`, `BLUEPRINT`, `MUNITIONS`, `GEAR`, `PARTS`, `CASH`, `MISC`. `List For Sale` on an item starts a [marketplace](/bunker/guides/marketplace) listing.

The stash holds 120 slots and 2000 kg by default. Crafted goods, blueprint items and marketplace purchases go into it. `Open Stash`, or the `Open stash` prompt in the bunker, opens the stash screen.

### The stash screen

The screen has four tabs:

| Tab | What it does |
| --- | --- |
| `ITEMS` | Stash contents, with search. Every member can deposit. Taking follows `RULES`. |
| `KITS` | Presets members take in one go, each with a cooldown. One by default: `GUARD KIT`. |
| `MY ALLOWANCE` | Personal items that refill daily. Used before your rank and daily cap. |
| `RULES` | Officers and the owner edit the rules and press `SAVE RULES`. |

Starting rules:

- Members take any category freely except `WEAPON`, `BLUEPRINT` and `CASH`, which need the officer rank.
- Free items per day: 100 officer, 20 member, 0 prospect, unlimited owner.
- `GUARD KIT`: 2 `armor_plate` and 2 `ammo_rifle`, once an hour per member.
- A withdrawal that would take your inventory above 120 kg is refused.

`RULES` also sets the withdraw rank per category and each member's allowances. Defaults come from `storage.rules` and are copied into a bunker the first time its stash is used. Setting `storage.ownUi` to `false` swaps this screen for your inventory's own stash screen, which needs the `WITHDRAW` permission or the officer rank.

### Your gun locker

The `Gun Locker` customization gives every member a personal locker (30 slots, 150 kg by default), separate from the stash. Only you can open yours ([Staff and upgrades](/bunker/guides/staff-and-upgrades)).

### Placeable storage

Officers buy more storage in the `Placeable Storage` card on the Storage page. A bought item arrives in the stash after 10 minutes. Use it inside the bunker to place it.

| Type | Price | Holds | Limit |
| --- | --- | --- | --- |
| `Supply Crate` | $25,000 | 20 slots, 200 kg | 4 |
| `Gun Case` | $60,000 | 15 slots, 150 kg | 2 |
| `Storage Container` | $120,000 | 50 slots, 800 kg | 2 |
| `Gun Rack` | $90,000 | Wall rack for weapons, no stash | 2 |

- Up to 8 per bunker, at least 1 metre apart.
- A placed stash is its own stash. Its prompts `Rename / set access` (name and lowest rank that can open it) and `Pick up (keeps contents)` need the officer rank. New stashes open for `MEMBER` and up, the Gun Case for `OFFICER`.
- During a raid, raiders inside can loot a placed stash with `Loot storage`, once per stash and raid. Each stack goes to them with a 30% to 60% chance; the rest moves to the main stash.
- On the gun rack, heavy weapons go on the shelf only. You can pick up a rack only when it is empty.
