Where do I find the correct map name for a downloaded map addon?

Inside the levels folder within the downloaded .zip file – there you’ll find the map addon folder whose name you need for the configuration.

Where do I upload the map addon file via FTP?

Upload it to the ../beammp/Resources/Client folder on your BeamMP game server.

BeamMP: Installing Addon Maps

Discover how to upgrade your BeamMP game server with custom map addons for a better multiplayer experience → Learn more now

10 November 20263 min read2 Views0 helpful

Introduction

BeamNG.Drive offers native modding support and a huge community that allows you to expand and enhance gameplay with your friends. Since BeamMP functions simply as a multiplayer modification, most map addons should be compatible with your BeamMP game server. This guide shows you how to install and activate a custom map addon on your BeamMP game server.

Preparation

To install an addon map on your BeamMP game server, you need to connect via FTP. If you are not familiar with this, we recommend checking out the FTP Access guide.

Before starting the installation, you should also find map addons you want to install on your server. We recommend browsing the official BeamNG.Drive forum, which contains a vast library of mods and map addons from the community.

Tip

Since BeamMP is a multiplayer modification for BeamNG.Drive, most map addons should be compatible with your BeamMP game server. However, some specific maps may not work as expected, so you should test each map.

Installation

First, make sure you have downloaded an addon map in .zip format that you want to add to your server.

Selecting the Map Name

Before proceeding, it is important to use the correct map name. The downloaded .zip file usually has the correct name, but not always, so you should verify this.

Open the downloaded .zip file. Inside, you will find the levels folder containing the actual map.

Copy the exact name of the map addon folder in this directory. You can do this by right-clicking the folder, selecting Properties, and copying the highlighted text with CTRL + C.

Configuring the Map

After determining the map name, you need to adjust the configuration file and change a parameter that defines the active map.

Disable Config Override

First, you must disable the default map selection in the settings, as it would otherwise overwrite your changes.

This is done easily in the Configuration tab of your game server.

There, disable the “Map” setting.

Then save the settings at the bottom of the page.

Change the Map in the Config

To change the map in the config, open the Configuration tab (raw text view) of your game server.

Open the file ServerConfig.toml and find the line: Map = "/levels/gridmap_v2/info.json"

Replace the value with Map = "/levels/[your_map_name]/info.json" using the map name you determined earlier, then save the config.

Info

In rare cases, a map may be formatted differently. If the map does not work after all steps, you need to specify this path instead of Map = "/levels/[your_map_name]/info.json": Map = "/levels/[your_map_name]/[your_map_name].mis"

Tip

You can always use the game's standard maps by re-enabling the option in the settings and selecting one of them:

Uploading the Map

As the final step, upload the previously downloaded .zip map file via FTP to your BeamMP game server. If you need help, use our FTP Access guide.

Navigate in your FTP client to the following path:

Code

../beammp/Resources/Client

Simply drag and drop the map addon .zip file into this folder to upload the map to your server. With the edited config and uploaded map files, your map addon is ready to use.

Completion

After following all steps, restart your BeamMP game server. You have successfully installed an addon map on your BeamMP game server. If you have further questions or issues, our support team is available daily – don’t hesitate to contact us! 🙂

FAQ

Frequently asked questions

Since BeamMP is a multiplayer mod for BeamNG.Drive, most map addons should be compatible. However, some specific maps might not work as expected, so you should test each map.

Disable the default map selection (the “Map” setting) in the Configuration tab, as it would otherwise overwrite your changes.

Open the ServerConfig.toml file in the Configuration tab (raw text view), find the line Map = "/levels/gridmap_v2/info.json", and replace it with Map = "/levels/[your_map_name]/info.json" using your map name.

Feedback

Was this article helpful?

Your feedback helps us prioritize and improve content.

0 of 0 Users found this article helpful.

Personal support

Need more help than the guide provides?

Our ZAP support team knows your product — briefly describe your issue and we'll help you personally.

Which 🍪 cookies would you like to allow?

BeamMP: Installing Addon Maps

Introduction

Preparation

Installation

Selecting the Map Name

Configuring the Map

Disable Config Override

Change the Map in the Config

Uploading the Map

Completion

Frequently asked questions

BeamMP

Preparation

Installation

Selecting the Map Name

Configuring the Map

Disable Config Override

Change the Map in the Config

Uploading the Map

Completion

Game Server

Servers & Hosting

ZAPX

Resources

ZAP-Hosting