RageKit

How to make custom tattoos for FiveM

Custom tattoos in GTA V are ped decorations: a collection file (<name>_overlays.xml) that lists each tattoo with its body part and placement, one .ytd texture per tattoo, and an optional shop_tattoo.meta that sells them in tattoo parlours. In RageKit's Tattoo & Overlay Studio you add PNG images, drag them onto the freemode ped, set shop names and prices, and Build writes the FiveM resource with its data_file lines.

Updated

Before you start

  • Premium: Tattoo & Overlay Studio needs it. See Free and Premium.
  • Your artwork as PNG with a transparent background. JPG, TGA, BMP, DDS and existing .ytd files also work.
  • Your GTA V folder: the preview body and the game's tattoos come from it. Everything else works without it.

Steps

  1. Add your artwork

    In Tattoo & Overlay Studio choose Add images… and pick your files, or drop them on the window. Each image becomes a tattoo on the torso, named after its file.

    • From a game tattoo… starts from a stock tattoo's body part, placement and shop settings; you pick the artwork.
    • Import a tattoo pack… reads an existing FiveM tattoo resource, or a folder with an _overlays.xml, back into a project.
  2. Pick the body part

    Select a tattoo and set Body part: Torso, Head, Left arm, Right arm, Left leg or Right leg. Set Kind to Tattoo, or to Badge / print for crew emblems, shirt prints and hair overlays.

  3. Place it on the body

    Drag the tattoo on the body to move it. The mouse wheel over it resizes it, Shift + wheel turns it, and Alt + click puts it where you click. The Around, Up, Width, Height and Rotation sliders set the same values exactly.

  4. Place it for both peds

    Switch the preview between Male and Female. Each has its own placement: Same as for men or Same as for women copies one to the other, and the Men and Women boxes under For turn a tattoo off for one of them.

  5. Set the shop name and price

    With Sold in tattoo parlours on, set the Name players read in the shop and the Price. Camera sets which side the shop camera shows the tattoo from, and Group sets its update group: buying another tattoo of the same group replaces it.

  6. Name the collection

    On the Check step set the Pack name, the Collection name (it ends in _overlays), the First shop id and the Texture size.

  7. Check

    The check runs as you edit and also looks at the artwork on disk. Problems are listed under the preview, and errors must be fixed before building. Show the XML shows the collection file and shop_tattoo.meta the build will write.

  8. Build and start it

    Choose Build, pick FiveM resource, then Check and Build. Copy the folder into your server's resources/ and add ensure <resource name> to server.cfg, or pick Deploy to local server.

Tattoo Studio placing a tattoo on the freemode ped's arm

What's in a tattoo resource

stream/<tattoo>.ytd: one texture dictionary per tattoo. Images are encoded to DXT5 with mipmaps; a .ytd you supply is shipped as it is.

data/<collection>.xml: the collection, with each tattoo's body part and its male and female placements. Registered as PED_OVERLAY_FILE.

data/shop_tattoo.meta: the shop items, written only when at least one tattoo is sold. Registered as TATTOO_SHOP_DLC_FILE.

A client script that sets the shop names with AddTextEntry. A singleplayer DLC pack gets the same names as a global.gxt2 text table instead.

Applying tattoos from a script

Scripts apply a tattoo with AddPedDecorationFromHashes, giving the ped, the collection name and the tattoo's preset name. The Name field of each tattoo shows the preset names it ships.

With Sold in tattoo parlours off, no shop item is written and only scripts apply the tattoo.

The only script in the build is the one with the shop names. RageKit doesn't include a tattoo menu.

Questions

What size should a FiveM tattoo image be?

Textures made from images are resized so their longest side matches the pack's Texture size: 256, 512, 1024 or 2048. The default is 512, the size of the game's own tattoos.

Can one tattoo work on male and female characters?

Yes. Each tattoo has a separate placement for mp_m_freemode_01 and mp_f_freemode_01, and can be turned off for either.

Can I sell custom tattoos in the tattoo shop?

Yes. Leave Sold in tattoo parlours on and set a name and price. RageKit writes shop_tattoo.meta and the shop names.

Can I build tattoos for singleplayer?

Yes. Build also offers a singleplayer DLC pack, an OIV package and a copy in the game's mods folder.

Tools in this guide

Get RageKit

Free download for Windows 10 and 11. No account needed for the free tools.

There's no Windows installer on the latest release yet. Check the changelog for when it lands.