# F.A.Q

> Common questions about ML Tattoos

Category: TATTOOS · Source: https://miciomods.it/docs/ml-tattoos-faq · Last updated: 2026-07-09

## Setup

**Does ML Tattoos require a specific framework?**

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

**Do I need the meta companion resource?**

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.

**How do players open the shop?**

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.

**Does it ship with vanilla tattoos?**

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

**What is a custom tattoo?**

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

**How do players supply the image?**

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'`.

**Can players edit a custom after creating it?**

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

**Can a custom be shared with a whole faction?**

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

**Can players donate for custom tattoos?**

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.

**Are donations required?**

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

**What does a use actually do?**

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.

**What happens to a use if I refund a Tebex order?**

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

**Can I lock certain tattoos to specific jobs or factions?**

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.

**How do Full-Body packs get access control?**

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

**Will my config survive an update?**

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.

**Do database changes apply automatically?**

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