# Gang Upgrades

> Persistent infrastructure your gang places in the world: a crafting bench, a storage stash, a money safe, a gang garage, a hidden doctor NPC.

![Screenshot: gang upgrades menu in the tablet showing 5 buyable upgrades](../screenshots/02-gangs/tablet-upgrades-menu.png)
*Screenshot needed: the upgrades purchase menu inside the tablet.*

---

## The five upgrades

| Upgrade | Effect | Approx. cost |
|---|---|---|
| **Crafting bench** | Combine items into new items (weapons, ammo, drug bricks) | $20k–40k |
| **Storage stash** | Shared inventory accessible to gang members | $15k–25k |
| **Money safe** | Persistent gang treasury storage with audit log | $10k–20k |
| **Gang garage** | Spawn gang vehicles with theme paint | $30k–50k |
| **Hidden doctor** | NPC medic at your hideout — heals members without hospital trip | $25k–40k |

(Costs depend on server config — check the tablet for exact prices.)

---

## How to place an upgrade

1. Open tablet → **Upgrades** tab
2. Select the upgrade you want
3. Confirm the purchase (deducts from gang treasury, not your personal cash)
4. The placement camera activates — same as spray placement
5. Aim at a valid surface (must be inside one of your owned zones)
6. Click to commit
7. The upgrade entity spawns and persists

![Screenshot: placement preview for the gang stash](../screenshots/02-gangs/upgrade-placement-stash.png)
*Screenshot needed: a player about to place a stash with the placement raycast preview visible.*

---

## Per-upgrade detail

### Crafting bench

- Visual: workbench prop
- Members with `craft` permission can use it
- Recipes unlock as gang levels up
- Common recipes: convert raw drugs to bricks, repair weapons, craft melee weapons
- Each craft consumes ingredients from the user's personal inventory

### Storage stash

- Visual: locker / crate prop
- Shared inventory (typically 50–200 slots, weight-limited)
- Members with `access_stash` permission can deposit/withdraw
- Audit log per access (who took what, when)
- Common use: stash hot items, share ammo, group up before raid

### Money safe

- Visual: safe prop
- Stores gang treasury beyond what the tablet UI shows
- Larger withdrawals require physical access (must be at the safe)
- Audit log of all transactions
- See also [treasury-chat.md](treasury-chat.md) for the digital treasury

### Gang garage

- Visual: garage door / vehicle marker
- Spawn gang-owned vehicles
- Vehicles paint-themed to gang color (if `lt_gang_fleet` is installed)
- Available vehicle pool configurable per gang level

### Hidden doctor (NPC medic)

- Visual: a `Config.MedicalDoctor` NPC (configurable model, suit-wearing default)
- Members can interact: "Treat injuries"
- Heals to full health without going to hospital
- Optional cost per visit (default $500 from gang treasury)
- Lore-grounded: this is your gang's off-the-books physician

---

## Placement rules

- Must be **inside a zone your gang owns** — can't place in neutral or rival turf
- Must be on **flat, non-vehicle ground** — no placing on a car roof
- Cannot overlap with existing upgrades
- Each gang has a placement limit per upgrade type (typically 1 per type per zone)

---

## Removing or moving an upgrade

- Tablet → Upgrades tab → "Remove" button on placed upgrade
- 50% refund of original cost back to treasury
- Upgrade entity despawns immediately
- You can re-place elsewhere within 5 minutes (full re-purchase required)

---

## Defending your upgrades

- Upgrade props are **destructible** during raid events (rivals can shoot them)
- Damaged upgrades require repair (~25% of original cost) via tablet
- A destroyed upgrade is gone — you re-buy + re-place
- This is why placement matters: deep inside a fortified hideout vs visible in a parking lot

---

## Tips

- **Place the safe LAST.** It's the highest-value target; you want infrastructure around it before showing the location
- **Don't put the stash in the open.** A visible stash + curious enemy = loss
- **The doctor saves real money.** Hospital visits cost time + cash; on-site doctor is worth the buy
- **Garages must be near a roadway.** Spawning a car inside a building doesn't work
- **Coordinate placement with gang chat.** Don't double-buy by accident — both purchases go through, and you lose the duplicate cost

---

## Related

- [overview.md](overview.md) — upgrades in the gang lifecycle
- [tablet.md](tablet.md) — accessing the Upgrades tab
- [treasury-chat.md](treasury-chat.md) — funding upgrades
- [ranks-permissions.md](ranks-permissions.md) — who can buy upgrades