# Gang Sprays

> Paint your gang's tag on walls, sidewalks, billboards. Sprays mark territory, intimidate rivals, and contribute to zone capture progress.

![Screenshot: a gang spray painted on a brick wall in Vilijampolė](../screenshots/02-gangs/spray-on-wall.png)
*Screenshot needed: a spray rendered on a wall, ideally with the player who placed it standing in shot.*

---

## What is a spray?

A spray is a persistent, DUI-rendered (Direct UI) image painted on a surface in the world. Sprays:

- Are visible to everyone in render range
- Persist across server restarts (saved to database)
- Use **any image URL** you provide — your gang logo, a tag, even a meme
- Default to your gang's theme color if no custom image is set
- Mark territory (visible deterrent to rivals)
- Can be removed by paint remover

---

## How to place a spray

1. Buy a `gangspray` item — costs vary (configurable, often ~$50–200 per can)
2. Stand near a flat surface (wall, billboard, pavement)
3. Use the item from inventory or via hotkey
4. A placement preview appears (uses your camera raycast)
5. Aim where you want it, click to confirm
6. The spray is committed to the database and rendered

![Screenshot: spray placement preview with camera raycast indicator](../screenshots/02-gangs/spray-placement-preview.png)
*Screenshot needed: the placement preview showing the spray about to be committed.*

---

## Custom spray images

You can use your gang's logo as the spray graphic:

1. Get your logo as a publicly-accessible URL (Imgur, Discord CDN, your website)
2. Recommended: PNG with transparent background, 512×512 or 1024×1024 max
3. Open the tablet → Sprays tab → "Set spray URL"
4. Paste the URL
5. Press save
6. All future sprays placed by your gang use this image

**Image URL max length:** 500 characters (configurable).

> 💡 **Use square or close-to-square images.** GTA stretches the DUI plane; non-square aspect ratios distort.

---

## Spray slots

Each gang has a default number of **spray slots** — how many active sprays can exist simultaneously. When you hit the cap, placing a new spray either:

- Fails with a notification, or
- Removes the oldest spray (configurable)

**Slot count is XP-gated.** As your gang levels up, you unlock more slots. Default progression:

| Gang level | Spray slots |
|---|---|
| 1 | 5 |
| 2 | 8 |
| 3 | 12 |
| 5 | 20 |
| 10 | 40 |

(Actual numbers depend on server config — check the Sprays tab for your current cap.)

---

## Paint remover (countering rivals)

`paintremover` is an item that destroys nearby gang sprays — any gang's, not just yours.

1. Stand within ~3m of an enemy spray
2. Use the `paintremover` item
3. Confirm
4. The spray is destroyed and removed from the database

> ⚠️ **Paint remover is the main way to undo enemy turf marking.** Expect rivals to remove yours; remove theirs in return. This is part of the territory loop.

---

## How sprays affect territory

Sprays placed inside a zone:

- Add to your gang's **capture progress** (slowly tilts zone ownership toward you)
- Contribute to **zone reputation** for your gang
- Don't immediately win the zone — capture takes time + presence

See [../03-territory/capturing-zones.md](../03-territory/capturing-zones.md) for the full capture mechanic.

---

## Tips

- **Place sprays in high-traffic areas** for maximum visibility — main streets, near vehicle spawns, gang hideout entrances
- **Don't waste slots in deep alleys** — they're invisible most of the time
- **Cover key chokepoints in rival zones** — drives their heat up
- **Coordinate with gang chat** when placing — don't double-cover the same wall
- **Photos:** screenshot your best sprays for the gang chat / Discord

---

## Related

- [overview.md](overview.md) — sprays in context of gang systems
- [../03-territory/capturing-zones.md](../03-territory/capturing-zones.md) — how sprays contribute to zone capture
- [../06-systems/items.md](../06-systems/items.md) — spray + paint remover item details