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.

🔌 BlueMap Plugin 🔌

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

Here 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:

Log in to your Multicraft panel here and stop your server.


Click on Installers, then on Plugin Auto Setup.




Click on BlueMap.




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:

Download your wished BlueMap plugin version here.




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



Here is our guide for using FileZilla.


Restart your server.

Configuring

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

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




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




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.


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 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:

Download your wished BlueMap mod version here.




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



Here is our guide for using FileZilla.


Restart your server.

Configuring

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

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




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




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.


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




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.


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 <worldname>

⚠ NOTE ⚠: Replace <worldname> 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.

❕ Useful Links ❕

- How to install Mods on your server
- How To: Install Plugins on Your Server
- How to: Upload a World to Your Server

Actualizado el: 27/02/2025