Minecraft-plugin BlueMap

🔌 Om BlueMap

BlueMap är ett Minecraft-kartverktyg som läser serverns världsfiler och genererar 3D-modeller och en interaktiv webbvisare. Det kan köras som en serverplugin eller mod (Spigot/Paper- eller Sponge-plugin, Fabric/Forge-mod) eller som en fristående command-line-renderare. När BlueMap installeras på en server som redan körs renderar det asynkront, så att serverns huvudtråd inte blockeras.

🎯 Syfte

BlueMap ger en webbläsartillgänglig, tredimensionell representation av en Minecraft-värld så att administratörer och spelare kan utforska terrängen, hitta strukturer och granska byggen utan att ansluta till servern. Det är riktat till serveroperatörer som behöver en uppdaterad visuell karta för administration, navigering eller presentation för communityn.

⚙️ Funktioner

• Genererar 3D-modeller av världens yta och visar dem i en webbaserad webbvisare.
• Körs som plugin/mod (Spigot/Paper, Sponge, Fabric, Forge) eller som ett fristående CLI-verktyg.
• Asynkron rendering för att undvika att blockera Minecraft serverns huvudtråd.
• Stöd för resource packs och data packs för att anpassa texturer, blockmodeller och biomfärger som används i renderingar.
• Stöd för flera lagringsbackends och karthantering via kommandon (load, unload, list, delete, osv.).
• Stöd för markörer och ett API så att tredjepartsplugins kan lägga till eller hantera markörer på kartor.
• Kommandon för runtime-reload och kontroll av rendering (reload, starta/stoppa rendering, uppdatera/rensa kartor, frysa/avfrysa kartor).

🧩 För vem är det

• Survival- och SMP-servrar som vill ha en offentlig eller adminriktad 3D-karta.
• Creative- eller showcase-servrar som behöver förhandsvisningar av byggen som kan nås i webbläsaren.
• Serveradministratörer som behöver fjärrinspektion och kartbaserade navigeringsverktyg.

🏗️ Exempel på användning

• Ge spelare en offentligt hostad 3D-karta av världen för att underlätta navigering och visa upp byggen.
• En admin letar upp och granskar player-built bases eller claims från webbvisaren innan hen besöker dem i spelet.
• Ett plugin använder BlueMap's API för att visa dynamiska markörer för events, butiker eller teleportplatser.

⌨️ Kommandon

(Alla kommandon ovan är dokumenterade av projektet; exakta permission nodes finns i projektets dokumentation och upprepas inte här.)

⚙️ Installation

📥 Installation

• Ladda ner rätt BlueMap JAR för din plattform (plugin JAR för Spigot/Paper/Sponge, mod JAR för Fabric/Forge eller en fristående CLI-distribution).
• Placera JAR-filen i serverns plugins/-mapp (för Spigot/Paper/Sponge) eller i mods/-mappen (för Fabric/Forge), eller använd CLI-distributionsfilerna för fristående rendering.
• Starta eller starta om servern. Kontrollera serverkonsolen för att bekräfta att BlueMap och dess inbyggda webbserver startade korrekt.

📦 Beroenden

• Inga obligatoriska externa plugin-beroenden krävs för kärnrenderingen av kartan. Valfria integrationer och tillägg finns; se projektets dokumentation för information om tredjepartsadd-ons.

🧠 Tekniska anteckningar

• BlueMap distribueras som serverplugins, mods och ett CLI-verktyg; välj det artefakt som matchar din setup.
• Rendering utförs asynkront för att undvika att blockera serverns huvudtråd.
• Resource packs och data packs kan placeras i den konfigurerade pack-katalogen för att ändra kartans utseende.
• Projektet har ett offentligt källkodsförråd och release-byggnader; konfigurationen är filbaserad och kan laddas om vid runtime.

🤝 När detta plugin är användbart

Om du behöver en webbläsartillgänglig, tredimensionell vy av din Minecraft-värld för navigering, granskning av byggen eller visning för communityn, erbjuder BlueMap automatisk rendering, runtime-kontroll och ett API för markörer och integrationer utan att spelare behöver ansluta till servern.