Minecraft plugin BlueMap

🔌 Over BlueMap

BlueMap is een Minecraft-mappingtool die serverwereldbestanden leest en 3D-modellen en een interactieve webviewer genereert. Het kan draaien als serverplugin of mod (Spigot/Paper- of Sponge-plugin, Fabric/Forge-mod) of als een zelfstandige command-line renderer. Wanneer BlueMap op een draaiende server wordt geïnstalleerd, rendert het asynchroon, zodat de hoofdthread van de server niet wordt geblokkeerd.

🎯 Doel

BlueMap biedt een via de browser toegankelijke, driedimensionale weergave van een Minecraft-wereld, zodat beheerders en spelers terrein kunnen verkennen, structuren kunnen vinden en builds kunnen bekijken zonder op de server in te loggen. Het is bedoeld voor serverbeheerders die een actuele visuele kaart nodig hebben voor beheer, navigatie of presentatiedoeleinden voor de community.

⚙️ Functies

• Genereert 3D-modellen van het wereldoppervlak en toont die in een op de browser gebaseerde webviewer.
• Draait als plugin/mod (Spigot/Paper, Sponge, Fabric, Forge) of als zelfstandige CLI-tool.
• Asynchrone rendering om de Minecraft server-thread niet te blokkeren.
• Ondersteunt resource packs en data packs om texturen, blokmodellen en biomekleuren die in renders worden gebruikt aan te passen.
• Ondersteunt meerdere opslagback-ends en mapbeheer via commando's (load, unload, list, delete, enz.).
• Ondersteuning voor markers en een API waarmee externe plugins markers op maps kunnen toevoegen of beheren.
• Runtime reload- en renderbesturingscommando's (reload, rendering starten/stoppen, maps updaten/purgen, maps freeze/unfreeze).

🧩 Voor wie is het

• Survival- en SMP-servers die een openbare of voor admins zichtbare 3D-kaart willen.
• Creative- of showcase-servers die previews van builds nodig hebben die via de browser toegankelijk zijn.
• Serverbeheerders die hulpmiddelen nodig hebben voor inspectie op afstand en navigatie op basis van maps.

🏗️ Voorbeeldtoepassingen

• Spelers een openbaar gehoste 3D-kaart van de wereld geven om navigatie te helpen en builds te tonen.
• Een admin zoekt player-built bases of claims op en bekijkt ze via de webviewer voordat hij ze in-game bezoekt.
• Een plugin gebruikt BlueMap's API om dynamische markers te tonen voor events, winkels of teleportlocaties.

⌨️ Commando's

(Alle bovenstaande commando's worden door het project gedocumenteerd; de exacte permissienodes staan in de documentatie van het project en worden hier niet herhaald.)

⚙️ Installatie

📥 Installatie

• Download de juiste BlueMap JAR voor jouw platform (plugin-JAR voor Spigot/Paper/Sponge, mod-JAR voor Fabric/Forge of een zelfstandige CLI-distributie).
• Plaats de JAR in de plugins/-map van de server (voor Spigot/Paper/Sponge) of in de mods/-map (voor Fabric/Forge), of gebruik de CLI-distributiebestanden voor zelfstandige rendering.
• Start of herstart de server. Controleer de serverconsole om te bevestigen dat BlueMap en de ingebouwde webserver succesvol zijn gestart.

📦 Afhankelijkheden

• Er zijn geen verplichte externe plugin-afhankelijkheden nodig voor de kern van de maprendering. Optionele integraties en add-ons zijn beschikbaar; raadpleeg de documentatie van het project voor informatie over add-ons van derden.

🧠 Technische notities

• BlueMap wordt geleverd als serverplugins, mods en een CLI-tool; kies het artefact dat past bij jouw setup.
• Rendering gebeurt asynchroon om de hoofdthread van de server niet te blokkeren.
• Resource packs en data packs kunnen in de geconfigureerde packs-map worden geplaatst om het uiterlijk van de map te veranderen.
• Het project onderhoudt een openbare source repository en release-builds; de configuratie is op bestanden gebaseerd en kan tijdens runtime worden herladen.

🤝 Wanneer deze plugin nuttig is

Als je een via de browser toegankelijke, driedimensionale weergave van je Minecraft-wereld nodig hebt voor navigatie, het beoordelen van builds of het tonen aan de community, biedt BlueMap geautomatiseerde rendering, runtime-besturing en een API voor markers en integraties zonder dat spelers op de server hoeven in te loggen.