> ## 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 > Model a custom object once, then place it in any structure of the project or spawn it from a script. A prop is one custom object saved in your project: a name, geometry, materials with textures, and collision. The name is the model name the game uses. You place the same prop as many times as you like in the project's structures, or create it from a script. Every prop in the project ships with the project resource when you [export](/projects/props/export.md). Props has no map around it. You model on an empty ground, and you place the result from [Structures](/projects/structures/props-in-structures.md) or by script. ## Open the Props tool Open the **Projects** tab, open a project, and click **Props** under **Modeling** in the **Tools** rail. A project needs a folder before it can hold props, because they are saved in a `props/` folder next to the `.gxp` file. Click **Save** in the project bar and pick a folder first. ![Tools rail with Modeling expanded and Props selected, and the empty list reading No props with Import model and New prop buttons](https://mintcdn.com/rageon/SL02705KjqddBRzg/images/props/props-tool-rail.webp?fit=max\&auto=format\&n=SL02705KjqddBRzg\&q=85\&s=9b8fc2f936d9a09dcec4661b640f81e7) The Props tool in a project with no props yet. On a project that was never saved, the list reads **Save the project to get started** and both buttons stay disabled. ![Props list with the message Save the project to get started and disabled buttons](https://mintcdn.com/rageon/SL02705KjqddBRzg/images/props/props-list-no-folder.webp?fit=max\&auto=format\&n=SL02705KjqddBRzg\&q=85\&s=40e5e30d02f201443ec7625640e1e657) An unsaved project cannot hold props. ## The prop list Each prop is a card with a preview, its name, and when it was last modified. The preview is saved with the prop, so a prop you never saved with geometry shows a box icon. Click a card to open the prop in the [editor](/projects/props/editor.md). ![Grid of prop cards, including a card with a warning icon and a card with a very long name](https://mintcdn.com/rageon/SL02705KjqddBRzg/images/props/props-list-gallery.webp?fit=max\&auto=format\&n=SL02705KjqddBRzg\&q=85\&s=56b29b9ef4286eefe8145a02c7c48e5e) Twenty props, one very long name, and two cards that cannot open. A card with a warning icon cannot open and shows the reason instead: **A prop must have a single part.** or **Another prop already uses this id.** A file that cannot be read shows the read error. These cards only offer the trash icon. A broken file in `props/` also blocks the project export until you delete or repair it. ## Create a prop **1. Click New prop** The **New prop** dialog opens. In a structure, **Convert to prop** on an object opens the same dialog. **2. Type a Prop name** The name becomes the model name and the file name: lowercase, no accents, and anything other than a letter or digit becomes `_`. **Vinewood Planter** becomes `vinewood_planter`. **Create prop** stays disabled while the name has no letter or digit, or while another prop of the project already uses it. ![New prop dialog with Docs Planter typed in the Prop name field](https://mintcdn.com/rageon/SL02705KjqddBRzg/images/props/props-new-prop-dialog.webp?fit=max\&auto=format\&n=SL02705KjqddBRzg\&q=85\&s=ab91b3ef485b6ae7d8c98d6bde7f06f8) Naming a new prop. **3. Click Create prop** The editor opens on an empty prop. ## Import a model **Import model** creates a prop from a `.glb`, `.ydr`, or `.ydr.xml` file and names it after the file. A name that is already taken gets `_2`, `_3`, and so on. Images embedded in a `.glb` are copied into the project with their materials, and a `.ydr` is converted automatically. To add a model to a prop you already have, click **+** in the **Structure** section and choose **Import model…**. The new objects join the open prop. > [!WARNING] > > Imported models keep the position they have in the file. Check **Box (m)** in the **Prop** section and use **Put the origin at the center of the base** if the prop floats or sits underground when placed. If the name matches a game prop, the Checker shows an error and the export is blocked. Rename the prop in the editor header or in the **Name** field of the **Prop** section. See [The Checker](/projects/props/editor.md#the-checker). ## Rename and delete Double-click a card name to rename it. The file and the model name change with it, and structures that use the prop follow the new name. The trash icon on a card deletes the prop after a confirmation. This cannot be undone. ![Delete prop dialog asking to delete the prop docs\_planter](https://mintcdn.com/rageon/SL02705KjqddBRzg/images/props/props-delete-confirm.webp?fit=max\&auto=format\&n=SL02705KjqddBRzg\&q=85\&s=48100b0e12882ef9a1447c2817213730) Deleting a prop asks for confirmation. > [!WARNING] > > Deleting a prop that structures use leaves every instance pointing at nothing. Each instance reports that the prop no longer exists, and the project export stays blocked until you remove the instances or create the prop again. ## Limits and plans Every plan can open the Props tool. The number of props a project can hold follows the same per-project limit as structures: past it, **New prop** and **Import model** fail with **Your plan allows up to … structures per project.** See [pricing](https://rageon.dev/pricing) for what each plan includes. ## Troubleshooting > **Save the project first — the prop lives in the .gxp folder** > > The project has no folder yet. Click **Save** in the project bar, choose a folder, and try again. > **A prop named "…" already exists in this project.** > > Another prop already uses that file name. Pick a different name. > **Save the open prop before renaming it.** > > The prop has unsaved changes. Press **Ctrl+S**, then rename it. > **Could not import the model: … has no faces** > > The file has no mesh, only points or lines. Choose a file that carries a mesh. > **Your plan allows up to … structures per project.** > > The project already holds as many props as your plan allows structures. Delete a prop you no longer need, or check [pricing](https://rageon.dev/pricing). > **Could not load the props: …** > > Rageon could not read the `props/` folder. Check that the folder exists and that you can read it, then reopen the project. ## Next steps > **[Your first prop](/projects/props/first-prop.md)** > > Model, texture, export, and place a planter. > **[Prop editor](/projects/props/editor.md)** > > Tools, views, material, collision, and origin. This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.