# BlueMap-Minecraft/BlueMap

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

Repository: https://github.com/BlueMap-Minecraft/BlueMap
Canonical: https://ross.abutalabs.com/products/bluemap
Homepage: https://bluecolo.red/bluemap
Language: Java
License: MIT
License Family: permissive
Topics: minecraft, minecraft-mod, minecraft-plugin, threejs, webgl, bluemap
Last push: 2026-08-20T20:14:43+00:00

## Health v2 (maintenance only)
Score: 98/100 (v2, computed 2026-09-03T02:20:16.233290+00:00)
- activity 98, release rhythm 96, longevity 100
- inputs: {"age_days": 2496, "days_push": 13, "days_rel": 27, "gap_med": 30, "n_releases_24m": 20}
- flags: none
- formula: round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10)

## Adoption (not part of the score)
Stars 2796, forks 234 (observed 2026-08-28T04:07:22.366884+00:00)

## What it is
BlueMap is a Java-based tool that reads Minecraft world files and generates 3D models of the world surface, viewable in a browser via a built-in web app. It ships as a Spigot/Paper or Sponge plugin, a Fabric or Forge mod, a standalone CLI tool, and a Docker image, rendering asynchronously so it doesn't block the game server thread.

## Use cases
- create a 3D map of my minecraft world viewable in a browser
- show a live web map of my minecraft server to players
- render minecraft worlds as 3d models
- view my minecraft world from outside the game
- host a web map for a bungeecord or velocity server network
- generate static map renders of minecraft worlds from the command line

## When to choose
- you run a Minecraft Java Edition server (Spigot/Paper, Sponge, Fabric, or Forge) and want a browser-viewable 3D map
- you want live map updates as the world changes without blocking your server thread
- you need to combine maps from multiple servers in a network into one web app
- you want to render maps offline/standalone without a running game server

## When to avoid
- you play Minecraft Bedrock Edition - BlueMap only supports Java Edition worlds
- you need a 2D flat map only with no 3D rendering
- you cannot open an additional port or host a webserver alongside your game server

## Facets
- artifact type: application
- maturity: active
- function: graphics, http-server, cli, plugin-system, data-visualization
- domain: gaming-tools, web-development, graphics
- platform: jvm, cli, self-hosted, cross-platform
- tags: minecraft-plugin, minecraft-mod, threejs, webgl, 3d-maps, world-renderer, spigot, paper, fabric, forge, minecraft, web-server, docker

## Member repositories
- BlueMap-Minecraft/BlueMap (main) score 98

## Provenance
- Observed fields: from GitHub, fetched 2026-08-28T04:07:22.366884+00:00.
- Health v2: computed from the inputs above; adoption is never an input.
- Inferred fields (summary, facets, guidance): AI-extracted, prompt v1, taxonomy v1, on 2026-08-29T18:49:12.332709+00:00, confidence not recorded.
  - readme: https://github.com/BlueMap-Minecraft/BlueMap (fetched 2026-08-28T04:07:22.366884+00:00, sha ca7a5bf547a9)
  - homepage: https://bluecolo.red/bluemap (fetched 2026-08-29T09:54:59.317629+00:00, sha 7415a043c0b8)
  - site_page: https://bluemap.bluecolored.de/wiki/getting-started (fetched 2026-08-29T09:54:59.329023+00:00, sha fad9c76a5ef7)
  - site_page: https://bluemap.bluecolored.de/wiki/getting-started/Installation.html (fetched 2026-08-29T09:54:59.330658+00:00, sha 669b9419c37f)
  - site_page: https://bluemap.bluecolored.de/wiki/getting-started/Configuration.html (fetched 2026-08-29T09:54:59.332418+00:00, sha 06f76e6aaea3)
  - site_page: https://bluemap.bluecolored.de/wiki/getting-started/Commands.html (fetched 2026-08-29T09:54:59.334147+00:00, sha 1e30be6e8a51)
  - site_page: https://bluemap.bluecolored.de/wiki/getting-started/ServerNetworks.html (fetched 2026-08-29T09:54:59.335762+00:00, sha 2a730af56ac2)
  - site_page: https://bluemap.bluecolored.de/wiki/FAQ.html (fetched 2026-08-29T09:54:59.326707+00:00, sha d391757c3f07)
- Data as of 2026-08-30T08:39:29.467469+00:00.