Link Search Menu Expand Document

Installation

  1. Prerequisites
  2. As a sponge-plugin
  3. As a spigot/paper-plugin
  4. As a forge/fabric-mod
  5. On the CLI / standalone

Prerequisites

To run bluemap you need:

  • Java 8 or newer
  • Minecraft Java-Edition
  • (Usually) a second open port on your server

BlueMap only works with Java-Edition worlds, Bedrock-Edition worlds are not supported!

As a sponge-plugin

If you have a sponge-server, you can use bluemap as a plugin on your server. The plugin then renders and actively updates your map when something changes. Render-tasks are paused and resumed if the server shuts down / restarts.

  • First you want to download the bluemap-jar. You can choose and download a version from here or from sponges plugin-repository. Make sure it targets the SpongeAPI-Version of your server!
  • Put the downloaded jar in the mods-folder of your server and restart the server.
  • BlueMap will now generate the configuration files here ./config/bluemap/, open those configs with your favorite editor and read the chapter Configuration to learn how to configure bluemap.
  • After you have edited the configs use the command /bluemap reload on your server or restart the server.

Now BlueMap starts to render your maps. You can go to http://<your-server-ip>:<port>/ to view the maps.

As a spigot/paper-plugin

If you have a spigot or paper-server, you can use bluemap as a plugin on your server. The plugin then renders and actively updates your map when something changes. Render-tasks are paused and resumed if the server shuts down / restarts.

  • First you want to download the bluemap-jar. You can choose and download a version from here or spigotmc.org. Make sure it targets the SpigotAPI-Version of your server!
  • Put the downloaded jar in the plugins-folder of your server and restart the server.
  • BlueMap will now generate the configuration files here ./plugins/BlueMap/, open those configs with your favorite editor and read the chapter Configuration to learn how to configure bluemap.
  • After you have edited the configs use the command /bluemap reload on your server or restart the server.

Now BlueMap starts to render your maps. You can go to http://<your-server-ip>:<port>/ to view the maps.

As a forge/fabric-mod

If you have a forge or fabric-server, you can use bluemap as a mod on your server. The mod then renders and actively updates your map when something changes. Render-tasks are paused and resumed if the server shuts down / restarts.

  • First you want to download the bluemap-jar. You can choose and download a version from here. Make sure it targets the forge/fabric-Version of your server!
  • If you have a fabric-server you will also need to install the fabricAPI mod.
  • Put the downloaded bluemap-jar in the mods-folder of your server and restart the server.
  • BlueMap will now generate the configuration files here ./config/bluemap/, open that config with your favorite editor and read the chapter Configuration to learn how to configure bluemap.
  • After you have edited the configs use the command /bluemap reload on your server or restart the server.

Now BlueMap starts to render your maps. You can go to http://<your-server-ip>:<port>/ to view the maps.

On the CLI / standalone

You can use bluemap as a standalone app using the CLI. This is useful if you want to render a map of a minecraft-world you have, but don’t want to setup a server.

  • First you want to download the bluemap-jar. You can choose and download a version from here. Make sure it targets CLI and is compatible with the minecraft-version of the world you want to render.
  • Choose/create a directory where you want bluemap to run and generate it’s config and files and store your downloaded jar in this folder.
  • Open the CLI and change your cwd to the folder containing your jar. (using cd <path-to-your-folder>)
  • Run java -jar BlueMap-cli.jar so bluemap generates the configuration-files next to the jar in your cwd.
  • Now open the configs using your favorite editor and read the chapter Configuration to learn how to configure bluemap.
  • After you have edited the configs run java -jar BlueMap-cli.jar -r to start the render.
  • With java -jar BlueMap-cli.jar -w you can also start the builtin web-server to be able to view your map. Or you can read this to learn how to setup NGINX or Apache for BlueMap.