Minecraft plugin BlueMap

🔌 O BlueMap

BlueMap je nástroj pro mapování Minecraftu, který čte soubory světa serveru a generuje 3D modely a interaktivní webový prohlížeč mapy. Může běžet jako serverový plugin nebo mod (plugin Spigot/Paper nebo Sponge, mod Fabric/Forge) nebo jako samostatný CLI renderer. Pokud je nainstalovaný na běžícím serveru, vykresluje asynchronně, takže neblokuje hlavní serverové vlákno.

🎯 Účel

BlueMap poskytuje z prohlížeče přístupné trojrozměrné zobrazení světa Minecraftu, aby administrátoři a hráči mohli prozkoumávat terén, vyhledávat struktury a kontrolovat stavby bez připojení na server. Je určený pro provozovatele serverů, kteří potřebují aktuální vizuální mapu pro administraci, navigaci nebo prezentaci komunitě.

⚙️ Funkce

• Generuje 3D modely povrchu světa a zobrazuje je ve webovém prohlížeči.
• Běží jako plugin/mod (Spigot/Paper, Sponge, Fabric, Forge) nebo jako samostatný CLI nástroj.
• Asynchronní vykreslování, aby neblokovalo hlavní serverové vlákno Minecraft server.
• Podporuje resource packy a data packy pro úpravu textur, modelů bloků a barev biomů používaných při renderu.
• Podporuje více storage backendů a správu map pomocí příkazů (load, unload, list, delete atd.).
• Podpora markerů a API, aby mohly pluginy třetích stran přidávat nebo spravovat markery na mapách.
• Příkazy pro reload za běhu a řízení renderu (reload, spuštění/zastavení renderování, update/purge map, freeze/unfreeze map).

🧩 Pro koho je určený

• Servery Survival a SMP, které chtějí veřejnou nebo administrátorskou 3D mapu.
• Servery Creative nebo showcase, které potřebují náhledy staveb přístupné v prohlížeči.
• Správci serverů, kteří potřebují vzdálenou kontrolu a nástroje pro navigaci podle mapy.

🏗️ Příklady použití

• Poskytnout hráčům veřejně hostovanou 3D mapu světa pro usnadnění navigace a prezentaci staveb.
• Admin vyhledá a zkontroluje player-built base nebo claimy ve webovém prohlížeči ještě před návštěvou ve hře.
• Plugin používá API BlueMap k zobrazení dynamických markerů pro události, obchody nebo teleport místa.

⌨️ Příkazy

(Všechny výše uvedené příkazy jsou zdokumentované projektem; přesné permission nodes jsou uvedeny v dokumentaci projektu a zde se neopakují.)

⚙️ Instalace

📥 Nastavení

• Stáhněte příslušný BlueMap JAR pro vaši platformu (plugin JAR pro Spigot/Paper/Sponge, mod JAR pro Fabric/Forge nebo samostatnou CLI distribuci).
• Umístěte JAR do složky serveru plugins/ (pro Spigot/Paper/Sponge) nebo do složky mods/ (pro Fabric/Forge), případně použijte soubory CLI distribuce pro samostatné renderování.
• Spusťte nebo restartujte server. Sledujte konzoli serveru, abyste ověřili, že BlueMap a jeho встроенный webový server byly úspěšně spuštěny.

📦 Závislosti

• Pro základní vykreslování mapy nejsou potřeba žádné povinné externí pluginové závislosti. K dispozici jsou volitelné integrace a doplňky; informace o addon ech třetích stran najdete v dokumentaci projektu.

🧠 Technické poznámky

• BlueMap se distribuuje jako serverové pluginy, mody a CLI nástroj; vyberte artefakt odpovídající vašemu nastavení.
• Renderování probíhá asynchronně, aby neblokovalo hlavní serverové vlákno.
• Resource packy a data packy lze umístit do nakonfigurovaného adresáře balíčků a změnit tak vzhled mapy.
• Projekt udržuje veřejné zdrojové úložiště a release buildy; konfigurace je souborová a lze ji za běhu znovu načíst.

🤝 Kdy je tento plugin užitečný

Pokud potřebujete z prohlížeče přístupný trojrozměrný pohled na svůj Minecraft svět pro navigaci, kontrolu staveb nebo prezentaci komunitě, BlueMap nabízí automatické renderování, řízení za běhu a API pro markery i integrace, aniž by hráči museli vstupovat na server.