Minecraft-plugin BlueMap

🔌 Om BlueMap

BlueMap er et Minecraft-kortlægningsværktøj, der læser serverens verdensfiler og genererer 3D-modeller og en interaktiv webvisning. Det kan køre som et server-plugin eller mod (Spigot/Paper- eller Sponge-plugin, Fabric/Forge-mod) eller som en selvstændig command-line renderer. Når BlueMap installeres på en server, der allerede kører, renderer det asynkront, så serverens hovedtråd ikke blokeres.

🎯 Formål

BlueMap giver en browsertilgængelig, tredimensionel repræsentation af en Minecraft-verden, så administratorer og spillere kan udforske terræn, finde strukturer og inspicere byggerier uden at gå på serveren. Det er målrettet serveroperatører, som har brug for et opdateret visuelt kort til administration, navigation eller fremvisning til fællesskabet.

⚙️ Funktioner

• Genererer 3D-modeller af verdens overflade og viser dem i en browserbaseret webvisning.
• Kører som plugin/mod (Spigot/Paper, Sponge, Fabric, Forge) eller som et selvstændigt CLI-værktøj.
• Asynkron rendering for at undgå at blokere Minecraft serverens hovedtråd.
• Understøtter resource packs og data packs til at tilpasse teksturer, blokmodeller og biomfarver, der bruges i rendering.
• Understøtter flere storage backends og kortstyring via kommandoer (load, unload, list, delete osv.).
• Understøttelse af markers og en API, så tredjepartsplugins kan tilføje eller administrere markers på kort.
• Runtime reload- og renderkontrolkommandoer (reload, start/stop rendering, update/purge kort, freeze/unfreeze kort).

🧩 Hvem er det til

• Survival- og SMP-servere, der vil have et offentligt eller adminvendt 3D-kort.
• Creative- eller showcase-servere, der har brug for forhåndsvisninger af builds, som kan tilgås i browseren.
• Serveradministratorer, der har brug for fjerninspektion og kortbaserede navigationsværktøjer.

🏗️ Eksempler på brug

• Giv spillere et offentligt hostet 3D-kort over verdenen, så navigation bliver lettere, og builds kan fremvises.
• En admin finder og gennemgår player-built bases eller claims fra webvisningen, før de besøges i spillet.
• Et plugin bruger BlueMap's API til at vise dynamiske markers for events, butikker eller teleportlokationer.

⌨️ Kommandoer

(Alle kommandoerne ovenfor er dokumenteret af projektet; de præcise permission nodes findes i projektets dokumentation og gentages ikke her.)

⚙️ Installation

📥 Opsætning

• Download den passende BlueMap JAR til din platform (plugin JAR til Spigot/Paper/Sponge, mod JAR til Fabric/Forge eller en selvstændig CLI-distribution).
• Læg JAR-filen i serverens plugins/-mappe (for Spigot/Paper/Sponge) eller mods/-mappe (for Fabric/Forge), eller brug CLI-distributionsfilerne til selvstændig rendering.
• Start eller genstart serveren. Hold øje med serverkonsollen for at bekræfte, at BlueMap og dens indbyggede webserver er startet korrekt.

📦 Afhængigheder

• Der kræves ingen obligatoriske eksterne plugin-afhængigheder til den centrale kortrendering. Der findes valgfrie integrationer og add-ons; se projektets dokumentation for information om tredjeparts-add-ons.

🧠 Tekniske noter

• BlueMap distribueres som serverplugins, mods og et CLI-værktøj; vælg det artefakt, der passer til din opsætning.
• Rendering udføres asynkront for at undgå at blokere serverens hovedtråd.
• Resource packs og data packs kan placeres i den konfigurerede pack-mappe for at ændre kortets udseende.
• Projektet har et offentligt kildearkiv og release-builds; konfigurationen er filbaseret og kan genindlæses under kørsel.

🤝 Hvornår er dette plugin nyttigt

Hvis du har brug for en browsertilgængelig, tredimensionel visning af din Minecraft-verden til navigation, gennemsyn af bygninger eller visning for fællesskabet, tilbyder BlueMap automatisk rendering, runtime-kontrol og en API til markers og integrationer uden at kræve, at spillere logger på serveren.