A 3d-map of your Minecraft worlds view-able in your browser using three.js (WebGL)


BlueMap is a tool that generates 3d-maps of your Minecraft worlds and displays them in your browser. Take a look at this demo. It is really easy to set up - almost plug-and-play - if you use the integrated web-server (optional).

The Sponge/Spigot-Plugin automatically updates your map as soon as something changes in your world, as well as rendering newly generated terrain and managing the render-tasks.

Some features and some blocks are still missing. Especially some tile-entities will not render correctly/at all. See below for a list of what is planned for future releases.


Getting started

BlueMap is mostly plug-and-play. Just install it like every other Sponge-Plugin and start your server. BlueMap will then generate a config-file for you in the ./config/bluemap/ folder. Here you can configure your maps and the web-server.

Please read the wiki for more information!

If you need help with the setup, feel free to join the Discord-server, I’ll be happy to help you there!

Metrics and Webserver

BlueMap uses bStats and an own metrics-system and is hosting a web-server!

Metrics are really useful to keep track of how the plugin is used and helps me stay motivated! Please turn them on :)

bStats: All data collected by bStats can be viewed here: https://bstats.org/plugin/sponge/BlueMap. bStats data-collection is controlled by the metrics-setting set in sponges configuration! (Turned off by default)

own metrics: Additionally to bStats, BlueMap is sending a super small report, containing only the implementation-name and the version of the BlueMap-plugin to my server. I do this, because there are some other implementations for BlueMap (Fabric, Forge, CLI) that are not supported by bStats. Here is an example report:

    "implementation": "sponge",
    "version": "0.0.0"

This data-collection is also controlled by the metrics-setting set in sponges configuration! (Turned off by default)

web-server: The web-server is a core-functionality of this plugin. So it is enabled by default but can be disabled in the plugin-config. By default the web-server is bound to all network-interfaces (‘’) on port 8100 and is hosting the content of the ./bluemap/web/-folder.

Commands and Permissions

See: https://bluemap.bluecolored.de/wiki/getting-started/Commands.html

Todo / planned features

Here is a todo-list ordered by what i right now think is the priority, but might always change or be reordered at my discretion. (I develop BlueMap in my free-time, so nothing here is a promise and there are no ETA’s)

Issues / Suggestions

You found a bug, have another issue or a suggestion? You are very welcome to to join the Discord-server and the reddit and share your thoughts!

Category: Miscellaneous

Published on Nov 15, 2019




total downloads

Licensed under MIT

Promoted Versions