Como criar um pack de tatuagens para FiveM

O que uma tatuagem do FiveM realmente é

Uma tatuagem não é uma mesh: é um overlay de decoração do ped. O jogo tem uma PedDecorationCollection que lista cada tatuagem com uma posição de UV, uma escala, uma rotação e uma zona do corpo, e aponta para uma textura em um .ytd em streaming. Depois o seu script de aparência aplica a tatuagem com AddPedDecorationFromHashes.

Acertar essa coleção na mão é chato: o nome da coleção tem que terminar em _overlays, o nome do dicionário de texturas tem que ser derivado dele, e a coleção precisa da sua própria entrada nameHash. Esqueça essa e a tatuagem aparece no menu, mas não desenha nada.

Crie um pack em 4 passos

1. Envie o seu desenho. Um PNG com transparência. Ele é recortado em quadrado para não ficar esticado.
2. Posicione no ped. Ative o modo de posicionamento e clique no corpo: tronco, braços, pernas ou cabeça. O cursor em anel mostra onde e com que tamanho a tatuagem vai ficar, e ela é desenhada no modelo enquanto você trabalha.
3. Ajuste. Tamanho uniforme, ou desvincule largura e altura para esticar. Presets de rotação em passos de 90 graus, ou rotação livre no painel 2D.
4. Exporte. Você recebe o XML de overlay, um .ytd por tatuagem, um manifest e arquivos de config para illenium-appearance, qb, ESX, rcore, Menyoo e standalone.

Instalando: o único detalhe que pega

Coloque o resource em resources, adicione no seu server.cfg e depois reinicie o servidor por completo.

Depois cole o bloco de config correspondente na lista de tatuagens do seu script de aparência e as entradas aparecem no menu do personagem.

Por que o tamanho no jogo é diferente da prévia

A escala de tatuagem do jogo não é um para um com os pixels da tela, então o exportador aplica um fator de calibração aos valores que escreve. O que você vê no editor é o que você tem no jogo. Se um desenho ainda ficar um pouco fora do lugar em algum ped específico, ajuste o uvPos no XML exportado: todos os valores são texto puro.