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

> Modela un objeto personalizado una vez y colócalo en cualquier estructura del proyecto o haz que aparezca desde un script.

Un prop es un objeto personalizado guardado en tu proyecto: un nombre, geometría, materiales con texturas y colisión. El nombre es el nombre del modelo que usa el juego. Puedes colocar el mismo prop tantas veces como quieras en las estructuras del proyecto, o crearlo desde un script. Todos los props del proyecto se entregan con el resource del proyecto cuando [exportas](/es/projects/props/export.md).

Props no tiene un mapa alrededor. Modelas sobre un suelo vacío y colocas el resultado desde [Estructuras](/es/projects/structures/props-in-structures.md) o por script.

## Abrir la herramienta Props

Abre la pestaña **Proyectos**, abre un proyecto y haz clic en **Props** bajo **Modelado** en la barra de **Herramientas**. Un proyecto necesita una carpeta antes de poder contener props, porque se guardan en una carpeta `props/` junto al archivo `.gxp`. Haz clic en **Guardar** en la barra del proyecto y elige una carpeta primero.

![Barra de Herramientas con Modelado expandido y Props seleccionado, y la lista vacía que dice Ningún prop con los botones Importar modelo y Nuevo prop](https://mintcdn.com/rageon/SL02705KjqddBRzg/images/props/props-tool-rail.webp?fit=max\&auto=format\&n=SL02705KjqddBRzg\&q=85\&s=9b8fc2f936d9a09dcec4661b640f81e7)

La herramienta Props en un proyecto sin props todavía.

En un proyecto que nunca se guardó, la lista dice **Guarda el proyecto para empezar** y ambos botones permanecen desactivados.

![Lista de props con el mensaje Guarda el proyecto para empezar y botones desactivados](https://mintcdn.com/rageon/SL02705KjqddBRzg/images/props/props-list-no-folder.webp?fit=max\&auto=format\&n=SL02705KjqddBRzg\&q=85\&s=40e5e30d02f201443ec7625640e1e657)

Un proyecto sin guardar no puede contener props.

## La lista de props

Cada prop es una tarjeta con una vista previa, su nombre y la fecha de su última modificación. La vista previa se guarda con el prop, así que un prop que nunca guardaste con geometría muestra un ícono de caja. Haz clic en una tarjeta para abrir el prop en el [editor](/es/projects/props/editor.md).

![Cuadrícula de tarjetas de props, incluida una tarjeta con un ícono de advertencia y una tarjeta con un nombre muy largo](https://mintcdn.com/rageon/SL02705KjqddBRzg/images/props/props-list-gallery.webp?fit=max\&auto=format\&n=SL02705KjqddBRzg\&q=85\&s=56b29b9ef4286eefe8145a02c7c48e5e)

Veinte props, un nombre muy largo y dos tarjetas que no se pueden abrir.

Una tarjeta con un ícono de advertencia no se puede abrir y muestra el motivo: **Un prop debe tener una sola parte.** u **Otro prop ya usa este id.** Un archivo que no se puede leer muestra el error de lectura. Estas tarjetas solo ofrecen el ícono de papelera. Un archivo dañado en `props/` también bloquea la exportación del proyecto hasta que lo elimines o lo repares.

## Crear un prop

**1. Haz clic en Nuevo prop**

Se abre el diálogo **Nuevo prop**. En una estructura, **Convertir en prop** sobre un objeto abre el mismo diálogo.

**2. Escribe un Nombre del prop**

El nombre pasa a ser el nombre del modelo y el nombre del archivo: minúsculas, sin acentos, y cualquier cosa que no sea una letra o un dígito se convierte en `_`. **Vinewood Planter** pasa a ser `vinewood_planter`. **Crear prop** permanece desactivado mientras el nombre no tenga una letra o un dígito, o mientras otro prop del proyecto ya lo use.

![Diálogo Nuevo prop con Docs Planter escrito en el campo Nombre del prop](https://mintcdn.com/rageon/SL02705KjqddBRzg/images/props/props-new-prop-dialog.webp?fit=max\&auto=format\&n=SL02705KjqddBRzg\&q=85\&s=ab91b3ef485b6ae7d8c98d6bde7f06f8)

Poniendo nombre a un prop nuevo.

**3. Haz clic en Crear prop**

El editor se abre sobre un prop vacío.

## Importar un modelo

**Importar modelo** crea un prop a partir de un archivo `.glb`, `.ydr` o `.ydr.xml` y le pone el nombre del archivo. Un nombre que ya está en uso recibe `_2`, `_3`, etc. Las imágenes incrustadas en un `.glb` se copian al proyecto con sus materiales, y un `.ydr` se convierte automáticamente.

Para añadir un modelo a un prop que ya tienes, haz clic en **+** en la sección **Estructura** y elige **Importar modelo…**. Los objetos nuevos se unen al prop abierto.

> [!WARNING]
>
> Los modelos importados conservan la posición que tienen en el archivo. Revisa **Caja (m)** en la sección **Prop** y usa **Poner el origen en el centro de la base** si el prop flota o queda bajo tierra al colocarlo.

Si el nombre coincide con un prop del juego, el Verificador muestra un error y la exportación se bloquea. Renombra el prop en el encabezado del editor o en el campo **Nombre** de la sección **Prop**. Consulta [El Verificador](/es/projects/props/editor.md#el-verificador).

## Renombrar y eliminar

Haz doble clic en el nombre de una tarjeta para renombrarla. El archivo y el nombre del modelo cambian con él, y las estructuras que usan el prop siguen el nombre nuevo.
El ícono de papelera de una tarjeta elimina el prop tras una confirmación. No se puede deshacer.

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

Eliminar un prop pide confirmación.

> [!WARNING]
>
> Eliminar un prop que usan estructuras deja cada instancia apuntando a nada. Cada instancia informa que el prop ya no existe, y la exportación del proyecto permanece bloqueada hasta que quites las instancias o vuelvas a crear el prop.

## Límites y planes

Todos los planes pueden abrir la herramienta Props. La cantidad de props que puede contener un proyecto sigue el mismo límite por proyecto que las estructuras: al superarlo, **Nuevo prop** e **Importar modelo** fallan con **Tu plan permite hasta … estructuras por proyecto.** Consulta los [precios](https://rageon.dev/pricing) para ver qué incluye cada plan.

## Solución de problemas

> **Guarda el proyecto primero — el prop vive en la carpeta .gxp**
>
> El proyecto todavía no tiene carpeta. Haz clic en **Guardar** en la barra del proyecto, elige una carpeta e inténtalo de nuevo.

> **Ya existe un prop llamado "…" en este proyecto.**
>
> Otro prop ya usa ese nombre de archivo. Elige un nombre diferente.

> **Guarda el prop abierto antes de renombrarlo.**
>
> El prop tiene cambios sin guardar. Pulsa **Ctrl+S** y luego renómbralo.

> **No se pudo importar el modelo: … no tiene faces**
>
> El archivo no tiene malla, solo puntos o líneas. Elige un archivo que contenga una malla.

> **Tu plan permite hasta … estructuras por proyecto.**
>
> El proyecto ya contiene tantos props como estructuras permite tu plan. Elimina un prop que ya no necesites, o consulta los [precios](https://rageon.dev/pricing).

> **No se pudieron cargar los props: …**
>
> Rageon no pudo leer la carpeta `props/`. Comprueba que la carpeta exista y que puedas leerla, y vuelve a abrir el proyecto.

## Próximos pasos

> **[Tu primer prop](/es/projects/props/first-prop.md)**
>
> Modela, texturiza, exporta y coloca una jardinera.

> **[Editor de props](/es/projects/props/editor.md)**
>
> Herramientas, vistas, material, colisión y origen.


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