> ## Documentation Index
> Fetch the complete documentation index at: https://docs.rageon.dev/llms.txt
> Use this file to discover all available pages before exploring further.

# Skins de arma

> Pinte uma skin de arma na textura da própria arma e aplique por id em um servidor FiveM.

Uma **Skin** é uma textura de arma que seu servidor aplica pelo nome. Ela é marcada como **FiveM** porque só funciona em um servidor FiveM: skins sempre vão em jogo pelo `rageon-bridge`, nunca como arquivo substituído.

## Crie uma skin

**1. Escolha a arma**

Em **Nova edição**, selecione **Skin**, busque uma arma como `w_pi_pistol`, clique nela e clique em **Continuar**. Se o projeto já tem uma skin para essa textura de arma, o Rageon a reabre e pula a etapa de nomear.

**2. Dê nome à skin**

**Nome da skin** pede um **Id**, o nome pelo qual seu servidor a chama. O Rageon sugere um a partir do nome da arma. Ao digitar, o id vira minúsculo e os espaços viram `_`. Clique em **Criar**.

![Diálogo Nome da skin com o campo Id e o nome da arma](https://mintcdn.com/rageon/MDCPTWhXTgKhzlYR/images/pt_br/textures/texturing-skin-name.webp?fit=max\&auto=format\&n=MDCPTWhXTgKhzlYR\&q=85\&s=b7bce24caacaab93bdeba91513604b7c)

O diálogo Nome da skin.

**3. Pinte no palco**

O palco mostra a textura da própria arma com os pixels do jogo por baixo. Adicione camadas ([Camadas e ferramentas](/pt-BR/projects/texturing/layers-and-tools.md)). Camadas de **Texto** em uma skin podem usar variáveis ao vivo como `{ammo}`; clique no botão **?** para ver a lista. GIFs importados animam em skins.

![Skin aberta na pistola com uma camada de texto e a arma na prévia 3D](https://mintcdn.com/rageon/MDCPTWhXTgKhzlYR/images/pt_br/textures/texturing-skin-stage.webp?fit=max\&auto=format\&n=MDCPTWhXTgKhzlYR\&q=85\&s=6478eb076d738362b7e2f0591c6e3902)

Uma skin com uma camada de texto usando \{ammo}.

Clique duas vezes no id no cabeçalho para renomeá-lo depois. Não há chave **Arquivo** | **Em jogo** em skins.

## Use no jogo

A exportação grava `skins.json` e uma pasta `skins/<id>/` contendo `art.webp` para uma skin estática ou `frame_*.webp` para animação, além de `player.html`. Mantenha esses arquivos juntos no resource exportado.

Instale o `rageon-bridge` no servidor (**Configurações** › **Bridge**) e inicie-o antes do seu resource: `ensure rageon-bridge`. Os jogadores aplicam uma skin com `/skin`, `/skin <id>` e `/skin off`, ou de um script:

```lua theme={null}
exports['rageon-bridge']:applySkin('<id>')
```

> [!WARNING]
>
> A troca é global no cliente: toda arma desse modelo mostra a skin, só uma skin fica ativa por vez, e a arte é espelhada nos dois lados da arma.

## Solução de problemas

> **O id não pode ficar vazio.**
>
> Digite um id no campo **Id**.

> **No máximo 48 caracteres.**
>
> Encurte o id.

> **Só minúsculas, números e \_.**
>
> Remova os outros caracteres do id.

> **Já existe uma skin com este id neste projeto.**
>
> Escolha outro id.

> **Outra skin ou troca deste projeto usa o mesmo id — o export vai recusar**
>
> Clique duas vezes no nome em um dos cartões e renomeie.

> **O servidor … precisa do rageon-bridge … ou mais recente para trocas no jogo.**
>
> Atualize o `rageon-bridge` no servidor em **Configurações** › **Bridge**.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.