Перейти к содержимому
Mineforgian

BlueMap

A Minecraft mapping tool that creates 3D models of your Minecraft worlds and displays them in a web viewer.

400K загрузок1K подписчиковMITfabricfoliaforgeneoforgepaperpurpurspigotsponge

Обновлён 17 июня 2026 г. · опубликован 10 мая 2022 г.

  • Скриншот: BlueMap
  • Скриншот: BlueMap
  • Скриншот: BlueMap
  • Скриншот: BlueMap

title-banner

create 3D-maps of your Minecraft worlds and display them in your browser
>> DEMO MAP <<

GitHub issues GitHub all releases GitHub release (latest by date) Discord



What is BlueMap

BlueMap is a program that reads your Minecraft world files and generates not only a map, but also 3D-models of the whole surface. With the web-app you then can look at those in your browser and basically view the world as if you were ingame! Or just look at it from far away to get an overview.

screenshot

BlueMap comes as a Spigot/Paper or Sponge Plugin, as a Fabric or Forge-Mod and you can also use BlueMap without any Server from the Command-Line as a standalone tool.

If installed as a Plugin/Mod, BlueMap renders asynchronously to your MinecraftServer-Thread. This means at no time will it block your server-thread directly. So as long as your CPU is not fully utilized, your server should not be slowed down while BlueMap is rendering.

Using BlueMap

You can download BlueMap from here.
Read the installation instructions to get started!
And here is a list of addons and tools that work with bluemap.

Here you can see how many servers are using BlueMap:

BlueMap Graph

If you need help with the setup, feel free to join the Discord-server, we'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/bukkit/BlueMap/5912.

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"
}

All metrics can be disabled in the plugins config.

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 ('0.0.0.0') on port 8100 and is hosting the content of the ./bluemap/web/-folder.

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!

Версии

ВерсияКаналИграЗагрузчикиДатаСкачать
5.22-spongeРелиз26.1, 26.1.1, 26.1.2, 26.2sponge17 июня 2026 г..jar (5.7 МБ)
5.22-spigotРелиз26.1, 26.1.1, 26.1.2, 26.2spigot17 июня 2026 г..jar (6.3 МБ)
5.22-paperРелиз26.1.1, 26.1.2, 26.2folia, paper, purpur17 июня 2026 г..jar (5.5 МБ)
5.22-neoforgeРелиз26.1, 26.1.1, 26.1.2, 26.2neoforge17 июня 2026 г..jar (6.2 МБ)
5.22-forgeРелиз26.1, 26.1.1, 26.1.2, 26.2forge17 июня 2026 г..jar (6.2 МБ)
5.22-fabricРелиз26.1, 26.1.1, 26.1.2, 26.2fabric17 июня 2026 г..jar (6.2 МБ)
5.21-spongeРелиз26.1, 26.1.1, 26.1.2, 26.2sponge16 июня 2026 г..jar (5.7 МБ)
5.21-spigotРелиз26.1, 26.1.1, 26.1.2, 26.2spigot16 июня 2026 г..jar (6.3 МБ)
5.21-paperРелиз26.1.1, 26.1.2, 26.2folia, paper, purpur16 июня 2026 г..jar (5.5 МБ)
5.21-neoforgeРелиз26.1, 26.1.1, 26.1.2, 26.2neoforge16 июня 2026 г..jar (6.2 МБ)
5.21-forgeРелиз26.1, 26.1.1, 26.1.2, 26.2forge16 июня 2026 г..jar (6.2 МБ)
5.21-fabricРелиз26.1, 26.1.1, 26.1.2, 26.2fabric16 июня 2026 г..jar (6.2 МБ)
5.20-spongeРелиз26.1, 26.1.1, 26.1.2sponge12 апреля 2026 г..jar (5.6 МБ)
5.20-spigotРелиз26.1, 26.1.1, 26.1.2spigot12 апреля 2026 г..jar (6.2 МБ)
5.20-paperРелиз26.1.1, 26.1.2folia, paper, purpur12 апреля 2026 г..jar (5.5 МБ)

Показаны последние 15 из 401 версий. Все версии — на Modrinth.

Ченджлог

