Skip to the content
Know your tech before you buy it. Makers: get listed from $49/mo

BlueMap

bluemap.bluecolored.de

  • Free plan
  • Linux
  • Web
  • API
  • Self-hosted

What BlueMap is

BlueMap reads Minecraft world files and produces 3D surface maps for viewing in a browser. It supports Java Edition worlds, not Bedrock Edition. Server owners can install it as a Spigot, Paper, or Sponge plugin, or as a Fabric or Forge mod; it can also run from the command line without a Minecraft server. The documentation describes using its CLI in Docker. Plugin and mod installations render asynchronously to the Minecraft server thread, and users can configure the number of render threads. After an initial conversion, BlueMap tracks changes and converts only affected chunks. Maps can be stored in files or an SQL server. Configuration covers map display names and web app ordering, with map configuration files for adding or removing maps. Its API allows third-party plugins, mods, resource packs, and external tools to integrate features. The integrated webserver does not provide SSL, and BlueMap itself has no authentication; the FAQ points to an external webserver for those functions. Server plugin or mod use requires Java 25 or later; standalone CLI documentation lists Java 21 or later.

Who it suits

BlueMap suits Minecraft Java Edition server owners who want browser-viewable world maps, including those who prefer a standalone command-line setup. It is not for Bedrock Edition worlds.

Good to know, and what to watch

  • Available as server plugins, mods, or a standalone CLI.
  • Converts only changed chunks after initial map generation.
  • Maps can be stored in files or an SQL server.
  • API supports integration by third-party tools and add-ons.
  • Does not support Bedrock Edition worlds.
  • Integrated webserver lacks SSL and built-in authentication.
  • Server plugin and mod use requires Java 25+.

BlueMap

Free

Free plan

Getting started

  1. Open the BlueMap website
  2. Choose a Spigot, Paper or Sponge plugin, or a Fabric or Forge mod
  3. Install the plugin or mod on a Minecraft Java Edition server
  4. Alternatively run BlueMap from its command line without a server
  5. Use the documented Docker approach for CLI deployment if needed
  6. Configure maps, display names, ordering and storage

Limits to check

BlueMap supports Java Edition worlds only, not Bedrock Edition. Server plugin and mod installations require Java 25 or newer, while the standalone CLI documentation lists Java 21 or newer; SSL and authentication are not provided by the integrated webserver.

The Club's review

BlueMap is a free Java Edition Minecraft mapping tool that turns world data into browser-based 2D and 3D maps. It fits server operators and technically minded users who want to host maps themselves or convert worlds from the command line. The strongest case is its flexible deployment and incremental rendering; Bedrock users and anyone needing built-in web security should choose something else.

Overview

BlueMap is available as a Spigot/Paper or Sponge plugin, a Fabric or Forge mod, and a standalone command-line application that does not require a running Minecraft server. Documentation also covers running the command-line workflow in Docker, giving administrators a practical route for separate rendering infrastructure.

The output includes surface maps with 2D and 3D viewing modes, dimension maps, markers and waypoints. Worlds must be Minecraft Java Edition; Bedrock Edition worlds are outside its supported scope. The integrated webserver also lacks SSL and authentication, so a public deployment needs an external webserver to provide those protections.

Key features

Incremental server rendering

As a plugin or mod, BlueMap renders asynchronously rather than on the Minecraft server thread. Administrators can set the number of render threads, which provides a useful lever for balancing map generation against the resources needed by the game server. After the first conversion, BlueMap tracks world changes and converts only changed chunks. That makes routine updates more practical than repeatedly rebuilding an entire world, although the initial conversion still represents the heavier workload.

Standalone operation and storage

The CLI is a genuine alternative to installing a server integration: it can process world files independently and can be deployed with Docker according to the documentation. This suits archived worlds, offline conversion jobs and setups where map rendering should be isolated from the game server. Maps can be stored in ordinary files or an SQL server, allowing a choice between a simpler filesystem arrangement and database-backed storage.

Map organization and extensibility

Map configuration files support adding or removing maps, setting display names and controlling their order in the web app. Those controls matter when a server exposes several dimensions or worlds and needs a clear public presentation. BlueMap also exposes an API used by third-party plugins, mods, resource packs and external tools, so communities can extend the map experience beyond the core viewer. The maker does not exhaustively review listed add-ons or guarantee their safety, so administrators remain responsible for evaluating integrations before installing them.

Pricing

BlueMap is free software. Its BlueMap plan costs nothing and is limited to Java Edition worlds. There are no paid tiers or seat charges described for the plan. The main operational terms are technical: server plugin or mod use requires Java 25 or newer, while the standalone CLI documentation lists Java 21 or newer. That split may affect which installation route is practical on an existing machine.

Platforms

BlueMap is offered for API, Linux, self-hosted and web environments. Server integrations cover Spigot/Paper, Sponge, Fabric and Forge. The browser viewer makes the rendered result broadly shareable, but SSL and authentication must be handled outside BlueMap itself. Support questions are directed to the BlueMap Discord server or subreddit.

