F.A.Q

3 min readUpdated 2 weeks ago

Setup

No. It runs on QBox, QBCore, ESX and standalone through ml_bridge.

Yes for custom-image tattoos. ml_tattoos_meta streams the overlay slots those tattoos render into and ships in the same package. Keep it next to ml_tattoos and ensure it before ml_tattoos. Vanilla GTA tattoos work without it.

Through a configured shop location, a tattoo-kit item, an admin /opentattoo grant, or the openShop export. Admins use /tattooadmin for the management panel, and players use /mytattoos to view what they own.

Yes. The full set of GTA Online overlay tattoos is browsable out of the box, grouped by DLC pack, with search and a 3D rotating preview.

Custom Tattoos

A player-supplied image turned into an in-world tattoo, positioned on the body through a studio picker. Enable it with Config.EnableCustomTattoos.

By pasting an HTTPS image link, or by uploading a PNG in-game when FiveManage is installed. Set Config.UserCustom.imageInput to 'paste', 'upload' or 'both'.

Yes. There is a free rework window after creation (Config.UserCustom.editWindow, 24h by default). After it closes, a rework consumes another use.

Yes. A faction-type custom is visible to the creator's gang/faction, so members can apply it. Admins can also set a custom to public, faction or license visibility from the panel.

Uses & Donations

Optionally, yes. If you configure Tebex packages, players can support the server through your Tebex store and receive custom-tattoo uses in return. Depending on each package's source, they can also buy uses with in-game money, and staff can hand uses out from the admin panel.

No. Donations are entirely optional. With no Tebex packages configured the donation layer does nothing, and the normal money/item tattoo shop keeps working.

One solo or faction use lets a player create one custom tattoo (personal or faction-shared). One ytd use permanently unlocks one installed Full-Body pack.

A refund through the Tebex hub reverses the uses that order delivered. If they were already spent, the system reports a partial or irreversible result rather than putting the player into a negative balance.

Factions & Restrictions

Yes. Create a restriction in the admin panel for a tattoo and list the jobs or factions allowed to apply it. Everyone else has it hidden.

Each pack in Config.YtdPacks can carry allowedFactions or allowedIdentifiers. Omit both for an open pack, or list values to restrict who sees and unlocks it.

Updates

Yes. shared/config.lua, server/config_server.lua, the open/ hooks and the locales are kept outside the encrypted bundle, so your settings carry across updates.

Yes. Schema migrations run on boot and skip when the database is already up to date, so updating the resource needs no manual SQL.