> For the complete documentation index, see [llms.txt](https://ns-studios.gitbook.io/ns-studios/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://ns-studios.gitbook.io/ns-studios/content-1/scripts-1.md).

# Props

Elevate your server's environment with our custom, highly detailed 3D props.

Welcome to the props documentation section. Here you will find all the resources required to install and seamlessly integrate NS Studios props into your RedM server. Our 3D assets are modeled and textured with performance in mind, ensuring beautiful, immersive environments without sacrificing your server's FPS or memory usage.

#### How to use this section <a href="#how-to-use-this-section" id="how-to-use-this-section"></a>

On the left sidebar, you will find dedicated subpages for each prop pack available in our catalog. Inside each specific page, we detail:

* Prop Hashes & Names: A complete list of the spawn names/hashes for every item included in the package, so you can easily add them to your housing scripts, object spooners, or crafting menus.
* Asset Details: Information regarding the type of prop (e.g., static, dynamic, interactable) and specific collision or texture notes.
* Dependencies: Any recommended third-party scripts (like housing or inventory systems) if you intend to use the props as usable items.

#### General installation guide <a href="#general-installation-guide" id="general-installation-guide"></a>

While installing props is generally more straightforward than scripts or maps, the standard process follows these steps:

1. Download: Retrieve your purchased prop package from your Cfx.re Keymaster account.
2. Extract: Extract the downloaded file and place the folder into your server's resources directory. We recommend creating a dedicated `[ns-props]` folder for better organization.
3. Stream Folder & Archetypes: Ensure that the 3D model files (`.ydr`), texture dictionaries (`.ytd`), and collisions are located inside the `stream` folder of the resource. If the prop pack includes `.ytyp` archetype files, they should be correctly referenced in the `fxmanifest.lua` (this is already set up by default).
4. Server Config: Open your `server.cfg` file and add the command `ensure [prop_folder_name]`.
5. Restart: Restart your server or use the `refresh` and `start` commands in your server console. *Note: When adding new 3D assets, it is highly recommended to restart the server and clear your cache for the textures and collisions to load properly for all players.*

#### Important notes <a href="#important-notes" id="important-notes"></a>

* Cfx.re Escrow: intellectual property and 3D modeling work, the core model files (`.ydr`) of our props are encrypted using the official Cfx.re Escrow system.
* Unlocked Files: Only the base requirement file (`fxmanifest.lua`) remains accessible to ensure the resource starts and loads correctly on your server.

If you encounter any collision bugs, missing textures, or console errors during the installation, please open a support ticket on our Discord. Always provide a screenshot of the issue in-game or the F8 console error to speed up the support process.