> ## 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 Install Mods on a BeamMP Server

> Enhance your BeamMP server with custom vehicles, parts, and assets. Learn how to use the automated resource distribution system for smooth modding.

## Customizing Your Server Resources

BeamMP (BeamNG.drive Multiplayer) features a highly efficient, automated resource synchronization system. Unlike many other simulation platforms, once modifications are correctly situated on the server node, they are programmatically served to every joining client during the initial handshake. This ensures that every participant possesses the identical vehicle models and physics assets required for synchronized collisions and driving maneuvers. The FREAKHOSTING platform provides a high-speed backbone to facilitate these asset transfers with minimal latency.

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

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

***

## Technical Installation Workflow

Follow these steps to deploy new modifications to your community.

<Steps>
  <Step title="Acquire Asset Packages">
    Download your desired modifications in **`.zip`** format from the official [BeamNG.drive Repository](https://www.beamng.com/resources/) or trusted community marketplaces. Do not extract the ZIP files.
  </Step>

  <Step title="Initialize File Transfer">
    Log in to the [Game Panel](https://games.freakhosting.com) and navigate to the **Files** tab.
  </Step>

  <Step title="Deploy to Client Directory">
    Navigate to the following directory: `/Resources/Client/`. Upload your compressed mod files directly into this folder.
  </Step>

  <Step title="Initialize Synchronization">
    **Restart** your server. BeamMP will programmatically hash the new assets and begin advertising them to connecting players.
  </Step>
</Steps>

***

## Technical Considerations: Bandwidth & Bloat

While modding is essential for community identity, administrators must manage their "Mod Budget" carefully to maintain accessibility.

<Tabs>
  <Tab title="The Sync Barrier">
    Every byte of modded content added to the `/Resources/Client/` directory must be successfully downloaded by every player before they can join. If your modpack exceeds several gigabytes, new players may encounter "Syncing Resources" timeouts or simply lose interest during the prolonged download phase.
  </Tab>

  <Tab title="Strategic Optimization">
    We recommend maintaining a total modpack size below **1GB**. Prioritize high-utility vehicle packs and optimized parts over redundant high-resolution assets to ensure your server remains accessible to players with varied internet speeds.
  </Tab>
</Tabs>

***

<Note>
  ### Deploying Modded Maps

  To initialize a custom level rather than a vanilla environment:

  1. Upload the map's `.zip` file into the `/Resources/Client/` directory.
  2. Open your `ServerConfig.toml` and locate the `Map =` variable.
  3. Update the path to the internal map manifest.

  * *Example:* `Map = "/levels/motorsports_playground/info.json"`
</Note>

***

<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 | **BeamMP:** Personalized crashes.
</div>