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

# Editor de props

> Ferramentas, vistas, geometria, material, colisão, origem e a ficha do prop no editor de Props.

O editor de props é o editor de [Estruturas](/pt-BR/projects/structures/geometry.md) reduzido a um objeto sobre um chão vazio. As ferramentas de geometria, textura e flags funcionam do mesmo jeito, então esta página cobre só o que é diferente em Props. Um prop não tem salas, portais nem luzes, e não tem mapa.

Vários rótulos ainda dizem "estrutura": a seção **Estrutura** da coluna da direita, o campo **Buscar na estrutura**, o menu **Adicionar à estrutura**, a aba **Nesta estrutura** da biblioteca de texturas e o diálogo de configurações **Renderização das estruturas**. Leia como "prop".

## Layout

De cima para baixo, o editor tem a barra de ferramentas, a barra de transformação, o palco e a coluna de detalhes à direita. Ele sempre abre em **Perspectiva**.

![Editor de props em uma grade vazia com a barra de ferramentas, a barra de transformação, três grupos de ferramentas à esquerda e a coluna de detalhes](https://mintcdn.com/rageon/SL02705KjqddBRzg/images/props/props-editor-empty.webp?fit=max\&auto=format\&n=SL02705KjqddBRzg\&q=85\&s=91f9f9a362c552b18556bcdb05e4a3d3)

Um prop vazio com a barra de ferramentas, a barra de transformação, as ferramentas e a coluna da direita.

| Parte | O que faz |
| - | - |
| **Voltar à lista de props** | Volta à lista. Com edições não salvas, **Fechar prop** avisa que voltar as descarta. |
| Nome ao lado de **props** | Renomeia o prop, igual na lista. Desativado enquanto houver mudanças não salvas. |
| **Objeto / Face / Edge / Vertex** | **Objeto** escolhe objetos inteiros e os move. Os outros três mudam para **Editar geometria** nesse nível. |
| **Planta / Perspectiva** | **Perspectiva** orbita o prop sozinho. **Planta** olha direto de cima e mostra **Map plan · Z cut off** no palco. |
| Selo do projeto | Mostra o nome do projeto e **Salvo**, **Não salvo** ou **Falhou**. O menu dele tem **Salvar**, **Exportar** e **Ficha do projeto…**. |

![Editor de props na vista em Planta mostrando a caixa vista de cima](https://mintcdn.com/rageon/SL02705KjqddBRzg/images/props/props-plan-view.webp?fit=max\&auto=format\&n=SL02705KjqddBRzg\&q=85\&s=ed4b34753e0a5f1aba0d815f0fd35f82)

Vista em planta do vaso.

A barra de transformação é a de Estruturas, menos **World/Local** a menos que a seleção tenha rotação, e menos **Origem**, que precisa de um prop colocado.

A engrenagem no canto superior esquerdo do palco abre **Renderização das estruturas** com os ajustes do renderer, o mesmo diálogo da aba **Mapa**.

## Ferramentas

Um prop tem duas ferramentas, porque salas, portais e luzes não existem aqui.

| Ferramenta | Tecla | O que faz |
| - | - | - |
| **Editar geometria** | **7** | Edita faces, arestas e vértices. |
| **Criar geometria** | **9** | Desenha uma caixa, plano, cilindro, rampa, escada ou contorno. |

Abaixo delas, **Selecionar** (**V**), **Seleção por Caixa** (**B**) e **Vista** (**N**) estão sempre disponíveis.

![Nó Geometria com Forma em Caixa e os campos de tamanho](https://mintcdn.com/rageon/SL02705KjqddBRzg/images/props/props-create-geometry.webp?fit=max\&auto=format\&n=SL02705KjqddBRzg\&q=85\&s=54019e4b793e4a43b811846f047a1292)

O nó Geometria, fixado ao lado das ferramentas.

**Criar geometria** desenha um objeto por gesto e depois entra em **Editar geometria** com as faces dele selecionadas. Os campos da forma guardam os valores para o próximo objeto. **Alinhar à superfície** desenha na face sob o ponteiro; desligue para desenhar no plano da grade. **Ponteiro** define onde o ponteiro pousa enquanto você desenha: **Geometria**, **Grade** ou os dois.

## Geometria

**Editar geometria** troca as ferramentas pelas de modelagem, com **Voltar ao prop** como primeiro botão. As ferramentas são as mesmas de Estruturas: **Extrude**, **Inset**, **Bevel**, **Loop corte**, **Bisect**, **Knife** e **Slide**, mais os grupos **Fechar e conectar**, **Limpar e triangular** e **Separar e remover**. Veja [Geometria](/pt-BR/projects/structures/geometry.md) para saber como cada uma se comporta.

![Editor de props em Editar geometria com o dock de ferramentas de Modelagem e o popover Fechar e conectar](https://mintcdn.com/rageon/SL02705KjqddBRzg/images/props/props-modeling-dock.webp?fit=max\&auto=format\&n=SL02705KjqddBRzg\&q=85\&s=d0664983e54e66039fc3af06f4da18bd)

Ferramentas de modelagem com as ações de Fechar e conectar abertas.

Uma forma que você desenhou continua editável pelos parâmetros dela, com **Duplicar** e **Converter em malha editável**, até você convertê-la. **History** lista toda ação de malha do prop na ordem em que se aplica. Clique em uma linha para ajustá-la; o olho a desliga sem apagar.

A árvore **Estrutura** lista os objetos do prop na raiz. **Novo grupo** e **Importar modelo…** são os únicos itens do menu **+** dela. Grupos só organizam a árvore e não chegam à exportação.

![Árvore Estrutura com o menu de linha de um objeto listando Renomear, Enquadrar, Ocultar, Isolar, Travar, Duplicar, Agrupar e Apagar](https://mintcdn.com/rageon/SL02705KjqddBRzg/images/props/props-tree-menu.webp?fit=max\&auto=format\&n=SL02705KjqddBRzg\&q=85\&s=771e502eb4245738c15d8272b120013a)

O menu de linha de um objeto na árvore.

## Material e texturas

Selecione faces em **Editar geometria**, ou escolha um objeto na árvore, e use **Material**. **Biblioteca** abre a **Biblioteca de texturas**; **Importar** copia uma imagem para o projeto e a aplica. Os dois funcionam como em [Texturas](/pt-BR/projects/structures/textures.md).

Um prop só pode exportar uma textura que venha de um dicionário do jogo ou de uma imagem importada. Uma textura marcada como peça de mapa funciona só como prévia, e o Verificador bloqueia a exportação até você escolher outra.

![Biblioteca de texturas em Jogo e mods com um campo de busca e uma grade de texturas](https://mintcdn.com/rageon/SL02705KjqddBRzg/images/props/props-texture-library.webp?fit=max\&auto=format\&n=SL02705KjqddBRzg\&q=85\&s=9acea7a0f538ef2999cb45053a652a8b)

A Biblioteca de texturas com uma busca.

**Tipo** define a família do material: **Opaco**, **Vidro**, **Emissivo**, **Emissivo à noite** ou **Recorte (alfa duro)**. Os tipos de água também aparecem na lista, mas um prop não tem lugar no mundo para água, então o Verificador avisa que ela fica de fora da exportação. Não os use em um prop.

![Seção Material com a textura, Tipo, Normal map, Specular map, Colisão e mapeamento UV](https://mintcdn.com/rageon/SL02705KjqddBRzg/images/props/props-material-applied.webp?fit=max\&auto=format\&n=SL02705KjqddBRzg\&q=85\&s=bc7d1b1d54f4523a66f56ddbb2951a26)

Material e colisão das faces selecionadas.

## Colisão

O bloco **Colisão** do **Material** decide onde cada face existe no jogo.

| Superfície | Resultado |
| - | - |
| **Desenho e colisão** | Visível e sólida. O padrão. |
| **Só desenho** | Visível, sem colisão. Use para grama e decals. |
| **Só colisão** | Um bloqueio invisível. |
| **Rampa de escada** | Uma rampa suave sobre degraus em que só o ped do jogador anda. Não é desenhada. |

**Material de colisão** define o som dos passos, as marcas de bala e as partículas. **Flags de colisão** são as mesmas de [Flags](/pt-BR/projects/structures/flags.md).

A linha **Colisão** da seção **Prop** conta as faces que colidem. Em zero, a linha é trocada por um laranja **Nenhuma face colide, então o jogador atravessa o prop.**

## A ficha do prop

Clique em **Selecionar** sem nada escolhido e a seção **Prop** aparece na coluna da direita.

![Seção Prop com Nome, lodDist, hdTextureDist, Triângulos, Vértices, Caixa, Colisão e o botão de origem](https://mintcdn.com/rageon/SL02705KjqddBRzg/images/props/props-prop-sheet.webp?fit=max\&auto=format\&n=SL02705KjqddBRzg\&q=85\&s=faafbb972a6ce9d3bb9d76fdcb44f9de)

A seção Prop: nome, distâncias de desenho, contagens, colisão e o botão de origem.

| Campo | O que faz | Padrão |
| - | - | - |
| **Nome** | Renomeia o prop e o arquivo dele. Ativo só sem mudanças não salvas. | O nome do prop |
| **lodDist** | Distância em metros em que o jogo para de desenhar o prop. | 500 |
| **hdTextureDist** | Distância em metros até a qual o jogo usa texturas de alta resolução. | 100 |
| **Triângulos**, **Vértices** | Contagens do que será exportado. Os dois mostram 0 quando o prop não pode ser exportado. | — |
| **Caixa (m)** | Largura, profundidade e altura das faces do prop. | — |
| **Colisão** | Quantas faces colidem. | — |

### Origem

A origem é o ponto que cai onde você coloca o prop. Clique em **Pôr a origem no centro da base** para mover o modelo inteiro de modo que o centro da base dele fique nela. É um passo de desfazer. O botão fica desativado quando a origem já está lá.

![Seção Prop com o botão de origem desativado](https://mintcdn.com/rageon/SL02705KjqddBRzg/images/props/props-origin-base.webp?fit=max\&auto=format\&n=SL02705KjqddBRzg\&q=85\&s=cf6007f22330a714d55ad83de066070a)

Depois de mover a origem para a base.

## O painel Vista

**Vista** (**N**) abre uma coluna na borda direita do palco com **Câmera**, **Grid de orientação** e **Rótulos**. **Câmera** aceita posição, direção e pitch exatos, e fica desativada em **Planta**. A grade também é o plano em que **Criar geometria** desenha. Um prop não tem caixa de render nem ajustes de mapa.

![Painel Vista com as seções Câmera, Grid de orientação e Rótulos](https://mintcdn.com/rageon/SL02705KjqddBRzg/images/props/props-view-panel.webp?fit=max\&auto=format\&n=SL02705KjqddBRzg\&q=85\&s=10cc87da891854ab00e6b518a85027b1)

O painel Vista de um prop.

## Salvar

**Ctrl+S** salva o prop e atualiza a prévia no cartão dele. O menu do selo também exporta o projeto.

![Menu do selo do projeto com Salvar, Exportar e Ficha do projeto](https://mintcdn.com/rageon/SL02705KjqddBRzg/images/props/props-save-badge.webp?fit=max\&auto=format\&n=SL02705KjqddBRzg\&q=85\&s=258421bf517df144c364e168abe4ddbb)

O menu do selo do projeto.

## O Verificador

A seção **Verificador** lista o que bloqueia a exportação (vermelho, erros) e o que não bloqueia (laranja, avisos). **Pronto para exportar** significa que está limpo. Clique em uma linha para selecionar as faces ou o objeto que ela cita.

| Mensagem | Tipo | O que fazer |
| - | - | - |
| **… faces sem textura. Clique para marcá-las e aplique uma textura antes de exportar.** | Erro | Selecione as faces e aplique uma textura. |
| **… faces com a textura "…" sem dicionário (.ytd). Clique para marcá-las e escolha a textura de novo.** | Erro | Escolha uma textura de dicionário do jogo ou importe uma imagem. |
| **Já existe um archetype "…" no jogo. Escolha outro nome para o prop.** | Erro | Renomeie o prop. |
| **Prop sem triângulos: fica de fora da exportação.** | Aviso | Desenhe geometria. |
| **Nenhuma face do prop tem colisão.** | Aviso | Defina ao menos uma face como **Desenho e colisão**. |
| **Um prop não tem lugar no mundo: a água de mundo dele fica de fora da exportação.** | Aviso | Mude o **Tipo** dessas faces. |

![Seção Verificador com um selo vermelho e um erro sobre faces sem textura](https://mintcdn.com/rageon/SL02705KjqddBRzg/images/props/props-checker-no-texture.webp?fit=max\&auto=format\&n=SL02705KjqddBRzg\&q=85\&s=08bf8a75cd135fd0d1e6b61b1f3015ce)

O Verificador com um erro.

## Solução de problemas

> **Preparando a vista…**
>
> A vista 3D está iniciando. Se falhar, clique em **Tentar novamente**.

> **Salve o prop para renomeá-lo.**
>
> O campo **Nome** é somente leitura enquanto o prop tem mudanças não salvas. Pressione **Ctrl+S** e depois renomeie.

> **O modelo conflita com uma edição existente. Revise a proposta.**
>
> Você importou um modelo enquanto havia uma ação de malha pendente. Resolva o aviso na coluna da direita e importe de novo.

> **Não foi possível verificar se o nome do prop já existe no jogo. Abra um workspace para verificar.**
>
> A pasta do GTA V ainda não está indexada. Configure em **Configurações** e espere o índice terminar.


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