# Gangwars — Player Documentation

> Welcome to the streets. This is what you can do, how it works, and what it'll cost you.

![Cover screenshot: server hero shot — Kaunas-themed Los Santos skyline at dusk](screenshots/cover.png)
*Screenshot needed: a wide hero shot of the city at dusk, ideally with a gang spray visible in the foreground.*

---

## What is this server?

Gangwars is a Lithuanian-flavored FiveM roleplay server set in a Kaunas reimagining of Los Santos. The headline experience: you can run with a *banda* (gang), claim *teritorija* (territory), deal drugs, launder dirty money, raid rival stash houses, fight contested airdrops, and slowly build personal notoriety on the streets.

Three core systems make up most of what you'll do:

- **Pug Gangs** — the gang tablet, territory, market, raids, sprays, upgrades. The big one.
- **Pug Drugsales** — press H near a *vietinis* (pedestrian) to deal.
- **Pug Moneywash** — turn dirty money items into clean cash through an NPC laundromat.

This documentation explains all of it in plain language, grouped by feature, written for players.

---

## How to read these docs

The folders are ordered by what you'll need first:

| # | Folder | Read this when |
|---|---|---|
| 01 | [start/](01-start/) | You just spawned in for the first time |
| 02 | [gangs/](02-gangs/) | You want to join or create a *banda* |
| 03 | [territory/](03-territory/) | You want to understand zones, claims, and the Saturday war |
| 04 | [economy/](04-economy/) | You want to make money — washing, dealing, market trading |
| 05 | [crime-loops/](05-crime-loops/) | You want to rob people, raid sites, contest airdrops |
| 06 | [systems/](06-systems/) | Reference: reputation, heat, items |
| 07 | [glossary-faq/](07-glossary-faq/) | Lithuanian terms + FAQ |
| 08 | [jobs/](08-jobs/) | Legal career paths — police, EMS, business management |
| 09 | [vehicles/](09-vehicles/) | Garages, lockpicking cars, breaking into doors |
| 10 | [interface/](10-interface/) | Inventory, radial menu, chat commands, skill checks |
| 11 | [survival/](11-survival/) | Wounds, medical care, death, respawn |
| 12 | [settings-admin/](12-settings-admin/) | Settings, reporting bugs, what staff can do |

Each page is short. If you want to skim, the **bold headers** carry the gist.

---

## Lithuanian terms

You'll see LT terms throughout — *banda*, *planšetė*, *teritorija*, *vietinis*, *skalbėjas*. They're italicized on first use with the English meaning in parentheses, and the full list lives in [07-glossary-faq/lithuanian-terms.md](07-glossary-faq/lithuanian-terms.md).

If you don't speak Lithuanian, you'll be fine. The terms are flavor; the mechanics are universal.

---

## Screenshot conventions

Every page has 1–3 image placeholders pointing at `screenshots/<section>/<name>.png`. They're empty for now — captions describe what should be in each. See [screenshots/README.md](screenshots/README.md) for capture guidelines.

---

## Where to ask for help

- **In-game:** `/help`, `/admin` (if you're staff), or ask in chat with `T`
- **Discord:** [link goes here]
- **Bug report:** in-game via phone (F1) → Bug Report tab
- **For admins:** see `gangwars/SERVER_PLAN.md` and `gangwars/plans/` for the engineering side

---

## Version

This doc set documents the Pug plugin suite (`pug-gangs`, `pug-drugsales`, `pug-moneywash`) as deployed on gangwars. Last reviewed: 2026-05-19.
