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

> Modele um objeto personalizado uma vez e coloque-o em qualquer estrutura do projeto ou faça o spawn por script.

Um prop é um objeto personalizado salvo no seu projeto: um nome, geometria, materiais com texturas e colisão. O nome é o nome do modelo que o jogo usa. Você coloca o mesmo prop quantas vezes quiser nas estruturas do projeto, ou o cria por script. Todo prop do projeto vai com o resource do projeto quando você [exporta](/pt-BR/projects/props/export.md).

Props não tem mapa em volta. Você modela sobre um chão vazio e coloca o resultado a partir de [Estruturas](/pt-BR/projects/structures/props-in-structures.md) ou por script.

## Abrir a ferramenta Props

Abra a aba **Projetos**, abra um projeto e clique em **Adereços** em **Modelagem** na barra **Ferramentas**. Um projeto precisa de uma pasta antes de poder guardar props, porque eles são salvos em uma pasta `props/` ao lado do arquivo `.gxp`. Clique em **Salvar** na barra do projeto e escolha uma pasta primeiro.

![Barra Ferramentas com Modelagem expandida e Props selecionado, e a lista vazia mostrando Nenhum prop com os botões Importar modelo e Novo prop](https://mintcdn.com/rageon/SL02705KjqddBRzg/images/props/props-tool-rail.webp?fit=max\&auto=format\&n=SL02705KjqddBRzg\&q=85\&s=9b8fc2f936d9a09dcec4661b640f81e7)

A ferramenta Props em um projeto ainda sem props.

Em um projeto que nunca foi salvo, a lista mostra **Salve o projeto para começar** e os dois botões ficam desativados.

![Lista de props com a mensagem Salve o projeto para começar e botões desativados](https://mintcdn.com/rageon/SL02705KjqddBRzg/images/props/props-list-no-folder.webp?fit=max\&auto=format\&n=SL02705KjqddBRzg\&q=85\&s=40e5e30d02f201443ec7625640e1e657)

Um projeto não salvo não pode guardar props.

## A lista de props

Cada prop é um cartão com uma prévia, o nome e a data da última modificação. A prévia é salva com o prop, então um prop que você nunca salvou com geometria mostra um ícone de caixa. Clique em um cartão para abrir o prop no [editor](/pt-BR/projects/props/editor.md).

![Grade de cartões de props, incluindo um cartão com ícone de aviso e um cartão com um nome muito longo](https://mintcdn.com/rageon/SL02705KjqddBRzg/images/props/props-list-gallery.webp?fit=max\&auto=format\&n=SL02705KjqddBRzg\&q=85\&s=56b29b9ef4286eefe8145a02c7c48e5e)

Vinte props, um nome muito longo e dois cartões que não abrem.

Um cartão com ícone de aviso não abre e mostra o motivo no lugar: **Um prop deve ter uma única parte.** ou **Outro prop já usa este id.** Um arquivo que não pode ser lido mostra o erro de leitura. Esses cartões só oferecem o ícone de lixeira. Um arquivo quebrado em `props/` também bloqueia a exportação do projeto até você apagá-lo ou repará-lo.

## Criar um prop

**1. Clique em Novo prop**

O diálogo **Novo prop** abre. Em uma estrutura, **Converter em prop** em um objeto abre o mesmo diálogo.

**2. Digite um Nome do prop**

O nome vira o nome do modelo e o nome do arquivo: minúsculas, sem acentos, e tudo que não for letra ou dígito vira `_`. **Vinewood Planter** vira `vinewood_planter`. **Criar prop** fica desativado enquanto o nome não tem letra nem dígito, ou enquanto outro prop do projeto já o usa.

![Diálogo de novo prop com Docs Planter digitado no campo Nome do prop](https://mintcdn.com/rageon/SL02705KjqddBRzg/images/props/props-new-prop-dialog.webp?fit=max\&auto=format\&n=SL02705KjqddBRzg\&q=85\&s=ab91b3ef485b6ae7d8c98d6bde7f06f8)

Dando nome a um novo prop.

**3. Clique em Criar prop**

O editor abre em um prop vazio.

## Importar um modelo

**Importar modelo** cria um prop a partir de um arquivo `.glb`, `.ydr` ou `.ydr.xml` e o nomeia com o nome do arquivo. Um nome que já está em uso recebe `_2`, `_3` e assim por diante. As imagens embutidas em um `.glb` são copiadas para o projeto com os materiais, e um `.ydr` é convertido automaticamente.

Para adicionar um modelo a um prop que você já tem, clique em **+** na seção **Estrutura** e escolha **Importar modelo…**. Os novos objetos entram no prop aberto.

> [!WARNING]
>
> Modelos importados mantêm a posição que têm no arquivo. Confira **Caixa (m)** na seção **Prop** e use **Pôr a origem no centro da base** se o prop flutuar ou ficar embaixo da terra quando colocado.

Se o nome coincidir com um prop do jogo, o Verificador mostra um erro e a exportação é bloqueada. Renomeie o prop no cabeçalho do editor ou no campo **Nome** da seção **Prop**. Veja [O Verificador](/pt-BR/projects/props/editor.md#o-verificador).

## Renomear e apagar

Clique duas vezes no nome de um cartão para renomeá-lo. O arquivo e o nome do modelo mudam junto, e as estruturas que usam o prop acompanham o novo nome.
O ícone de lixeira em um cartão apaga o prop depois de uma confirmação. Isso não pode ser desfeito.

![Diálogo de apagar prop pedindo para apagar o prop docs\_planter](https://mintcdn.com/rageon/SL02705KjqddBRzg/images/props/props-delete-confirm.webp?fit=max\&auto=format\&n=SL02705KjqddBRzg\&q=85\&s=48100b0e12882ef9a1447c2817213730)

Apagar um prop pede confirmação.

> [!WARNING]
>
> Apagar um prop que estruturas usam deixa cada instância apontando para o nada. Cada instância informa que o prop não existe mais, e a exportação do projeto continua bloqueada até você remover as instâncias ou criar o prop de novo.

## Limites e planos

Todo plano pode abrir a ferramenta Props. O número de props que um projeto pode guardar segue o mesmo limite por projeto das estruturas: além dele, **Novo prop** e **Importar modelo** falham com **Seu plano permite até … estruturas por projeto.** Veja os [preços](https://rageon.dev/pricing) para saber o que cada plano inclui.

## Solução de problemas

> **Salve o projeto primeiro — o prop mora na pasta .gxp**
>
> O projeto ainda não tem pasta. Clique em **Salvar** na barra do projeto, escolha uma pasta e tente de novo.

> **Já existe um prop chamado "…" neste projeto.**
>
> Outro prop já usa esse nome de arquivo. Escolha um nome diferente.

> **Salve o prop aberto antes de renomeá-lo.**
>
> O prop tem mudanças não salvas. Pressione **Ctrl+S** e depois renomeie.

> **Não foi possível importar o modelo: … não tem faces**
>
> O arquivo não tem malha, só pontos ou linhas. Escolha um arquivo que traga uma malha.

> **Seu plano permite até … estruturas por projeto.**
>
> O projeto já guarda tantos props quantas estruturas o seu plano permite. Apague um prop de que não precisa mais, ou confira os [preços](https://rageon.dev/pricing).

> **Não foi possível carregar os props: …**
>
> O Rageon não conseguiu ler a pasta `props/`. Confira se a pasta existe e se você pode lê-la, e reabra o projeto.

## Próximos passos

> **[Seu primeiro prop](/pt-BR/projects/props/first-prop.md)**
>
> Modele, aplique textura, exporte e coloque um vaso.

> **[Editor de props](/pt-BR/projects/props/editor.md)**
>
> Ferramentas, vistas, material, colisão e origem.


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