> ## Documentation Index
> Fetch the complete documentation index at: https://help.freakhosting.com/llms.txt
> Use this file to discover all available pages before exploring further.

# How to Add Custom Resources & Vehicles in FiveM

> Expand your FiveM server features. Learn how to install scripts, deploy high-fidelity vehicles, and manage resource loading categories.

## Enhancing Your Virtual World

In the FiveM ecosystem, every modification - from a fundamental administrative script to a high-fidelity 4K vehicle model - is categorized as a **Resource**. Mastering the correct technical structure and loading logic is essential for maintaining a stable, low-latency environment for your players. By organizing your assets effectively and optimizing your textures, you can create a complex and feature-rich server without compromising performance.

<CardGroup cols={2}>
  <Card title="Difficulty" icon="gauge-low">
    Intermediate
  </Card>

  <Card title="Time" icon="clock">
    8 Minutes
  </Card>
</CardGroup>

***

## Technical Resource Architecture

A valid FiveM resource must adhere to a specific directory layout to be recognized by the CitizenFX engine. Before initiating an upload, verify that your resource folder contains the following core components:

* **`fxmanifest.lua`:** The mandatory metadata file that defines the resource version and instructs the server on how to initialize the logic.
* **`stream/` (Optional):** This directory contains the raw binary assets, such as `.ytd` (textures) and `.yft` (3D models), which are streamed to the client upon joining.
* **`client.lua` / `server.lua`:** The functional scripts that execute logic on either the player's local machine or the central server node.

***

## Strategic Resource Organization

To maintain a professional and manageable server directory, we recommend using **Category Folders** (bracketed directories). This approach simplifies your configuration and improves organizational clarity.

<Steps>
  <Step title="Initialize Categories">
    Navigate to your `/resources/` directory via SFTP. Create descriptive subdirectories using square brackets, such as `[cars]`, `[scripts]`, and `[maps]`.
  </Step>

  <Step title="Deploy Assets">
    Upload your individual resource folders into their corresponding categories.

    * *Example Path:* `/resources/[cars]/ferrari458/`
  </Step>

  <Step title="Configure Loading Logic">
    Open your `server.cfg` file to authorize the resources. You can load items individually or by category:

    * **Individual:** `ensure ferrari458`
    * **Category:** `ensure [cars]`
  </Step>
</Steps>

<Tip>
  ### Efficiency Tip

  using the bracketed category method (e.g., `ensure [cars]`) automatically initializes every resource within that directory. This significantly reduces the size of your `server.cfg` and makes bulk updates much faster.
</Tip>

***

## Optimization & Performance

<AccordionGroup>
  <Accordion title="Managing Texture Budgets">
    If players report "Low Texture Memory" warnings or observe "flashing" geometry, your custom vehicles are likely unoptimized. We recommend that individual vehicle `.ytd` files do not exceed **16MB**.
  </Accordion>

  <Accordion title="Technical Downscaling">
    use tools like the **Texture Toolkit** to downscale bloated 4K textures to 2K or 1024x1024. This reduces the VRAM demand on your players' graphics cards while maintaining high visual fidelity in the simulation.
  </Accordion>
</AccordionGroup>

***

<Note>
  ### Need Extra Help?

  If you encounter any issues, our support team is ready to assist:

  * **Live Chat:** Quick assistance via our website.
  * **Support Ticket:** [Open a Ticket](https://freakhosting.com/clientarea/submitticket.php)
  * **Discord:** [Join our Community](https://discord.gg/freakhosting)
  * **Email:** [support@freakhosting.com](mailto:support@freakhosting.com)
</Note>

<Tip>
  ### Save on Your Hosting

  Ready to get a new server? Use code **KB20** at checkout for **20% off** your first month!
</Tip>

***

<div align="center">
  **Last Updated:** January 2026 | **FiveM:** Resources synchronized.
</div>