Installation

Installation

To run bluemap you need:

• Java 8
• Minecraft Java-Edition

On the CLI

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.jar so bluemap generates the configuration-file (./bluemap.conf) next to the jar in your cwd.
• Now open the config using your favorite editor and read the chapter Configuration to learn how to configure bluemap.
• After you have edited the config just run java -jar BlueMap.jar again to start the render.

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 file here ./config/bluemap/bluemap.conf, open that config with your favorite editor and read the chapter Configuration to learn how to configure bluemap.
• After you have edited the config use the command /bluemap reload on your server or restart the server.
• Run the command /bluemap render <world> on the server to start an initial render of the whole world.