> For the complete documentation index, see [llms.txt](https://docs.rainmad.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.rainmad.com/resources/decal-v-graffiti-and-vehicle-sticker.md).

# Decal V: Graffiti & Vehicle Sticker

{% hint style="info" %}
This documentation covers Decal V v**3.x**. Still running the legacy `rm_decalv2`? The old documentation is archived [here](/resources/decal-v-graffiti-and-vehicle-sticker-v2.md), and [Migrate from v2](/resources/decal-v-graffiti-and-vehicle-sticker/migrate-from-v2.md) brings you across.
{% endhint %}

{% hint style="warning" %}
**Pre-Installation Note**

This guide assumes you already know how to manage a FiveM server (start resources, edit configs). Following the steps out of order is the most common cause of errors.

**Support**

If something isn't working after you've followed every step, run through [Troubleshooting](/resources/decal-v-graffiti-and-vehicle-sticker/troubleshooting.md) first, then open a ticket in our [Discord](https://discord.gg/rainmad) with your server console output. Don't skip the [Installation](/resources/decal-v-graffiti-and-vehicle-sticker/installation.md) and [Dependencies](/resources/decal-v-graffiti-and-vehicle-sticker/dependencies.md) pages.
{% endhint %}

Decal V lets players spray graffiti on the world and put stickers on vehicles. Aim anywhere, lock the spot with a click, fine-tune size, rotation and color live, and save. Graffiti persists in the world for everyone, stickers follow the vehicle by its plate. A catalog of 340+ bundled decals ships in, and admins can grow it in-game from a URL, an animated GIF, or the built-in decal editor without touching a single image tool.

It works on QBCore/Qbox and ESX (auto-detected) and also runs standalone; notifications bridge to whatever UI resource you already use.

## Features

* **Free placement:** aim at any wall, object or vehicle, click (or Enter) to lock, then adjust size, rotation and color with live preview. Scroll rotates, Ctrl+scroll resizes.
* **Vehicle stickers:** stickers stick to the vehicle by plate and model, sync to every player, and survive restarts.
* **Mirror & flip:** mirror a sticker to the far side of the vehicle, flip it horizontally, or combine both for a true mirror. Every bundled texture ships with a pre-built flipped twin.
* **World graffiti:** graffiti persists in the database, streams to clients around them, and plays a spray-can animation with particles on placement.
* **Catalog permissions:** lock any decal or category to jobs, gangs, identifiers or admins, gate it with your own server-side check, or reserve it for specific vehicle models.
* **In-game decal editor:** admins compose new decals from text layers (27 runtime-loaded fonts), catalog images and URL images on a canvas, then export straight into the catalog.
* **URL & GIF import:** admins add decals from any https image URL; animated GIFs render in-world (opt-in, capped).
* **Recolorable art:** the bundled line-art decals are authored in white so the color picker really works. Pick black to get the classic look.
* **Admin panel:** search, teleport to, delete and permanent-flag every decal on the server; bulk-delete by creator; live diagnostics overlay for support cases.
* **Ownership & protection:** vehicle-ownership checks with job/zone bypasses for shops, creator-only clearing, restricted zones with an event hook, density and size limits. All enforced server-side.
* **Performance-minded:** category textures stream like game assets instead of decoding at runtime, and render distance and budgets are configurable.
* **Discord logging:** decal create/clear logs through a customer-editable file. Bring your own webhook format.

## Dependencies

A framework, `ox_lib`, `oxmysql` and OneSync are required. See the full list on the [Dependencies](/resources/decal-v-graffiti-and-vehicle-sticker/dependencies.md) page before installing.

## Next steps

1. [Dependencies](/resources/decal-v-graffiti-and-vehicle-sticker/dependencies.md)
2. [Installation](/resources/decal-v-graffiti-and-vehicle-sticker/installation.md)
3. [Configuration](/resources/decal-v-graffiti-and-vehicle-sticker/configuration.md)

Upgrading from v2? [Migrate from v2](/resources/decal-v-graffiti-and-vehicle-sticker/migrate-from-v2.md) carries your data and edits over.