# Screenshots

This folder mirrors the docs structure. Every page in `gangwar-docs/` references one or more screenshots under `screenshots/<section>/<name>.png`. Captions in each doc describe what each shot should contain.

## Capture conventions

- **Format:** PNG (lossless) preferred. JPG acceptable if size matters.
- **Resolution:** 1920×1080 ideal. 1280×720 minimum. Don't go below 720p.
- **Size:** Aim for under 600KB per image. Use WebP if file size becomes a problem.
- **Aspect:** 16:9 landscape. Don't crop into portrait unless documenting a vertical UI element.
- **UI in shot:** Keep the FiveM HUD visible unless documenting a specific NUI overlay. The HUD gives context.
- **No personal info:** No license2 hashes, IP addresses, or admin chat in the frame.
- **Time of day:** Most exterior shots look better in dusk/golden hour. Use `/setweather clear` and `/settime 1700` if you're an admin.

## Naming

Files are named in `kebab-case.png` matching the placeholder path in the doc:

```
screenshots/02-gangs/tablet-main-view.png
screenshots/04-economy/wash-npc-startped.png
screenshots/05-crime-loops/raid-mansion-vault.png
```

## Sub-folders

```
screenshots/
  cover.png                         # used by root README
  01-start/                         # spawn, character creation, first-hour stuff
  02-gangs/                         # tablet UI, gang creation, ranks, sprays, upgrades
  03-territory/                     # zone map, capture progress, Saturday war
  04-economy/                       # wash NPC, drug deals, market UI, dead drops
  05-crime-loops/                   # mugging, raids, airdrops, deliveries
  06-systems/                       # rep meters, heat indicators, item inventory icons
  07-glossary-faq/                  # any visual references for terms
```

## Replacing placeholders

When you capture a screenshot:

1. Save it at the exact path shown in the doc's caption
2. The doc's existing image link picks it up automatically (no doc edits needed)
3. Optionally update the caption text in the doc if your shot covers something better than originally planned

## Don't include

- Other players' usernames without permission
- Tebex / store URLs in chat
- Real player chat content (use a `/clearchat` or capture during a dev session)
- Watermarks / personal branding