5.22-spongeРелиз26.1.1, 26.1.2, 26.2 · 17 июня 2026 г.

Highlights / Notes

Fix for a map-breaking bug in 5.21: update directly to this version, skip version 5.21!

Upgrading from 5.20 (and 5.21)

  • Replace the bluemap.jar-file with the new one
  • Move the full-update-interval and the update-cooldown settings from your plugin.conf into your core.conf

This update contains some internal changes which might break some BlueMap-Addons that work with custom block-renderers.
-> Make sure to check if your addons need to be updated.

Changelog since 5.21

  • Fixed an issue causing the textures of maps from previous versions to be corrupted

Full Changelog

https://github.com/BlueMap-Minecraft/BlueMap/releases/tag/v5.22

5.22-spigotРелиз26.1.1, 26.1.2, 26.2 · 17 июня 2026 г.

Highlights / Notes

Fix for a map-breaking bug in 5.21: update directly to this version, skip version 5.21!

Upgrading from 5.20 (and 5.21)

  • Replace the bluemap.jar-file with the new one
  • Move the full-update-interval and the update-cooldown settings from your plugin.conf into your core.conf

This update contains some internal changes which might break some BlueMap-Addons that work with custom block-renderers.
-> Make sure to check if your addons need to be updated.

Changelog since 5.21

  • Fixed an issue causing the textures of maps from previous versions to be corrupted

Full Changelog

https://github.com/BlueMap-Minecraft/BlueMap/releases/tag/v5.22

5.22-paperРелиз26.1.1, 26.1.2, 26.2 · 17 июня 2026 г.

Highlights / Notes

Fix for a map-breaking bug in 5.21: update directly to this version, skip version 5.21!

Upgrading from 5.20 (and 5.21)

  • Replace the bluemap.jar-file with the new one
  • Move the full-update-interval and the update-cooldown settings from your plugin.conf into your core.conf

This update contains some internal changes which might break some BlueMap-Addons that work with custom block-renderers.
-> Make sure to check if your addons need to be updated.

Changelog since 5.21

  • Fixed an issue causing the textures of maps from previous versions to be corrupted

Full Changelog

https://github.com/BlueMap-Minecraft/BlueMap/releases/tag/v5.22

5.22-neoforgeРелиз26.1.1, 26.1.2, 26.2 · 17 июня 2026 г.

Highlights / Notes

Fix for a map-breaking bug in 5.21: update directly to this version, skip version 5.21!

Upgrading from 5.20 (and 5.21)

  • Replace the bluemap.jar-file with the new one
  • Move the full-update-interval and the update-cooldown settings from your plugin.conf into your core.conf

This update contains some internal changes which might break some BlueMap-Addons that work with custom block-renderers.
-> Make sure to check if your addons need to be updated.

Changelog since 5.21

  • Fixed an issue causing the textures of maps from previous versions to be corrupted

Full Changelog

https://github.com/BlueMap-Minecraft/BlueMap/releases/tag/v5.22

5.22-forgeРелиз26.1.1, 26.1.2, 26.2 · 17 июня 2026 г.

Highlights / Notes

Fix for a map-breaking bug in 5.21: update directly to this version, skip version 5.21!

Upgrading from 5.20 (and 5.21)

  • Replace the bluemap.jar-file with the new one
  • Move the full-update-interval and the update-cooldown settings from your plugin.conf into your core.conf

This update contains some internal changes which might break some BlueMap-Addons that work with custom block-renderers.
-> Make sure to check if your addons need to be updated.

Changelog since 5.21

  • Fixed an issue causing the textures of maps from previous versions to be corrupted

Full Changelog

https://github.com/BlueMap-Minecraft/BlueMap/releases/tag/v5.22

5.22-fabricРелиз26.1.1, 26.1.2, 26.2 · 17 июня 2026 г.

Highlights / Notes

Fix for a map-breaking bug in 5.21: update directly to this version, skip version 5.21!

Upgrading from 5.20 (and 5.21)

  • Replace the bluemap.jar-file with the new one
  • Move the full-update-interval and the update-cooldown settings from your plugin.conf into your core.conf

This update contains some internal changes which might break some BlueMap-Addons that work with custom block-renderers.
-> Make sure to check if your addons need to be updated.

