Retexturize uma arma do FiveM sem abrir um programa de modelagem

Como funciona uma skin de arma

Todo modelo de arma lê o visual de um dicionário de texturas — um .ytd com o nome da arma, com uma folha por peça. O modelo pede a textura pelo nome, então trocar a imagem por trás desse nome muda a aparência da arma sem mexer no modelo.

É isso que esta ferramenta entrega: as folhas que você pintou, empacotadas de volta no próprio dicionário da arma, com os nomes que os shaders dela já pedem. Sem modelo, sem metadata — por isso carrega com ensure em vez de exigir uma reinicialização completa do servidor.

Armas têm mais de uma folha

Um fuzil não é uma textura só. O corpo, o carregador, a coronha e a mira costumam ficar em folhas separadas, e o editor lista cada uma que encontra. Pinte só o corpo e o carregador continua vanilla — o que normalmente é o que você quer, e às vezes é uma surpresa.

A prévia 3D liga cada folha ao mesh que realmente a usa, então uma peça que você não pintou mantém o visual original na tela exatamente como vai ficar no jogo. Se uma peça nunca muda, não importa o que você pinte, ela está lendo uma textura compartilhada que fica em outro dicionário — decals e folhas de camuflagem fazem isso — e essa não pode ser trocada por aqui.

O modo replace muda para todo mundo

A exportação é um replace: todas as unidades dessa arma no servidor usam a sua pintura. Não existe escolha por jogador, porque a arma vanilla tem um único dicionário de texturas e você acabou de substituí-lo.

Skins por jogador são um mecanismo totalmente diferente — o GTA faz isso com componentes de camuflagem, e só as quinze armas Mk II têm o bone que dá suporte a eles. Armas addon, que trazem uma segunda arma ao lado da vanilla, estão chegando aqui, mas ainda não foram liberadas.

Instalação

Solte a pasta nos seus resources, adicione ensure <resource> ao server.cfg e inicie. Esta exportação não tem metadata, então reiniciar o resource basta — sem reiniciar o servidor inteiro, sem arquivos meta para mesclar.