BlueMap is a 3D world map plugin that renders your server’s world on a browser and is served by an integrated web server on your Minecraft server. Compared to DynMap, it offers better performance and aesthetics. It renders an accurate 3D block-to-block map of the world, including full-resolution textures, which can be navigated as a spectator or from a pseudo-top-down view. If you prefer a simpler 2D map, see SquareMap instead.

You can install BlueMap on any Forge, Fabric, Sponge, or Spigot based server, including any forks of Fabric or Spigot like Paper and Quilt.

The first step of the installation process is to identify what mod loader you’re using and the download the correct version of BlueMap from the releases page on GitHub. Each version will have the name of the mod loader attached to it. Then you’ll need to upload the file to your servers mod or plugin folder Using SFTP or Using the File Manager and restart your server.

After you’ve restarted your server you’ll need to assign a port in the configuration file. The next section goes over details surrounding what the port does and where to find one you can use.

port

BlueMap requires a port to serve the web server that your players will connect to. The port number will be appended to the end of your server IP or domain in a browsers address bar in order to view the web map. For example, 123.123.123.123:8100 or example.com:8100.

You most likely already have a port you can use. New servers come with several ports set up automatically, so check Management → Allocations in the Game Panel first and pick one that isn’t your Primary allocation and isn’t already used by another plugin. If you’re on a dedicated IP, you should be able to use the default BlueMap port of 8100, but on a shared IP you’ll need to use one of the ports listed in your Allocations tab. You only need to request another port if every one is already in use. See Additional Ports & Allocations for how.

With the port number in hand, locate your configuration file for the mod/plugin loader using this Guide provided by BlueMap and change the port value in the webserver.conf file to the port you picked from your Allocations tab. After another server restart you should be able to access BlueMap from your Server IP + the port, IE <ServerIP:8100>.