Who it's for

Choose BlueMap if you run a Java Edition server and want a live map with dimension coverage, markers and waypoints, or if you need a self-hosted conversion tool that can run without a server. Its asynchronous rendering and changed-chunk updates are particularly useful for active communities where a map should stay current without constant full-world processing. It is less suitable for Bedrock Edition projects, and public-facing deployments need administrators comfortable placing an external webserver in front of the integrated one.

Pros and cons

Pros

  • Multiple installation paths: plugins, mods, CLI and Docker documentation accommodate both server-integrated and standalone workflows.
  • Incremental updates: changed-chunk conversion reduces repeated work after the initial world render.
  • Resource control: configurable render-thread counts let operators tune rendering around server demands.
  • Useful map controls: 2D/3D views, dimensions, markers, waypoints and configurable map ordering cover common community-map needs.
  • Extensible API: third-party integrations can add capabilities through plugins, mods, resource packs and external tools.

Cons

  • Java-only world support: Bedrock Edition users cannot use BlueMap for their worlds.
  • External security required: the built-in webserver supplies neither SSL nor authentication.
  • Java version split: plugin and mod installations require Java 25+, while the CLI documentation uses Java 21+, complicating environment planning.
  • Add-on responsibility: listed extensions are not comprehensively safety-reviewed, leaving vetting to the operator.

Alternatives

For Bedrock worlds, choose BedrockMap, which offers a free tier with one world upload, a 1500x1500-block render area, two renders per day, three zoom levels and public sharing links across mobile, desktop and web platforms. Bedrock Viz is another free, GPL-2.0 option focused on Minecraft Bedrock Edition worlds and supports Linux, macOS, Windows and web.

Mapcrafter is a free GPL-licensed alternative for users working with Anvil worlds and Minecraft 1.6 resource packs. The Explorer's Friend is a free MIT-licensed server-side map mod/plugin for those who prefer that model. Chunkmap provides a free open-source beta CLI for Windows and web use. mcview is a free GPLv3 option for iOS, macOS and Windows. Tectonicus is a free desktop-oriented alternative for Linux, macOS and Windows. MCA Saenk is a free Windows tool with no paid plans or stated usage limits. For a broader comparison, see the Minecraft World Map Viewers list.

Verdict

BlueMap is the right choice for Java Edition server communities that want self-hosted live maps, flexible plugin/mod or CLI deployment, and efficient changed-chunk updates. Choose it primarily for that combination of integrations and control. Look elsewhere if your worlds are Bedrock, or if you need SSL and authentication supplied by the mapping product rather than configured through an external webserver.

The verdict

BlueMap offers several installation paths and updates maps by tracking changed chunks. Plan for Java requirements and an external webserver if you need SSL or authentication.

Questions people ask

Is BlueMap free?

Yes. The BlueMap plan costs nothing.

Which Minecraft editions does it support?

BlueMap supports Minecraft Java Edition worlds. It does not support Bedrock Edition worlds.

Can BlueMap run without a Minecraft server?

Yes. It can run from the command line, and the documentation describes using the CLI in Docker.

Which server platforms can install BlueMap?

It is available as a Spigot, Paper or Sponge plugin, and as a Fabric or Forge mod.

Does BlueMap provide SSL and authentication?

Its integrated webserver does not support SSL itself, and BlueMap does not provide authentication itself. An external webserver is suggested for these functions.

How does BlueMap update maps?

After the initial conversion, it tracks world changes and converts only changed chunks.

What the maker publishes

Add-on safety
The maker says it does not exhaustively review listed add-ons or guarantee their safety, though it tries to remove actively harmful ones. source
API and add-ons
BlueMap provides an API used by third-party plugins, mods, resource packs, and external tools to integrate features. source
Customization
The configuration guide says map settings include display names and web app ordering, and BlueMap supports adding and removing maps through map configuration files. source
Map updates
After the initial conversion, BlueMap tracks world changes and converts only changed chunks. source
Purpose
BlueMap reads Minecraft world files and generates 3D surface maps viewable in a browser. source
Rendering
When installed as a plugin or mod, BlueMap renders asynchronously to the Minecraft server thread and can be configured to control its render-thread count. source
Security limit
The integrated webserver does not support SSL itself, and BlueMap does not provide authentication by itself; the FAQ suggests using an external webserver for these functions. source
Server integrations
It is available as a Spigot/Paper or Sponge plugin and as a Fabric or Forge mod. source
Standalone use
BlueMap can run from the command line without a Minecraft server, and the documentation also describes using its CLI in Docker. source
Storage
Maps can be stored in files or in an SQL server, according to the installation guide. source
Support
The maker directs users with questions or support needs to its Discord server or the BlueMap subreddit. source
World support limit
BlueMap supports Minecraft Java Edition worlds and does not support Bedrock Edition worlds. source

Checked against the maker's pages on 3 Oct 2026.