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.
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
.ytdfiles also work. - Your GTA V folder: the preview body and the game's tattoos come from it. Everything else works without it.
Steps
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.
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.
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.
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.
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.
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.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.metathe build will write.Build and start it
Choose Build, pick FiveM resource, then Check and Build. Copy the folder into your server's
resources/and addensure <resource name>toserver.cfg, or pick Deploy to local server.

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
Related guides
- How to make EUP clothing for FiveMBuild a FiveM addon clothing pack for the male and female freemode peds: add YDD and YTD files or import FBX, set slots, preview on a ped and build.
- How to add an addon ped to FiveM or GTA VMake an addon ped from a game ped, a ped folder or a FiveM resource, with peds.meta written for you, then build it for FiveM or singleplayer.
- How to replace textures in a YTD fileOpen a GTA V .ytd, export textures to PNG or DDS, edit them, and replace them one by one or from a folder, then optimise oversized textures.
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.
