Minecraft plugin BlueMap

🔌 About BlueMap

BlueMap is a Minecraft mapping tool that reads server world files and generates 3D models and an interactive web viewer. It can run as a server plugin or mod (Spigot/Paper or Sponge plugin, Fabric/Forge mod) or as a standalone command‑line renderer. When installed on a running server BlueMap renders asynchronously so it does not block the main server thread.

🎯 Purpose

BlueMap provides a browser-accessible, three-dimensional representation of a Minecraft world so administrators and players can explore terrain, locate structures, and inspect builds without joining the server. It is targeted at server operators who need an up-to-date visual map for administration, navigation, or community showcase purposes.

⚙️ Features

• Generates 3D models of the world surface and serves them in a browser-based web viewer.
• Runs as a plugin/mod (Spigot/Paper, Sponge, Fabric, Forge) or as a standalone CLI tool.
• Asynchronous rendering to avoid blocking the Minecraft server thread.
• Supports resource packs and data packs to customize textures, block models and biome colors used in renders.
• Supports multiple storage backends and map management via commands (load, unload, list, delete, etc.).
• Marker support and an API for third-party plugins to add or manage markers on maps.
• Runtime reload and render-control commands (reload, start/stop rendering, update/purge maps, freeze/unfreeze maps).

🧩 Who It Is For

• Survival and SMP servers that want a public or admin-facing 3D map.
• Creative or showcase servers that need browser-accessible previews of builds.
• Server administrators who require remote inspection and map-based navigation tools.

🏗️ Example Use Cases

• Provide players with a publicly hosted 3D map of the world to help navigation and showcase builds.
• An admin locates and reviews player-built bases or claims from the web viewer before visiting in-game.
• A plugin uses BlueMap's API to display dynamic markers for events, shops, or teleport locations.

⌨️ Commands

(All commands above are documented by the project; exact permission nodes are provided in project documentation and are not repeated here.)

⚙️ Installation

📥 Setup

• Download the appropriate BlueMap JAR for your platform (plugin JAR for Spigot/Paper/Sponge, mod JAR for Fabric/Forge or standalone CLI distribution).
• Place the JAR into the server plugins/ folder (for Spigot/Paper/Sponge) or mods/ folder (for Fabric/Forge), or use the CLI distribution files for standalone rendering.
• Start or restart the server. Watch the server console to confirm BlueMap and its embedded web server started successfully.

📦 Dependencies

• No mandatory external plugin dependencies are required for core map rendering. Optional integrations and add-ons exist; consult the project documentation for third-party addon info.

🧠 Technical Notes

• BlueMap is distributed as server plugins, mods, and a CLI tool; choose the artifact matching your setup.
• Rendering is performed asynchronously to avoid blocking the main server thread.
• Resource packs and data packs can be placed in the configured packs directory to change map visuals.
• The project maintains a public source repository and release builds; configuration is file-based and reloadable at runtime.

🤝 When This Plugin Is Useful

If you need a browser-accessible, three-dimensional view of your Minecraft world for navigation, build review, or community display, BlueMap provides automated rendering, runtime control, and an API for markers and integrations without requiring players to join the server.