Decal V: Graffiti & Vehicle Sticker
This documentation covers Decal V v3.x. Still running the legacy rm_decalv2? The old documentation is archived here, and Migrate from v2 brings you across.
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 first, then open a ticket in our Discord with your server console output. Don't skip the Installation and Dependencies pages.
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 page before installing.
Next steps
Upgrading from v2? Migrate from v2 carries your data and edits over.
Last updated