# How to Install Vehicle Mods on Your BeamMP Server (/docs/beammp/mod-setup)



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

Vehicle mods added to your server are **automatically downloaded** by players when they join — no manual client install needed.

Mod Directory [#mod-directory]

<Files>
  <Folder name="Resources" defaultOpen>
    <Folder name="Client" defaultOpen>
      <File name="vehicle_mod.zip" />

      <File name="another_mod.zip" />

      <File name="custom_map.zip" />
    </Folder>
  </Folder>
</Files>

Everything in `Resources/Client/` is served to connecting players as `.zip` files. Do NOT extract them.

Adding a Vehicle Mod [#adding-a-vehicle-mod]

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

    Get vehicle mods from the [BeamNG.drive Repository](https://www.beamng.com/resources/) or community sites. Download the `.zip` file.
  </Step>

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

    In the [XGamingServer Panel](https://panel.xgamingserver.com), click **Files** in the sidebar. Navigate to `Resources/Client/`. Click **Upload** and select the `.zip` file.

    {/* Screenshot needed: File Manager showing Resources/Client/ with uploaded mod zips */}

    > ⚠️ **Keep it as a `.zip`** — do NOT extract. BeamMP sends the zip directly to clients.
  </Step>

  <Step>
    Reload or restart [#reload-or-restart]

    Either restart your server from **Console**, or use the `reloadmods` command in the server console to load new mods without a full restart.
  </Step>
</Steps>

Managing Mods [#managing-mods]

| Action                      | How                                                      |
| --------------------------- | -------------------------------------------------------- |
| Remove a mod                | Delete the `.zip` from `Resources/Client/` via **Files** |
| Reload without restart      | Type `reloadmods` in the **Console**                     |
| Protect a mod from deletion | Console: `protectmod modname true`                       |

Client Experience [#client-experience]

When a player joins your server, BeamMP automatically:

1. Downloads all `.zip` files from `Resources/Client/`
2. Loads the vehicle mods into their game session
3. Unloads them when they disconnect

Players don't need to manually install anything.

Related Guides [#related-guides]

* [Change the Map](/docs/beammp/map-guide)
* [Server Configuration](/docs/beammp/server-config)