# How to Change the Map on Your BeamMP Server (/docs/beammp/map-guide)



import { Step, Steps } from 'fumadocs-ui/components/steps';
import { Tab, Tabs } from 'fumadocs-ui/components/tabs';

Default Maps (No Installation Needed) [#default-maps-no-installation-needed]

These maps are built into BeamNG.drive — just change the `Map` setting:

| Map                   | Config Path                               |
| --------------------- | ----------------------------------------- |
| Gridmap V2 (default)  | `/levels/gridmap_v2/info.json`            |
| West Coast, USA       | `/levels/west_coast_usa/info.json`        |
| East Coast, USA       | `/levels/east_coast_usa/info.json`        |
| Italy                 | `/levels/italy/info.json`                 |
| Utah, USA             | `/levels/utah/info.json`                  |
| Johnson Valley        | `/levels/johnson_valley/info.json`        |
| Hirochi Raceway       | `/levels/hirochi_raceway/info.json`       |
| Jungle Rock Island    | `/levels/jungle_rock_island/info.json`    |
| Automation Test Track | `/levels/automation_test_track/info.json` |
| Industrial Site       | `/levels/industrial/info.json`            |
| Derby Arenas          | `/levels/derby/info.json`                 |
| Small Island, USA     | `/levels/small_island/info.json`          |
| Driver Training       | `/levels/driver_training/info.json`       |
| Port                  | `/levels/port/info.json`                  |

<Tabs items={['Change via Startup', 'Change via Config']}>
  <Tab value="Change via Startup">
    In the [XGamingServer Panel](https://panel.xgamingserver.com), click **Startup** and find the **Map** field. Enter the path from the table above.

    {/* Screenshot needed: Startup tab with Map field */}
  </Tab>

  <Tab value="Change via Config">
    In **Files**, open `ServerConfig.toml` and change the `Map` line:

    ```toml
    Map = "/levels/west_coast_usa/info.json"
    ```
  </Tab>
</Tabs>

Restart your server after changing.

***

Installing a Custom Map [#installing-a-custom-map]

Custom maps from the BeamNG community are distributed as `.zip` files. Players **auto-download** custom maps when joining — no manual client install needed.

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

    Get the custom map `.zip` file from the BeamNG modding community (e.g., BeamNG.drive forums or mod sites).
  </Step>

  <Step>
    Upload to the server (DO NOT EXTRACT) [#upload-to-the-server-do-not-extract]

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

    {/* Screenshot needed: File Manager showing Resources/Client/ with a .zip map file */}

    > ⚠️ The file must stay as a `.zip`. BeamMP serves it to clients directly.
  </Step>

  <Step>
    Find the map's folder name [#find-the-maps-folder-name]

    You need to know the folder name inside the zip. Open the zip locally on your PC — look inside the `levels/` directory for the map folder name (e.g., `my_custom_map`).
  </Step>

  <Step>
    Set the map in config [#set-the-map-in-config]

    In **Startup** or `ServerConfig.toml`, set the map path:

    ```toml
    Map = "/levels/my_custom_map/info.json"
    ```

    > ⚠️ **Case-sensitive** — the path must match the folder name inside the zip exactly, including capitalization.
  </Step>

  <Step>
    Restart [#restart]

    Go to **Console** and restart your server. The map is now active and players will auto-download it on join.
  </Step>
</Steps>

Related Guides [#related-guides]

* [Server Configuration](/docs/beammp/server-config)
* [Install Vehicle Mods](/docs/beammp/mod-setup)