Changelog since 5.21

  • Fixed an issue causing the textures of maps from previous versions to be corrupted

Full Changelog

https://github.com/BlueMap-Minecraft/BlueMap/releases/tag/v5.22

5.21-spongeРелиз26.1.1, 26.1.2, 26.2 · 16 июня 2026 г.

Highlights / Notes

  • Minecraft 26.2 support
  • Changes to how map-updates are scheduled. Render-Tasks now persist over restarts/reloads

Upgrading from 5.20

  • Replace the bluemap.jar-file with the new one
  • Move the full-update-interval and the update-cooldown settings from your plugin.conf into your core.conf

This update contains some internal changes which might break some BlueMap-Addons that work with custom block-renderers.
-> Make sure to check if your addons need to be updated.

Changelog since 5.20

  • Updated resource-extensions to account for 26.2 bed and sign changes (-> 26.2 support)
  • BlueMap now keeps track of when it last updated which region-file and uses this information to sort it's update-tasks.
    This makes sure that no matter how slow the update-process is in comparison to the world-changes, BlueMap will always have eventually updated each region-file.
  • BlueMap now saves render-tasks and loads them when it restarts or reloads
  • BlueMap no longer updates all maps each time it loads. Instead, it persists the last full-update time and schedules full map-updates based on the full-update-interval config
  • Moved update-cooldown and full-update-interval configs from plugin.conf to core.conf
  • Added /bluemap tasks cancel all command to cancel all render-tasks at once
  • Updated API to 2.8.0
  • Reworked block-color calculation, added a registry for addons and the ability to configure custom color-map textures in the blockColors.json
  • Re-enabled support for fabric-pemission-api
  • Skin-Profile requests now use the un-dashed UUID format (aligning with mojang-default)
  • Enhanced debug-dump with registry-information
  • Added version information to the debug-log
  • Fixed an issue with paper not loading custom dimension information correctly
  • Fixed skin-download config doing nothing
  • Fixed potential error when trying to load an entity-chunk with a formatted CustomName

Full Changelog

https://github.com/BlueMap-Minecraft/BlueMap/releases/tag/v5.21

5.21-spigotРелиз26.1.1, 26.1.2, 26.2 · 16 июня 2026 г.

Highlights / Notes

  • Minecraft 26.2 support
  • Changes to how map-updates are scheduled. Render-Tasks now persist over restarts/reloads

Upgrading from 5.20

  • Replace the bluemap.jar-file with the new one
  • Move the full-update-interval and the update-cooldown settings from your plugin.conf into your core.conf

This update contains some internal changes which might break some BlueMap-Addons that work with custom block-renderers.
-> Make sure to check if your addons need to be updated.

Changelog since 5.20

  • Updated resource-extensions to account for 26.2 bed and sign changes (-> 26.2 support)
  • BlueMap now keeps track of when it last updated which region-file and uses this information to sort it's update-tasks.
    This makes sure that no matter how slow the update-process is in comparison to the world-changes, BlueMap will always have eventually updated each region-file.
  • BlueMap now saves render-tasks and loads them when it restarts or reloads
  • BlueMap no longer updates all maps each time it loads. Instead, it persists the last full-update time and schedules full map-updates based on the full-update-interval config
  • Moved update-cooldown and full-update-interval configs from plugin.conf to core.conf
  • Added /bluemap tasks cancel all command to cancel all render-tasks at once
  • Updated API to 2.8.0
  • Reworked block-color calculation, added a registry for addons and the ability to configure custom color-map textures in the blockColors.json
  • Re-enabled support for fabric-pemission-api
  • Skin-Profile requests now use the un-dashed UUID format (aligning with mojang-default)
  • Enhanced debug-dump with registry-information
  • Added version information to the debug-log
  • Fixed an issue with paper not loading custom dimension information correctly
  • Fixed skin-download config doing nothing
  • Fixed potential error when trying to load an entity-chunk with a formatted CustomName

Full Changelog

https://github.com/BlueMap-Minecraft/BlueMap/releases/tag/v5.21

Полная история изменений — на Modrinth.

Комментарии

Загружаем…