Custom Car Stickers
The sticker kiosk does not appear
Section titled โThe sticker kiosk does not appearโPrinters are not placed by default. Join with command.decaladmin permission, and use:
/decalkioskplaceCheck Config.Production.kiosk.enabled, ensure the resource name is still rs_car_stickers, and confirm that its streamed kiosk model loads. Stations placed successfully are restored from the database on restart.
The kiosk appears, but I cannot interact with it
Section titled โThe kiosk appears, but I cannot interact with itโConfirm that your installed target provider is detected (ox_target or qb-target) or switch to an in-world prompt.
Config.Production.stationInteraction = 'prompt' -- or 'both'The normal target mode also falls back to the Press E prompt when no supported target resource is running. Stand close enough to the kiosk.
The kiosk screen or cursor does not line up
Section titled โThe kiosk screen or cursor does not line upโLook directly at the affected kiosk and run:
/decalkioskcalibrateUse H to cycle through adjustments, the mouse wheel to change the selected value, Shift for fine control, Ctrl for coarse control, Enter to save, and Back to cancel. Calibration is stored for each station.
/stickers opens the library, but I cannot print
Section titled โ/stickers opens the library, but I cannot printโBrowsing the library is allowed away from a workstation. Creating, publishing, and printing require a configured printer. Verify you are at a station and have an inventory provider active. Also check publishing/printing prices and the inventoryโs capacity for the new item.
Config.Production.enabled = truePrinted stickers are not added to inventory
Section titled โPrinted stickers are not added to inventoryโCheck that the correct item definitions were merged into your inventory.
| Inventory | Essential setting |
|---|---|
| ox_inventory | vehicle_sticker uses stack = false, consume = 0 |
| qb-inventory | vehicle_sticker uses unique = true |
A printed sticker includes its own serial and design metadata. Non-unique qb-inventory items can merge incorrectly, so the script refuses unsafe printing configurations.
My sticker item does nothing
Section titled โMy sticker item does nothingโConfirm that vehicle_sticker is usable in your inventory and that rs_car_stickers starts after it. For ox_inventory, keep the included client export definition:
client = { export = 'rs_car_stickers.UseSticker' }For qb-inventory, use the included install/qb_inventory_items.lua definition. You can also try /usesticker while near an eligible parked vehicle.
It says I do not own this vehicle
Section titled โIt says I do not own this vehicleโThe production flow validates direct ownership on the server. Having vehicle keys, entering someone elseโs car, or sharing garage access does not make a player the legal owner for sticker editing.
Check the framework ownership table mapping under Config.Persistence.adapters, especially if using a custom garage. Standalone installs require a custom ownership resolver. Job and gang vehicles have their own authorized workflows.
Stickers disappear after putting a car in the garage
Section titled โStickers disappear after putting a car in the garageโSaved stickers should be restored when the owned vehicle is recreated. Confirm:
- OneSync and oxmysql are running before the resource.
- The vehicle is correctly recognized as owned, with the expected plate.
Config.Persistence.enabled,autoHydrate, andnearbyHydrateremain enabled.- The garage has finished creating the vehicle and assigning the correct plate.
If a custom garage still does not restore artwork, connect its spawn event using bridge/garage_server.lua or bridge/garage_client.lua. Use decalgarage for authorized diagnostics.
Stickers disappear when the vehicle is repaired
Section titled โStickers disappear when the vehicle is repairedโSome repair resources clear GTAโs native decals. The built-in repair recovery detects common cases. For custom repair scripts, call this after the repair finishes:
exports['rs_car_stickers']:NotifyVehicleRepaired(vehicle, 'repair finished')You can also configure existing repair-event listeners in Config.RepairRecovery.bridgeEvents. Do not edit or override another resourceโs repair natives unnecessarily.
Other players cannot see my stickers
Section titled โOther players cannot see my stickersโThe nearby observer renderer has distance, vehicle-count, and texture-atlas limits. Confirm that Config.Observer.enabled is enabled and that both players are reasonably close to the same vehicle. The editor owner and nearby viewers use different rendering paths.
Config.Observer.enabled = trueConfig.Observer.renderDistance = 110.0Config.Observer.maxTrackedVehicles = 20Avoid increasing performance limits blindly; test changes with several decorated vehicles and connected players.
External images are missing or blocked
Section titled โExternal images are missing or blockedโCheck the HTTPS host against Config.Images / Config.Observer.allowedImageHosts. The default permitted host is i.ibb.co. For your own image CDN, add its hostname to the allowlist. Remote URLs must also meet image-size and rendering budgets.
Config.Images = {allowedImageHosts = { 'i.ibb.co', 'cdn.yourserver.example' },}Publishing may also fail if an external image cannot be decoded or exceeds snapshot limits. Simplify the design, reduce resolution, and retry. The editable draft remains available.
Can I create animated GIF stickers or full vehicle wraps?
Section titled โCan I create animated GIF stickers or full vehicle wraps?โThe supported sticker renderer uses static artwork. Animated GIF/video material is not supported. Large decals also use planar placement and may not perfectly follow curved bodywork; several coordinated stickers usually work better than one oversized wrap.
/stickerwork does not offer mechanic services
Section titled โ/stickerwork does not offer mechanic servicesโThe default Config.Production.shops table is empty. Add a shop with coordinates, radius, and permitted job/grade settings. A mechanic must meet duty and job requirements when configured, and customer vehicle services require temporary owner approval.
Gang or job sticker templates are missing
Section titled โGang or job sticker templates are missingโEnsure the relevant feature is enabled in Config.Production.gangs or Config.Production.jobStickers.
- Gang template creation is limited to recognized leaders; ESX and custom gang scripts need a
bridge/gang_server.luaadapter. - Job templates depend on configured jobs, duty, models, and job authorization. External
{callsign}and{phone}values require integration inbridge/job_server.lua.
Where can admins remove inappropriate content?
Section titled โWhere can admins remove inappropriate content?โUse /decaladmin with the command.decaladmin ACE. Staff can review sticker designs, applied stickers, version histories, and moderation records. Ban controls additionally require rs_vehicle_decal.admin.ban.
add_ace group.admin command.decaladmin allowadd_ace group.admin rs_vehicle_decal.admin.ban allowDo I need to import SQL manually?
Section titled โDo I need to import SQL manually?โNo. The resource creates and upgrades its own SQL tables on startup. Make sure your oxmysql database user has permission to create and alter tables. Back up all sticker, decal, and kiosk tables before major upgrades.