How to Set Up and Configure BlueMap


${youtube}[How to Install and Setup BlueMap on Your Server](ij9NjVFG6NE)

This article will show you how to properly set up and configure the BlueMap plugin or mod in your server.

—


# ❓ What is BlueMap ❓

BlueMap is an addition to your server that will provide you with a fully rendered 3D model of your Minecraft world that is accessible to all players.

BlueMap can be found as a plugin or mod. You will need to choose one depending on what server type you are running.

||| Please note that for the BlueMap plugin to work properly, your world should be named exactly `world` !

|| BlueMap also has support for Fabric and SpongeForge starting from version 1.12.2.

> You can find more about it in the official [BlueMap Github wiki](https://github.com/BlueMap-Minecraft/BlueMap).

—

# BlueMap Plugin

Please note that you need to run a Bukkit/Spigot/Paper server for it to be able to run plugins.

||| [Here](https://help.ggservers.com/en-us/article/how-to-install-plugins-on-your-server-1yxw90a/) you can find our guide for installing plugins.

—

### How to Install BlueMap via the Multicraft Panel

To install the BlueMap plugin using the Multicraft panel you need to do the following:

1. Log in to your Multicraft panel [here](https://mc.ggservers.com/site/login) and stop your server.

—

2. Click on `Installers`, then on `Plugin Auto Setup`.


—

3. Click on `BlueMap`.


—

4. Go back to your main Multicraft page and click on `Console`. There you will see a line titled `[Script bluemap] [bluemap] You can access your bluemap here:` that will give you the link to your 3D world model. In our case, it is `167.114.157.115:3003`.


To access your rendered world just open the browser and paste the link there (`167.114.157.115:3003`).

||| Please note that for the BlueMap plugin to work properly, your world should be named exactly `world` !

—

### How to Install and Configure BlueMap Manually

#### Installing

To install the BlueMap plugin manually into your server you need to do the following:

1. Download your wished BlueMap plugin version [here](https://www.spigotmc.org/resources/bluemap.83557/).


—

2. Upload the plugin to your `plugins` folder. We highly recommend you upload the plugin through FileZilla.


||| [Here](https://help.ggservers.com/en-us/article/how-to-connect-to-your-server-using-filezilla-yl0q5r/) is our guide for using FileZilla.

—

3. Restart your server.

—

#### Configuring

To configure the BlueMap plugin manually you need to do the following:

1. Log in to your Multicraft panel here and click on `Files`, then on `FTP files access` and log in.


—

2. Click on the BlueMap `webserver.conf` file (Inside `/plugins/bluemap`), then click on `Edit`.


—

3. Find `port: `, then change it to any value between 8000 and 9999. Please note that the port you choose can be already occupied. If this happens just change the `port: ` to any other value between the value mentioned above, then save the changes.


|| ⚠ NOTE ⚠: You can find the `port: ` at line number 25 in the default config file for the BlueMap plugin.

—

4. After saving the changes restart your server.

—

# BlueMap Mod

Please note that you need to run either a Forge server, either a Fabric one to be able to run mods into your server.

||| [Here](https://help.ggservers.com/en-us/article/how-to-install-mods-on-your-server-1bauy2t/) is our guide for installing mods into your server.

—

### How to Install and Configure BlueMap Mod

#### Installing

To install the BlueMap mod manually into your server you need to do the following:

1. Download your wished BlueMap mod version [here](https://www.curseforge.com/minecraft/mc-mods/dynmapforge).


—

2. Upload the mod to your `mods` folder. We highly recommend you upload the plugin through FileZilla.


||| [Here](https://help.ggservers.com/en-us/article/how-to-connect-to-your-server-using-filezilla-yl0q5r/) is our guide for using FileZilla.

—

3. Restart your server.

—

#### Configuring

To configure the BlueMap mod manually you need to do the following:

1. Log in to your Multicraft panel here and click on `Files`, then on `FTP files access`.


—

2. Click on the BlueMap `webserver.conf` file (Inside `/config/bluemap`), then click on `Edit`.


—

3. Find `port: `, then change it to any value between 8000 and 9999. Please note that the port you choose can be already occupied. If this happens just change the `port: ` to any other value between the value mentioned above, then save the changes.


|| ⚠ NOTE ⚠: You can find the `webserver-port` at line number 25 in the default config file for BlueMap mod.

—

4. Click on the BlueMap `core.conf` file (Inside `/config/bluemap`), then click on `Edit`.


—

5. Find `accept-download: false`, then change it to `accept-download: true`.


|| ⚠ NOTE ⚠: You can find the `accept-download: false` at line number 12 in the default config file for BlueMap mod.

—

4. Save it, and restart your server.

—

# ️ How to Access My Rendered World ️

For your world to get rendered you need to first start your server and use the following command:

`/bluemap render `

|| ⚠ NOTE ⚠: Replace `` with your actual world name.

||| Please note that for the BlueMap plugin to work properly, your world should be named exactly `world` !

—

Then, to access your rendered world you need to open the internet browser and type your server IP, followed by `:` and then the `webserver-port` you set.

Example: If your server numeric IP is `198.56.78.432` and the `webserver-port` you set is `8189`, you can access your rendered world by tipping in the internet browser `198.56.78.432:8189`.


—

| If you find any issues setting up BlueMap into your server we ask you to contact us via live chat or the ticket system [here](https://ggservers.com/billing/submitticket.php).

—

# ❕ Useful Links ❕

– [How to install Mods on your server](https://help.ggservers.com/en-us/article/how-to-install-mods-on-your-server-1bauy2t/)
– [How To: Install Plugins on Your Server](https://help.ggservers.com/en-us/article/how-to-install-plugins-on-your-server-1yxw90a/)
– [How to: Upload a World to Your Server](https://help.ggservers.com/en-us/article/how-to-upload-a-world-to-your-server-2g0nyj/)