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

# Props em estruturas

> Coloque props da biblioteca do jogo ou do seu projeto dentro de um interior e depois mova, escale, fixe e marque com flags.

Props são a mobília e os acessórios de um interior: bancos, portas, prateleiras, luminárias. Você escolhe um modelo na **Biblioteca de props** e clica na cena para colocá-lo. Props que você modelou na ferramenta **Props** aparecem na mesma biblioteca, em **Do projeto**.

![Dock de ferramentas da estrutura com seis botões de ícone e a dica de Editar geometria aberta](https://mintcdn.com/rageon/_nzjx4zmIQAxf8Hl/images/structures/structures-tools-dock.webp?fit=max\&auto=format\&n=_nzjx4zmIQAxf8Hl\&q=85\&s=532081a13f083a2edde3a60514e65ca1)

O dock esquerdo. Adereços é o terceiro botão; Editar geometria mostra sua dica.

## Coloque um prop

**1. Abra a biblioteca de props**

Clique em **Adereços** no dock esquerdo ou pressione `5`. A **Biblioteca de props** abre em **Do jogo**, e o dock muda para o nível de props (**Ferramentas de props**).

![Diálogo da biblioteca de props com navegação à esquerda, uma grade de blocos de props e um painel de detalhes vazio](https://mintcdn.com/rageon/_nzjx4zmIQAxf8Hl/images/structures/structures-props-library.webp?fit=max\&auto=format\&n=_nzjx4zmIQAxf8Hl\&q=85\&s=882eb438f7857863ccc24b5799aa8aee)

Biblioteca de props em Do jogo.

**2. Encontre o prop**

Digite um nome em **Buscar prop**. **Categoria** e **Origem dos props** (**Todas as origens**, **GTA V e DLCs**, **DLCs**, **Mods**) afinam a lista. Clique em um bloco para ver **Origem**, **Pacote** e **Arquivo**.

![Biblioteca de props filtrada por prop\_bench com prop\_bench\_01a selecionado e seus detalhes à direita](https://mintcdn.com/rageon/_nzjx4zmIQAxf8Hl/images/structures/structures-props-search.webp?fit=max\&auto=format\&n=_nzjx4zmIQAxf8Hl\&q=85\&s=7d889ca9b9e4c740d8ae35c180e79dc3)

Buscando prop\_bench com um bloco selecionado.

**3. Clique em Escolher prop**

O diálogo fecha e um fantasma do prop segue o ponteiro. Os controles **Ponteiro** e **Alinhar à superfície** aparecem na barra de transformação.

![Barra de transformação mostrando Ponteiro em Mapa, Geometria, Grade e a chave Alinhar à superfície, com o dock de props aberto](https://mintcdn.com/rageon/_nzjx4zmIQAxf8Hl/images/structures/structures-props-armed.webp?fit=max\&auto=format\&n=_nzjx4zmIQAxf8Hl\&q=85\&s=c81fb307847a9b69b70aa5c1682d1a49)

Prop armado: o dock de props à esquerda, Ponteiro e Alinhar à superfície na barra acima.

**4. Clique na cena**

O prop é colocado e selecionado, e a seção **Prop** abre na **Ficha da estrutura**. A ferramenta volta para **Selecionar**. Para colocar outro, pressione `5` e escolha de novo.

![Prop de banco selecionado na cena com a seção Prop e os campos de Transformação à direita](https://mintcdn.com/rageon/_nzjx4zmIQAxf8Hl/images/structures/structures-prop-placed.webp?fit=max\&auto=format\&n=_nzjx4zmIQAxf8Hl\&q=85\&s=2ea705fd2da645f58e292c515f54d6f3)

Um banco colocado, selecionado, com as seções Prop e Transformação.

**Ponteiro** escolhe em que o ponteiro pode pousar: **Mapa**, **Geometria**, **Grade**. O mais próximo vence, então desligue **Mapa** para os props não grudarem na rua. **Alinhar à superfície** inclina o prop para a face sob o ponteiro.

> [!NOTE]
>
> O rodapé da biblioteca diz que o prop "stays armed". Não é verdade: cada vez que você escolhe um prop, um clique coloca um prop.

### Favoritos e álbuns

Clique na estrela de um prop do jogo para adicioná-lo a **Favoritos**. **Criar álbum** faz sua própria lista (1 a 64 caracteres, nome único); use **Adicionar a um álbum** em um prop para arquivá-lo. Clique duas vezes no nome de um álbum para renomear. Apagar um álbum mantém os props dele.

![Biblioteca de props mostrando Favoritos com um prop e um álbum chamado Bench props](https://mintcdn.com/rageon/_nzjx4zmIQAxf8Hl/images/structures/structures-props-albums.webp?fit=max\&auto=format\&n=_nzjx4zmIQAxf8Hl\&q=85\&s=45ba4793e833c088e75b06987a9cae5d)

Um prop com estrela em Favoritos e um álbum novo.

Favoritos e álbuns são salvos neste computador e compartilhados por todos os seus projetos. Não ficam guardados dentro de um projeto.

### Props do seu projeto

**Do projeto** lista os props que você fez na ferramenta **Props**. Colocar um cria uma instância que acompanha as edições posteriores do prop. Na seção **Prop**, **Prop do projeto** mostra o arquivo, e **Editar prop** o abre na ferramenta **Props**.

![Seção Prop com um aviso de que o prop do projeto não existe mais e um cartão Prop do projeto](https://mintcdn.com/rageon/_nzjx4zmIQAxf8Hl/images/structures/structures-props-project.webp?fit=max\&auto=format\&n=_nzjx4zmIQAxf8Hl\&q=85\&s=b4b84ac21567179356689f8f3a069e8f)

Um prop do projeto cujo arquivo foi apagado: a seção Prop avisa e oferece a biblioteca.

Para transformar um pedaço de geometria em prop do projeto, clique com o botão direito nele na árvore, escolha **Converter em prop** e dê um nome em **Novo prop**. O objeto é substituído por uma instância do novo prop.

## Mover, girar e escalar

Selecione um prop na cena ou na árvore e pressione `G`, `R` ou `S` para mover, girar ou escalar com o gizmo. `X`, `Y` e `Z` travam um eixo, e **Encostar** define o passo. Para valores exatos use **Transformação**: **Posição (m)**, **Rotação (°)** e **Escala**.

![Barra de transformação com Escala ativa acima das seções Prop e Transformação](https://mintcdn.com/rageon/_nzjx4zmIQAxf8Hl/images/structures/structures-prop-transform.webp?fit=max\&auto=format\&n=_nzjx4zmIQAxf8Hl\&q=85\&s=20a4a2e1cd82ce3befb67d69f6027eb5)

A seção Transformação com Escala ativa.

Com **Escala** ativa e a ferramenta **Selecionar**, arraste as alças da caixa no prop para redimensioná-lo até uma medida. Um canto escala os três eixos; o centro de uma face escala um. **Shift** mantém as proporções e **Alt** não encaixa.

> [!NOTE]
>
> **Escala** X e Y sempre se movem juntos. O jogo guarda um valor só para os dois eixos.

### Mude o pivô

Rotação e escala giram em torno da origem de transformação do prop, e **Posição (m)** lê esse ponto, não a origem do modelo. Pressione `O` (botão **Origem**) e clique em uma alça de origem na caixa do prop, ou escolha um ponto na lista **Origem**: **Origem do modelo**, **Base (centro)**, **Topo (centro)**, **Centro da caixa**, faces, cantos, arestas ou **Personalizado**. **Origem (local, m)** mostra o mesmo ponto em números.

![Caixa do prop com alças laranjas de canto e aresta em um banco selecionado](https://mintcdn.com/rageon/_nzjx4zmIQAxf8Hl/images/structures/structures-prop-origin.webp?fit=max\&auto=format\&n=_nzjx4zmIQAxf8Hl\&q=85\&s=93eb767bab1a5892f0750bbe4e59615e)

Alças na caixa do prop.

O botão e a lista se chamam **Origem**.

## Colocação

![Seção Colocação com a lista Sala aberta e Portal e Conjunto abaixo](https://mintcdn.com/rageon/_nzjx4zmIQAxf8Hl/images/structures/structures-prop-placement.webp?fit=max\&auto=format\&n=_nzjx4zmIQAxf8Hl\&q=85\&s=62347a5af0c74e96210bfd158214d800)

A lista Sala aberta, mostrando auto e o nome da sala. Portal e Conjunto ficam abaixo.

| Opção | O que faz | Padrão |
| - | - | - |
| **Sala** | **auto** põe o prop na sala em que ele está, decidido na exportação. **auto — fora de toda sala** significa que ele não cai em nenhuma sala. Escolha uma sala pelo nome quando o prop toca uma parede e fica fora do contorno. | auto |
| **Portal** | Prende uma porta a um portal para que apareça das duas salas. Uma porta presa a uma sala fica escondida do outro lado. | **— nenhum —** |
| **Conjunto** | Põe o prop em um [conjunto de entidades](/pt-BR/projects/structures/entity-sets.md). Um prop está em um conjunto ou em nenhum, e escolher um conjunto solta o portal. | **— nenhum —** |

Para uma porta, defina **Portal** como a abertura que ela preenche (listadas da mais próxima) e deixe **Conjunto** vazio. Veja [Portais e aberturas](/pt-BR/projects/structures/portals-and-openings.md).

## Renderização e flags

| Opção | O que faz | Padrão |
| - | - | - |
| **lodDist** | A que distância, em metros, o jogo para de desenhar o prop. | 500 |
| **tintValue** | Índice da paleta `_tnt` do modelo. Use 0 quando ele não tem. | 0 |
| **priorityLevel** | Quais props o jogo sacrifica primeiro sob pressão de memória. | 0 |

A seção **Flags** tem uma lista **Flags** e um campo **Valor** que editam o mesmo número. Abra só para mudar o comportamento de sombras ou reflexos; props novos começam com **Cast Static Shadows** e **Cast Dynamic Shadows**. Veja [Flags](/pt-BR/projects/structures/flags.md).

![Seções Renderização e Flags com a lista Flags aberta mostrando Allow Full Rotation e outras entradas](https://mintcdn.com/rageon/_nzjx4zmIQAxf8Hl/images/structures/structures-prop-flags.webp?fit=max\&auto=format\&n=_nzjx4zmIQAxf8Hl\&q=85\&s=e8aa04a1423c5e51ece56b1c8f2f2d0a)

A lista Flags aberta em um prop.

## Remover um prop

Selecione-o e pressione `Del`, ou escolha **Remover prop** em **Ferramentas de props** (`Shift 5`) e clique em cada prop na cena. `Ctrl Z` desfaz.

![Dock de props com o botão Remover prop ativo](https://mintcdn.com/rageon/_nzjx4zmIQAxf8Hl/images/structures/structures-prop-remove.webp?fit=max\&auto=format\&n=_nzjx4zmIQAxf8Hl\&q=85\&s=58a0b34fe7b6908b700fcf42df537737)

Remover prop armado no dock de props.

## Troque o modelo

Clique no cartão **Archetype** (ou **Prop do projeto**) na seção **Prop**. A biblioteca abre em modo de troca; escolha um bloco e clique em **Trocar prop**. Posição, rotação, sala, portal e conjunto permanecem.

## Solução de problemas

> **Nenhum prop encontrado. Tente outro nome, origem ou categoria.**
>
> Mude a palavra da busca, defina **Origem dos props** como **Todas as origens** ou limpe **Categoria**.

> **Não foi possível buscar os props**
>
> Clique em **Tentar novamente**. Se continuar falhando, confira se a pasta do seu jogo está indexada.

> **Nenhum prop neste projeto. Crie um em Modelagem › Props.**
>
> **Do projeto** está vazio. Faça um prop na ferramenta **Props** primeiro.

> **The prop "…" no longer exists in the project.**
>
> O arquivo por trás de um prop do projeto foi removido. Isto bloqueia a exportação. Troque o prop por outro, ou recrie-o na ferramenta **Props**.

> **"…" is outside any room and will fall into the limbo.**
>
> Isto é um aviso. Mova o prop para dentro de uma sala, ou fixe **Sala** na sala que ele toca.

> **"…" is attached to a portal and in a set: release it from one of the two.**
>
> Isto bloqueia a exportação. Defina **Conjunto** ou **Portal** como **— nenhum —**.

> **An archetype "…" already exists in the game: this structure will overwrite the original.**
>
> Isto é um aviso sobre o nome da própria estrutura: ele coincide com um interior que já existe no jogo, então exportar substitui esse interior. Renomeie a estrutura, a menos que substituir o original seja o que você quer.

> **Doors ignore scale in game: "…" will show at its own size. Pick a door model that fits the opening.**
>
> Isto é um aviso. Volte a **Escala** para 1 e escolha um modelo de porta do tamanho certo.

> **Já existe um álbum com esse nome.**
>
> Nomes de álbum são únicos. Escolha outro nome.


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