Skip to main content

Creating overlays

The editor view of a collection is where you actually build your tattoo pack. The sidebar on the left walks you through it step by step.

Add a new overlay​

  1. Body - choose the gender and the zone you want to work on. The 3D preview snaps to that body area.

  2. Image - click the drop area and pick a PNG. Transparency is preserved and is what makes the tattoo blend with the skin.

  3. Transform - drag the overlay in the 3D viewer or fine-tune position (X / Y), scale and rotation in the sidebar.

  4. Save - the overlay is added to the collection and shows up in the Manage collection modal.

Managing existing overlays​

Open Manage collection from the editor's top bar. Overlays are grouped by zone for the gender you're currently editing. From here you can:

  • Re-order with drag-and-drop within a zone strip - the new order is saved automatically and determines the numeric index (_000, _001, …) in the exported resource.
  • Toggle individual overlays on/off for the 3D preview using the checkboxes on each tile.
  • Modify to load an overlay back into the editor for tweaking.
  • Mirror to create the same overlay on the opposite side of the body (left ↔ right). Only available on the symmetric zones (arms, legs).
  • Delete.

Image guidelines​

  • Format: PNG with a transparent background.
  • Mode: RGBA (8-bit). Black + alpha works best for classic tattoos.
  • Size: powers of two are recommended (512×512, 1024×1024, 2048×2048).
  • Content: keep the design tight to the alpha - the bounding box is what gets placed on the body.

Importing an existing pack​

From the collections list, click Import existing collection. The .zip you upload can be anything that contains:

  • One *.xml file - a PedDecorationCollection document listing each tattoo's zone, position, scale and rotation.
  • The matching *.ytd texture files - one per tattoo, named to match the txdHash value in the XML.
  • Sub-folders are fine; the importer scans the whole archive.

Pick a collection name, choose the zip, and click Import. This is the fastest way to migrate an existing FiveM tattoo resource into the editor so you can tweak or extend it.