PC Slower Than It Used to Be?
A free scan shows the junk files, broken settings and background clutter dragging Windows down - then fixes them in one click.Free scan · Windows 10 & 11Crashes, No Sound, or Screen Glitches?
Random freezes, missing sound and display glitches usually trace back to one bad driver. Find and replace yours safely.Free scan · under a minuteBlueMap turns a Minecraft Java Edition world into an interactive 3D map that opens in a web browser. For a live server, install the build that matches your server platform and Minecraft version, let it create its configuration, render the world with /bluemap render <world>, then expose BlueMap’s integrated web server at the configured address and port. Paper and Spigot use a plugin, Fabric and Forge use a mod, and a standalone command-line build can render a world without a running Minecraft server.
Prefer not to run the server on your own PC? Godlike.Host offers hosted Minecraft Java servers with free DDoS protection and up to three free backups a day.
What BlueMap does
BlueMap reads Minecraft world files, builds 3D models of the world’s surface, and displays those models in a browser-based viewer. It is more than a flat overhead image: the generated data represents terrain and structures as a navigable 3D map.
As an Amazon Associate I earn from qualifying purchases.
Do these 3 things before closing this tab:
1Scan for outdated or missing drivers - takes under a minute2Clear out junk files and repair common Windows errors3Fix the driver behind crashes, sound loss and screen glitchesThe project distributes BlueMap in three operational forms:
- Server plugin: for Spigot- and Paper-based servers.
- Server mod: for Fabric and Forge, with a Sponge-compatible server deployment also available.
- Standalone CLI: for rendering a world outside a running Minecraft server.
Your choice determines where the files go, which configuration directory is created, how the render is triggered, and how you maintain the web endpoint.
#1 Best Overall
Check compatibility before downloading
Use a Java Edition world
The official installation documentation does not support Bedrock worlds. This guide therefore assumes a Minecraft Java Edition server and a Java Edition world folder. A Bedrock world converted to Java is a separate conversion project; BlueMap should not be expected to read the original Bedrock files directly.
Match the release to your server
BlueMap publishes separate builds and compatibility ranges. Select the jar for your loader and Minecraft version rather than choosing a jar by filename alone:
What’s actually slowing this PC down?
Pick the symptom - the matching free tool is one click away.
| Server or workflow | BlueMap package | Installation location |
|---|---|---|
| Paper | Paper-compatible plugin | plugins |
| Spigot | Spigot-compatible plugin | plugins |
| Fabric | Fabric mod | mods |
| Forge | Forge mod | mods |
| Sponge | Sponge-compatible plugin | mods, according to the setup documentation |
| No running server | Standalone CLI build | Any directory you administer |
Use the Java requirement for the release you install
The current official installation page lists Java 25 or newer, while older installation material lists Java 8 or newer. Those figures describe different generations of BlueMap documentation, not a universal rule that every release accepts both runtimes. Check the installation page and release notes for the exact build you downloaded, and run BlueMap with that Java version. If the server itself uses a different Java runtime, make sure the BlueMap process can still start with the version required by its release.
Back up before the first render
Rendering reads the world data and creates map output, but a server upgrade or an incorrectly selected jar can still cause operational problems. Keep a current world backup and note the exact server version, loader, BlueMap release, and Java version before changing the installation.
Install BlueMap on Paper or Spigot
1. Download the matching plugin
From the BlueMap release downloads, choose the plugin whose supported API and Minecraft version include your Paper or Spigot server. Do not use a Fabric, Forge, Sponge, or CLI jar in the plugins directory.
2. Place the jar in the plugins directory
Stop the server, copy the downloaded BlueMap plugin jar into the server’s plugins folder, and start the server again. Installing while the server is running can leave the plugin undiscovered until a restart; a clean stop and start also makes the startup log easier to interpret.
3. Confirm the generated files
On first startup, BlueMap creates its configuration under ./plugins/BlueMap/. If that directory does not appear, inspect the console immediately: the usual first checks are the jar’s platform, the Minecraft compatibility range, and the Java runtime.
4. Edit the configuration
Open the generated files in ./plugins/BlueMap/ with a plain-text editor. Configure the maps and web server deliberately instead of changing unrelated values. Preserve the file format and indentation used by the generated configuration.
5. Reload and render
After saving a configuration change, run /bluemap reload from the server console or an account with the required command permission. You can restart instead, but reloading is quicker for ordinary configuration edits. Start the initial map build with:
/bluemap render <world>
Replace <world> with the actual world folder name known to the server. The command argument is a world identifier, not a descriptive label you invented for the map. Watch the console while the render starts so that a misspelled folder or an unsupported world is visible immediately.
Install BlueMap on Fabric or Forge
1. Select the correct mod jar
Download the BlueMap mod for your loader and Minecraft version. A Fabric jar is not interchangeable with a Forge jar, even when both servers run the same Minecraft release.
2. Install the mod and restart
Stop the server, put the BlueMap mod jar in mods, and start the server. Fabric servers also require the Fabric API mod. If Fabric API is missing, resolve that dependency before diagnosing BlueMap itself.
Rank #3
- The classic UNO card game builds fun on game night with a Minecraft theme.
- UNO Minecraft features a deck and storage tin decorated with graphics from the popular video game.
- Players match colors and numbers to the card on top of the discard pile as in the classic game.
- The Creeper card unique to this deck forces other players to draw 3 cards.
- Makes a great gift for kid, teen, adult and family game nights with 2 to 10 players ages 7 years and older, especially Minecraft and video game fans.
3. Find the generated configuration
Fabric and Forge installations create their BlueMap files under ./config/bluemap/. Sponge uses the same configuration location in the documented setup. A configuration under plugins/BlueMap/ belongs to the Paper/Spigot workflow; editing that directory will not change a Fabric or Forge installation.
4. Configure, reload, and render
Edit the generated files under ./config/bluemap/, then apply them with /bluemap reload or a server restart. Begin the first render using the real world folder name:
Quick wins for a faster PC:
Clear out junk files and repair common Windows errorsFree Scan →Fix the driver behind crashes, sound loss and screen glitchesFind Drivers →/bluemap render <world>
Keep the console visible during this first run. It distinguishes a rendering problem from a web-server problem: a successful render can exist even when the browser endpoint is not yet reachable.
Configure the integrated web server
BlueMap includes a small web server. Its default webroot is ./bluemap/web/, and rendered map data is placed beneath the webroot’s maps/ directory. The web server serves the viewer and those generated map assets; it does not replace your Minecraft game server.
The settings that matter
In webserver.conf, review these four settings:
| Setting | Purpose | Decision to make |
|---|---|---|
enabled |
Turns BlueMap’s HTTP service on or off. | Enable it only when BlueMap should serve the map directly. |
webroot |
Directory containing the viewer files and generated map data. | Keep the default or choose a path your server account can read and write. |
ip |
Network address on which the service listens. | Bind to the interface that should receive requests. |
port |
TCP port used by the HTTP service. | Choose an unused port and allow it through the relevant firewall. |
If ip is omitted, the configuration reference says BlueMap binds to all network interfaces. That can make the map reachable on more addresses than intended, so choose a bind address and firewall rule consciously rather than relying on the default.
Open the map in a browser
Once the web server is enabled, the initial render has completed, and the selected port is reachable, use this documented pattern:
Rank #4
- Now Minecraft lovers can play a special version of UNO!
- Same as Basic UNO but features Minecraft characters and includes special Creeper rule card. Draw this card and the other players have to draw three more cards from the pile!
- The goal is to get rid of all the cards in your hand.
- First player or team to 500 wins.
- When you're down to one card, don't forget to yell "UNO"!
http://<your-server-ip>:<port>/
Use the public address when accessing a remote server, or the server’s local address when testing from the same network. If the browser loads the viewer but shows no world, check whether the render finished and whether the generated files are under the configured webroot’s maps/ directory.
Render the world and keep it current
Initial rendering
The first render creates the map data that the browser needs. Run /bluemap render <world> after configuration, and use the exact world folder name. A world can be valid in Minecraft while still failing BlueMap’s command if the argument names a different directory.
The primary documentation reviewed for this guide does not publish a validated render-time benchmark or a typical storage figure. Render duration and output size therefore depend on the particular world and environment; do not plan maintenance around an invented number.
Changes after the first render
Plugin and mod deployments are attached to the running server, so they are suited to maps that need to be rendered and updated alongside an active Minecraft world. The exact update schedule and map configuration should be controlled through the generated BlueMap files rather than assumed from the initial render alone.
Separating rendering from gameplay
The CLI workflow is better when rendering is a separately managed job. It can read a world without running a Minecraft server, produce the web files, and run its own web server. That separation can simplify a static or scheduled map host, but it also means you must copy or otherwise expose the generated output and maintain the CLI process independently.
Use the standalone BlueMap CLI
The CLI is the option when you only need to render a world and do not want BlueMap installed inside a Minecraft server.
1. Generate the CLI configuration
Place the CLI jar in a directory with access to the world files and run:
The Tool Desk
Outbyte PC Repair FREEClear out junk files and repair common Windows errorsFree Scan →Outbyte Driver Updater FREEFix the driver behind crashes, sound loss and screen glitchesFind Drivers →java -jar BlueMap-cli.jar
The first run generates the configuration files. Read the console output and locate the generated configuration before attempting a render.
2. Allow required Mojang resources
Set accept-download to the value that permits BlueMap to download the required Mojang resources. Without that consent, the CLI cannot obtain resources it needs for the render.
3. Configure maps
Edit the CLI configuration to identify the world and map definitions you want to render. Verify the paths carefully, particularly if the CLI directory is separate from the Minecraft server directory.
4. Render
Start the configured render with:
java -jar BlueMap-cli.jar -r
5. Start the built-in web server
After rendering, start the CLI’s web server with:
Free tools Windows power users keep installed
One-click scans. No signup required.
java -jar BlueMap-cli.jar -w
Then use the address and port defined by the CLI configuration to open the generated map. The CLI’s process, filesystem permissions, firewall exposure, and web endpoint are your responsibility; none of those are automatically supplied by a Paper, Spigot, Fabric, or Forge server.
Independent reader supportYour contribution helps us test, update, and keep practical guides available for everyone.Plugin, mod, or CLI: which deployment fits?
| Consideration | Plugin or mod | Standalone CLI |
|---|---|---|
| Compatibility | Must match the server loader and Minecraft version. | Must match the world and CLI-supported version; it is not tied to a running loader. |
| Live operation | Can render and update while the Minecraft server changes. | Designed for separately managed rendering jobs. |
| Configuration location | ./plugins/BlueMap/ for Paper/Spigot; ./config/bluemap/ for Fabric, Forge, and Sponge. |
Generated beside the CLI installation after its first run. |
| Web delivery | Use the integrated web-server settings, including bind IP and port. | Start the CLI web server with -w and maintain its endpoint separately. |
| Operational overhead | Install one server component, edit generated files, reload, and render. | Maintain a separate Java process, world access, configuration, render job, and web endpoint. |
Choose the plugin or mod when the map belongs to an actively administered Minecraft server. Choose the CLI when the world is rendered outside gameplay or when a separately managed map service is the cleaner operational boundary.
Diagnose a failed installation
BlueMap does not load at startup
- Verify that the jar is for the correct platform: Paper/Spigot plugin, Fabric mod, Forge mod, Sponge-compatible plugin, or CLI.
- Check the jar’s Minecraft compatibility range against the server version.
- Confirm that the Java runtime satisfies the requirement for that BlueMap release. Current documentation lists Java 25 or newer; older documentation listing Java 8 applies to older material.
- For Fabric, confirm that Fabric API is installed.
- Read the server console for BlueMap errors and warnings immediately after restart.
The configuration seems to have no effect
- Check that you edited the directory generated by your deployment:
./plugins/BlueMap/for Paper/Spigot or./config/bluemap/for Fabric, Forge, and Sponge. - Save the file without changing its structure, then run
/bluemap reloador restart the server. - Read the console after reload; syntax or path errors are often reported there.
The render command fails
- Make sure the command is exactly
/bluemap render <world>. - Replace the placeholder with the actual world folder name, including capitalization where the operating system distinguishes it.
- Check that the server or CLI process can read the world files.
- Inspect console output for a missing world, incompatible data, or another BlueMap error before changing web settings.
The browser cannot connect
- Confirm that
enabledis on inwebserver.conf. - Check the configured
ipandport. Ifipis omitted, BlueMap binds to all network interfaces; if it is set to a local-only address, outside clients cannot reach it. - Allow the selected TCP port through the server’s operating-system or hosting firewall.
- Open
http://<your-server-ip>:<port>/, replacing both placeholders with the address and port that BlueMap is actually using. - Read the console for bind errors, especially if another service already occupies the port.
The viewer opens but the map is empty
- Check that the initial render completed rather than merely starting.
- Look under the configured webroot, normally
./bluemap/web/, for the generatedmaps/directory. - Verify that the browser is connecting to the same BlueMap instance whose world you rendered.
- Confirm that the map configuration points to the intended world folder.
Operational checklist
- Java Edition world confirmed; Bedrock source files are not supported.
- BlueMap release, loader, Minecraft version, and Java requirement matched.
- Paper/Spigot jar placed in
plugins, or Fabric/Forge/Sponge component placed inmods. - Fabric API installed when using Fabric.
- Generated configuration directory identified and edited.
webserver.confreviewed forenabled,webroot,ip, andport./bluemap reloadrun after configuration changes./bluemap render <world>run with the actual world folder name.- Firewall and bind address checked.
- Browser opened with
http://<your-server-ip>:<port>/. - Console logs checked after startup, reload, and render.
Final decision
For a live Paper, Spigot, Fabric, Forge, or Sponge server, the reliable path is: install the matching BlueMap component, restart, edit the generated configuration, reload, render the real world name, and expose the integrated web server on a deliberate address and port. For a world that should be rendered independently, initialize the CLI, accept its required resource downloads, configure the maps, run -r, and serve the result with -w. Keeping platform compatibility, configuration location, world naming, and network binding correct resolves most setup failures before they become difficult to diagnose.
Quick Recap
Product prices and availability are accurate as of the date/time indicated and are subject to change. Any price and availability information displayed on Amazon at the time of purchase will apply.
Recommended Free Tools
