> ## Documentation Index
> Fetch the complete documentation index at: https://docs.apex-services.site/llms.txt
> Use this file to discover all available pages before exploring further.

# APEX Spray

> Wall graffiti and 3D image sprays with 8 custom fonts.

A wall graffiti / spray system for FiveM. Text sprays with 8 custom fonts (Next Custom, Dripping Marker, Docallisme, Fat Wandals, Sister Spray, Pricedown, Chalet, Sign Painter) or 3D image sprays from a built-in palette (football clubs, logos, animals, memes). Raycast placement with surface validation, proximity limits, and MySQL persistence.

## Features

* 8 custom graffiti fonts — each with its own allowed-char regex + size multiplier
* 3D image sprays — 80+ shipped textures (football clubs, logos, gangs, animals, food, custom)
* 20+ color palette — primary + darker + darkest per color
* Raycast placement with surface validation (flat / too-far / invalid)
* Blacklist for forbidden text
* Proximity limit — max 6 sprays in 30m radius
* Auto-cleanup after configurable days (default 2)
* Custom IMAGES!

## Requirements

<Card title="Required" icon="circle-check">
  `oxmysql`, `es_extended` (for `ESX.RegisterUsableItem`)
</Card>

## Configuration

```lua config.lua theme={null}
Config.SPRAY_PERSIST_DAYS         = 2
Config.SPRAY_PROGRESSBAR_DURATION = 20000
Config.SPRAY_REMOVE_DURATION      = 30000
Config.MAX_SPRAYS_IN_RADIUS       = 6
Config.SPRAY_CHECK_RADIUS         = 30.0
Config.Blacklist                  = { ... }
```

8 fonts, 20+ colors, and 80+ image textures are configurable via the `FONTS`, `COLORS`, and `IMAGES` tables.

Items: `spray` (text), `picasso_spray` (image). Commands: `/spray <text>`, `/sprayimage`.

## Resource info

<Note>
  Code accessible: `config.lua`. Approximately 2000 lines of Lua. German.
</Note>