---
title: "BlueMap Setup Guide: Install a 3D Web Map | ZCraft Studios"
description: "An interactive, 3D, browser-based map of the server world, generated from the actual world files, updated live as the server runs."
url: "https://www.zcraftstudios.com/blog/bluemap-web-map-setup"
updated: "2026-10-20T07:16:58.634954+00:00"
source: "ZCraft Studios"
---

> Site index for AI agents: https://www.zcraftstudios.com/llms.txt (full reference: https://www.zcraftstudios.com/llms-full.txt). Every page is available as Markdown by adding `.md` to its URL or sending `Accept: text/markdown`.

1. [Home](https://www.zcraftstudios.com/)
2. [Blog](https://www.zcraftstudios.com/blog)
3. BlueMap Setup Guide: Install a 3D Web Map

[ All posts](https://www.zcraftstudios.com/blog)

# BlueMap Setup Guide: Install a 3D Web Map

ZCraft StudiosOct 3, 2026Updated Oct 20, 2026

An interactive, 3D, browser-based map of the server world, generated from the actual world files, updated live as the server runs.

## In this guide

- [Install BlueMap](#install-bluemap)
- [Accessing the Map](#accessing-the-map)
- [Configuring Which Worlds Render](#configuring-which-worlds-render)
- [Hiding Specific Areas](#hiding-specific-areas)
- [Forcing a Re-render](#forcing-a-re-render)
- [Putting the Map Behind a Domain](#putting-the-map-behind-a-domain)
- [A Few Things Worth Knowing](#a-few-things-worth-knowing)
- [Publishing the map safely](#publishing-the-map-safely)
- [A production-ready map rollout](#a-production-ready-map-rollout)
- [Official documentation and links](#official-documentation-and-links)
- [BlueMap project examples](#bluemap-project-examples)
- [Check rendering load and public exposure](#check-rendering-load-and-public-exposure)

## Setting Up a Web Map With BlueMap

_A live, explorable 3D map of the server, viewable in any browser without installing anything._

BlueMap renders a server's world files into an interactive 3D map, viewable through a web browser. Unlike older 2D map plugins, it renders real block geometry, so players can see builds, terrain, and structures close to how they actually look in-game.

## Install BlueMap

[BlueMapA Minecraft mapping tool that creates 3D models of your Minecraft worlds and displays them in a web viewer.On Modrinth ](https://modrinth.com/plugin/bluemap)

Download BlueMap from the project linked above. Check the supported Minecraft version, server platform, Java requirement and dependencies for the selected release.

1. Back up the server files and any plugin database.
2. Stop the server before changing JAR files. Put the compatible plugin build and its required dependencies in the correct plugin folder.
3. Start the server and read the startup log. Resolve missing dependencies or version errors before editing the generated configuration.
4. Stop the server, make one small configuration change, then restart and test it with a non-operator account.

Confirm BlueMap loads after a clean restart. Test the feature you need with an ordinary player account before adding optional integrations.

## Accessing the Map

By default, BlueMap serves its web interface on port `8100`. Open the firewall for it:

```
sudo ufw allow 8100/tcp
```

Then visit `http://<server-ip>:8100` in a browser to see the map once rendering has progressed far enough to show something.

## Configuring Which Worlds Render

`plugins/BlueMap/core.conf` and the per-world config files under `plugins/BlueMap/maps/` control which worlds get rendered and how. Disabling render for worlds that don't need a map (temporary or private worlds) speeds up initial generation significantly.

## Hiding Specific Areas

For areas that shouldn't appear on a public map (staff-only regions, unfinished builds), BlueMap supports marker-based hiding and can integrate with WorldGuard regions to automatically skip protected areas, configured in the per-map config file.

## Forcing a Re-render

Normal operation updates the map incrementally as chunks change. After a major world edit or terrain change, a full re-render can be forced:

```
/bluemap render <world>
```

## Putting the Map Behind a Domain

Running BlueMap behind a reverse proxy (nginx or similar) lets it live at a clean subdomain like `map.yourserver.com` instead of an IP and port. This also makes it straightforward to add HTTPS via a standard certificate, which the raw BlueMap server doesn't handle on its own.

## A Few Things Worth Knowing

- Initial render time scales with world size and explored area: a heavily explored survival world can take hours on first render, while a small modest world finishes in minutes.
- BlueMap uses real-time rendering for live player markers, but terrain updates on a configurable interval, not instantly block-by-block.
- It's read-only by default. BlueMap doesn't let website visitors interact with or modify the world, only view it.

## Publishing the map safely

Render a small test region first and view it in a browser on a phone as well as a desktop. Confirm where static assets are stored, how the web server is exposed, and whether player positions or private worlds should be visible. Do not publish an admin panel or expose credentials as part of the map website.

## A production-ready map rollout

Treat BlueMap as a separate website connected to your game data. Before public release, verify that the map accurately represents your world and that publishing it does not expose locations players expect to keep private.

### Step-by-step validation

1. Install the BlueMap build compatible with your server software and game version using the official documentation.
2. Start the server and check startup logs to confirm that BlueMap created its configuration and recognized the world.
3. Render a small test area rather than committing to an entire world immediately.
4. Open the resulting map on both a desktop browser and a phone. Inspect labels, navigation, loading times and missing chunks.
5. Review the web-server access method, public ports and proxy rules. Expose only the website endpoint you intend visitors to reach.
6. Decide whether player markers, private worlds or coordinates should be public. Test those privacy settings from a browser that has no administrator access.
7. Record where generated map files live so storage monitoring and backups cover them appropriately.

### Troubleshooting

| Problem | What to check |

| --- | --- |

| Blank page | Browser errors, web service status and intended public address |

| Missing terrain | Render queue, world selection and generated file permissions |

| Slow rendering | Disk space, CPU activity and server load |

| Unexpected player information | Map visibility settings before sharing the URL |

For current settings, installation and web hosting options, use the [official BlueMap wiki](https://bluemap.bluecolored.de/wiki/).

## Official documentation and links

- [Official project repository](https://github.com/BlueMap-Minecraft/BlueMap)
- [Hardening a Minecraft Server With a Firewall](https://www.zcraftstudios.com/blog/minecraft-server-firewall-hardening)

[BlueMapA Minecraft mapping tool that creates 3D models of your Minecraft worlds and displays them in a web viewer.On Modrinth ](https://modrinth.com/plugin/bluemap)

## BlueMap project examples

These images come from the project’s official gallery. Use them to see the interface or gameplay; they show publisher examples rather than this server’s configuration.

[![BlueMap: official gallery example 1 ](https://cdn.modrinth.com/data/swbUV1cr/images/c67cba34a5f833b6e95bf05c513c8ff1ef1edbf2_350.webp)](https://modrinth.com/plugin/bluemap/gallery)

_Official BlueMap gallery example. [Image source](https://modrinth.com/plugin/bluemap/gallery)._

[![BlueMap: official gallery example 2 ](https://cdn.modrinth.com/data/swbUV1cr/images/bab445a31b7857a68b6e115ae267e69e34393789_350.webp)](https://modrinth.com/plugin/bluemap/gallery)

_Official BlueMap gallery example. [Image source](https://modrinth.com/plugin/bluemap/gallery)._

## Check rendering load and public exposure

Create an initial render while watching disk space, CPU activity and server responsiveness. Large worlds take significant time and storage, so do not assume every map layer needs rendering immediately. Verify permissions and hosting of the browser viewer separately from the in-game plugin.

Consider whether the map should display players or private locations. Public maps can reveal builds that some communities prefer to keep undisclosed. Test the browser view as a logged-out visitor.

## Continue reading

- [BlueMap vs Dynmap: Which Minecraft Web Map Plugin Is Better?](https://www.zcraftstudios.com/blog/bluemap-vs-dynmap-comparison)
- [Dynmap Setup Guide: Install, Render and Secure](https://www.zcraftstudios.com/blog/dynmap-setup-guide)
- [PlaceholderAPI Setup: Install Expansions and Placeholders](https://www.zcraftstudios.com/blog/placeholderapi-setup-guide)

[ Previous guide PlaceholderAPI Setup: Install Expansions and Placeholders](https://www.zcraftstudios.com/blog/placeholderapi-setup-guide)[ Next guide Setting Up LiteBans for Ban, Mute, and Kick Logging](https://www.zcraftstudios.com/blog/litebans-setup-guide)