> ## 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.

# Texturas de modelo e globais

> Repinte uma textura de um veículo, ped, arma, peça de roupa ou prop, ou uma textura em um dicionário compartilhado, e escolha como ela chega ao jogo.

**Textura de modelo** deixa você escolher um modelo e uma das texturas dele. **Textura global** deixa você escolher um dicionário `.ytd` diretamente. Qualquer um dos caminhos pode chegar a uma textura compartilhada: se o aviso disser que outros modelos a usam, a edição muda esses modelos também.

## Edite uma textura de modelo

**1. Escolha o modelo**

Em **Nova edição**, selecione **Textura de modelo**. A lista é o mesmo catálogo do Visualizador. Abra **Opções** e defina o **Tipo de modelo** para passar de **Veículos** para **Peds**, **Armas**, **Roupas** ou **Adereços**, e então busque em **Buscar modelos...**.

![Nova edição em Textura de modelo com o modelo adder, uma grade de texturas e a faixa de detalhes](https://mintcdn.com/rageon/MDCPTWhXTgKhzlYR/images/pt_br/textures/texturing-new-edit-model.webp?fit=max\&auto=format\&n=MDCPTWhXTgKhzlYR\&q=85\&s=9b6177641af4ae8b604677b73ac75d7e)

Textura de modelo: o Adder, suas texturas e a faixa de detalhes.

![Nova edição com Opções aberto e Tipo de modelo definido como Adereços](https://mintcdn.com/rageon/MDCPTWhXTgKhzlYR/images/pt_br/textures/texturing-new-edit-props.webp?fit=max\&auto=format\&n=MDCPTWhXTgKhzlYR\&q=85\&s=858365c103ce2e2971b68bca61c5e8cf)

Tipo de modelo definido como Adereços.

**2. Escolha uma textura**

Cada bloco mostra uma prévia, o nome da textura, o uso, o tamanho e o formato. Afine a grade com **Uso da textura** (por exemplo **Pintura**, **Decalque**, **Normais**) ou **Buscar texturas**. Um cadeado significa que a textura não pode ser editada; o bloco diz por quê. Um visto significa que a textura já está no projeto.

Prefira **Pintura** ou **Decalque** para arte. **Cor da base** muda as superfícies que usam aquela textura; confira o mapa UV e a prévia 3D.

**3. Clique em Continuar**

O palco 2D mostra a textura do jogo e a prévia 3D mostra o modelo vestindo suas camadas. Se o projeto já edita esta textura, **Continuar** reabre essa edição.

Um modelo também pode chegar já escolhido: pela aba Assets, em **Abrir em** › **Projetos** › **Editar textura** ([Enviar para Projetos](/pt-BR/assets/send-to-project.md)), ou pela aba Mapa como **Modelo do mapa**.

## Edite uma textura global

**1. Escolha o dicionário**

Selecione **Textura global**. A lista mostra dicionários de texturas em vez de modelos. Escolha um e depois um bloco de textura.

![Nova edição em Textura global com o dicionário compartilhado selecionado e o aviso de que a edição afeta todos os modelos que usam a textura](https://mintcdn.com/rageon/MDCPTWhXTgKhzlYR/images/pt_br/textures/texturing-new-edit-global.webp?fit=max\&auto=format\&n=MDCPTWhXTgKhzlYR\&q=85\&s=dd31e1be30273244c1167f9aa97e0478)

Uma textura escolhida do dicionário compartilhado, com o aviso de compartilhamento.

**2. Clique em Continuar**

Um banner avisa que outros modelos usam o mesmo arquivo. Uma edição nova aberta a partir de um dicionário não tem prévia de modelo 3D.

> [!WARNING]
>
> "A edição afeta todos os modelos que usam esta textura." é literal: um dicionário compartilhado muda todo modelo que o lê. Confira a faixa de detalhes antes de continuar.

## Entregue a textura no jogo

O cabeçalho de uma edição simples de modelo ou dicionário tem uma chave **Arquivo** | **Em jogo**. Ela decide como o resultado chega ao jogo.

| Modo | O que acontece |
| - | - |
| **Arquivo** | A textura sai em `stream/` e substitui a textura do jogo. Padrão. |
| **Em jogo** | O `rageon-bridge` troca a textura enquanto o servidor roda, por um id que você escolhe. Nenhum arquivo `stream/` é gravado para ela. O servidor precisa do `rageon-bridge` 2.2.0 ou posterior. |

**1. Clique em Em jogo**

O Rageon confere se a textura pode ser trocada.

**2. Dê nome à troca e clique em Confirmar**

**Id da troca** pede o id que seus scripts vão usar e descreve a quais modelos a troca chega.

![Cabeçalho do editor com a chave Em jogo e o diálogo Id da troca](https://mintcdn.com/rageon/MDCPTWhXTgKhzlYR/images/pt_br/textures/texturing-swap-id.webp?fit=max\&auto=format\&n=MDCPTWhXTgKhzlYR\&q=85\&s=8c96831629a4dfb6404ced5d9e4e0364)

A chave Arquivo | Em jogo e o diálogo Id da troca.

A exportação grava `textures.json` e uma pasta `textures/<id>/` com imagens `art.webp` ou `frame_*.webp` animadas e `player.html`. Mantenha-os juntos no resource exportado.

O cartão ganha um selo **FiveM**. Volte para **Arquivo** para remover o id; **Ctrl+Z** desfaz.

No jogo, chame `exports['rageon-bridge']:applyTexture('<id>')` de um script de cliente ou `exports['rageon-bridge']:applyTextureForAll('<id>')` de um script de servidor. As chamadas correspondentes `exports['rageon-bridge']:removeTexture('<id>')` e `exports['rageon-bridge']:removeTextureForAll('<id>')` restauram o original. Uma troca afeta todo modelo que usa a textura original, e duas trocas não podem ser donas da mesma.

A chave não aparece em liveries, variantes de roupa, no minimapa, em tatuagens, sobreposições, paletas nem skins. Skins sempre vão em jogo.

## Limites e planos

Trocas em jogo só funcionam no FiveM e exigem o `rageon-bridge` no servidor. Um bridge mais antigo mostra um aviso no diálogo de exportação. Atualize em **Configurações** › **Bridge**. As texturas por projeto dependem do seu plano; veja [rageon.dev/pricing](https://rageon.dev/pricing).

## Solução de problemas

> **A edição continua em Arquivo. …**
>
> O pedido de **Em jogo** foi recusado, então a edição fica em **Arquivo**. Confira o motivo mostrado. Uma textura embutida em um `.ydd` não pode ser trocada em jogo e precisa ser exportada como arquivo.

> **Não foi possível descobrir como trocar esta textura em jogo.**
>
> O Rageon não achou como endereçar esta textura em tempo de execução. Mantenha a edição em **Arquivo**.

> **Este id já está em uso neste projeto.**
>
> Escolha outro id de troca. Os ids precisam ser únicos no projeto.

> **Two in-game swaps use ….**
>
> Só uma troca pode ser dona de uma textura original. Remova ou mude uma delas.

> **Duas edições em jogo deste projeto têm o mesmo id (…). Renomeie uma delas antes de exportar.**
>
> Clique duas vezes no nome em um dos cartões e dê outro id a ele.

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

> **Nenhuma textura encontrada**
>
> Nada corresponde aos seus filtros. Clique em **Limpar filtros**.


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