# How to Install Custom Vehicles on Your FiveM Server (/docs/fivem/install-custom-vehicles)



import { Step, Steps } from 'fumadocs-ui/components/steps';
import { Files, Folder, File } from 'fumadocs-ui/components/files';

Custom addon vehicles add new car models to FiveM alongside the default GTA V vehicles. Each vehicle is a resource with model files (YFT/YTD) and meta data (handling, colors, etc.).

Vehicle Resource Structure [#vehicle-resource-structure]

<Files>
  <Folder name="my_addon_car" defaultOpen>
    <File name="fxmanifest.lua" />

    <File name="vehicle_names.lua" />

    <Folder name="stream" defaultOpen>
      <File name="mycar.yft" />

      <File name="mycar_hi.yft" />

      <File name="mycar.ytd" />
    </Folder>

    <Folder name="data" defaultOpen>
      <Folder name="mycar">
        <File name="handling.meta" />

        <File name="vehicles.meta" />

        <File name="carcols.meta" />

        <File name="carvariations.meta" />

        <File name="vehiclelayouts.meta" />
      </Folder>
    </Folder>
  </Folder>
</Files>

* **`stream/`** — model (.yft) and texture (.ytd) files. Automatically sent to clients
* **`data/`** — meta files defining handling, colors, and variations. Must be declared in fxmanifest

Install a Vehicle [#install-a-vehicle]

<Steps>
  <Step>
    Download the vehicle mod [#download-the-vehicle-mod]

    Download from [GTA5-Mods.com](https://www.gta5-mods.com) or the cfx.re Releases forum. Look for mods labeled "FiveM ready" — they include the fxmanifest and proper folder structure.
  </Step>

  <Step>
    Upload to the server [#upload-to-the-server]

    In the [XGamingServer Panel](https://panel.xgamingserver.com), stop the server. Click **Files** in the sidebar and upload the vehicle folder to `resources/` (or a subfolder like `resources/[vehicles]/`).
  </Step>

  <Step>
    Verify the fxmanifest.lua [#verify-the-fxmanifestlua]

    The resource needs a `fxmanifest.lua` that declares the meta files:

    ```lua
    fx_version 'cerulean'
    game { 'gta5' }

    files {
      'data/**/*.meta'
    }

    data_file 'HANDLING_FILE'           'data/**/handling.meta'
    data_file 'VEHICLE_METADATA_FILE'   'data/**/vehicles.meta'
    data_file 'CARCOLS_FILE'            'data/**/carcols.meta'
    data_file 'VEHICLE_VARIATION_FILE'  'data/**/carvariations.meta'
    data_file 'VEHICLE_LAYOUTS_FILE'    'data/**/vehiclelayouts.meta'

    client_script 'vehicle_names.lua'
    ```

    Stream files (YFT/YTD) don't need `files {}` entries — they're auto-streamed.
  </Step>

  <Step>
    Add to server.cfg [#add-to-servercfg]

    Open `server.cfg` in **Files** and add:

    ```ini
    ensure my_addon_car
    ```
  </Step>

  <Step>
    Restart and test [#restart-and-test]

    Start from **Console**. In-game, spawn the vehicle with its model name (e.g., `/spawn mycar`).
  </Step>
</Steps>

Not FiveM-Ready? [#not-fivem-ready]

If the mod was designed for singleplayer (no fxmanifest), you'll need to create the resource structure yourself — add a `fxmanifest.lua`, move model files to `stream/`, and meta files to `data/`.

Related Guides [#related-guides]

* [Install Resources](/docs/fivem/install-resources)
* [Enable DLC Content](/docs/fivem/game-build)
* [Server Configuration](/docs/fivem/configure-your-server)