Troubleshooting

The tattoo does not show in game

When a Tattoo Studio tattoo is installed but does not show, go through these in order:

• server.cfg. The ensure line must match the folder name exactly, for example ensure sw_user3jwr_overlays, and fxmanifest.lua must sit directly inside that folder.
• Start order. Ensure the tattoo pack before your appearance script, and restart the appearance script after the pack. Then reconnect.
• The snippet. The appearance script only lists tattoos it knows. Paste the snippet for your script from the pack; the collection name in it must stay as it is. See Appearance scripts.
• The gender. Each design has a male and a female overlay, ending in _M and _F. The male one on a female ped shows nothing.
• Clothing. A tattoo is on the skin. A shirt or jacket over the spot hides it; test with the top off.
• The ped. Tattoos are made for the freemode peds mp_m_freemode_01 and mp_f_freemode_01. illenium-appearance skips tattoos on other peds.

White box or white fill

• A white or coloured box around the tattoo. The image had a background instead of transparency. Remove the background, save as PNG and upload again, or erase it in the design editor.
• White inside the lines. White that is part of the design is inked white. This happens often with AI designs: the AI removes the white around the design, not the white enclosed by lines. See White inside a design.

Wrong spot or wrong size

The build writes exactly the placement the preview shows. If the tattoo sits wrong in game:

• Only on one gender. Check the other ped in the studio; with m/f separate each has its own placement.
• Small inside its box. The whole image is fitted into the tattoo box, empty border included. Crop the image close to the design, or raise Width and Height.
• Cut off. The tattoo is clipped at the edge of its zone. Move it further into the zone or make it smaller.
• Blurry. Build with Texture 1024 px, and upload an image of at least 1024 px.
• Mirrored design. Mirror is still experimental. Flip the image before the upload instead.

To fix a built pack, set the design up again in the studio and build a new pack; the studio keeps no drafts. Replace the old folder on the server with the new one.

The build does not start

• The button is grey. Every entry in Tattoos in this pack needs a design. An entry that says no design yet blocks the build; upload one or remove the entry.
• Design names must be unique within a pack Two entries have the same Name. This also happens with the default names: remove Tattoo 1 from a pack of two, add a new entry, and it is named Tattoo 2 again. Rename one of them.
• More than 12 entries. A pack takes 12 designs at most. Remove entries until 12 are left.
• Too few credits. A line under the studio says You need 40 credits for a pack. with a Get credits link.

AI design problems

• Misspelled lettering. Draw the design without text and add the text with the editor's Text tool.
• White fills. Ask for solid black fills, or erase the white in the editor; see above.
• The take did not appear on the ped. Wait a few seconds after the takes show, then tap Take 1. The one marked in use is on the ped.
• The button is disabled. The prompt is empty, or your balance is below 150 credits.
• AI design limit reached (60/hour). Try again later. You made 60 generations within an hour.

Still stuck

Use Report a problem at the bottom right of the pack's page, so we see the pack you mean, or ask in the SwisserAI Discord. Mention your appearance script, the gender of the ped, and what you see in game.