Návod na BlueMap: 3D webová mapa pro váš Minecraft server

Co je BlueMap

BlueMap čte soubory vašeho světa, vykresluje z nich 3D dlaždice mapy a poskytuje je přes malý vestavěný webový server. Při přiblížení vidíte bloky v plném 3D, při oddálení plochý přehled. Živé značky ukazují, kde jsou hráči, a mapa se aktualizuje, jak se svět mění.

Vykresluje pouze světy Java Edition. Aktuální vydání, BlueMap 5.29, existuje ve verzích pro:

Pro starší verzi Minecraftu si stáhněte starší vydání BlueMap, které ji uvádí. Každé vydání na Modrinthu a Hangaru ukazuje, které verze podporuje.

Instalace BlueMap

1. Stáhněte soubor odpovídající vašemu serveru z Modrinth, Hangar nebo z vydání BlueMap na GitHubu: jar -paper pro Paper, -fabric pro Fabric a tak dále.
2. Vložte ho do složky plugins (Paper, Spigot) nebo mods (Fabric, Forge, NeoForge) a restartujte server. Nahrávání pluginů popisuje návod jak nainstalovat pluginy do Minecraftu.
3. BlueMap vytvoří svou konfiguraci v plugins/BlueMap/, na modovaných serverech v config/bluemap/, a mapa pro každý z vašich světů už je připravená.

V tuto chvíli vám konzole oznámí, že BlueMap čeká. Nic nevykreslí, dokud nepovolíte stahování, což je další krok.

Povolení stahování v core.conf

Aby BlueMap mohl kreslit bloky, potřebuje textury a modely z klienta Minecraftu, které stahuje od Mojangu. Otevřete core.conf a změňte:

accept-download: true

Tímto nastavením přijímáte EULA Mojangu a potvrzujete, že vlastníte Minecraft Java Edition. Uložte soubor a spusťte /bluemap reload, nebo server restartujte. BlueMap stáhne potřebná data a začne vykreslovat.

Vlastní port pro webovou mapu

Webový server BlueMap ve výchozím stavu naslouchá na portu 8100. Na vlastním stroji ten port otevřete a navštivte http://your-ip:8100. Na hostovaných serverech si obvykle port nemůžete zvolit libovolně, takže použijete ten, který je přidělen vašemu serveru:

1. Získejte pro server druhý port. Na HytHost otevřete v panelu záložku Network a přidejte alokaci: panel vybere volný port a otevře ho za vás.
2. Otevřete webserver.conf a nastavte port na toto číslo:

   port: 25570

3. Spusťte /bluemap reload a otevřete v prohlížeči http://your-server-ip:25570.

Nepoužívejte herní port, ten patří Minecraftu. Chcete-li mapu zobrazit na vlastní doméně bez čísla portu, postavte před ni reverzní proxy, například nginx; dokumentace BlueMap obsahuje hotové příklady.

Příkazy BlueMap

Každý příkaz má oprávnění ve tvaru bluemap.<command>, například bluemap.reload. Většinou žádný z nich nepotřebujete: BlueMap si změn ve světě všimne a vykreslí je sám.

Nenáročné vykreslování

BlueMap vykresluje ve vláknech na pozadí, ne v hlavním vlákně serveru, ale vykreslování přesto zatěžuje CPU. Náročné je hlavně první vykreslení velkého světa; potom se překreslují jen změněné chunky.

• Vlákna pro vykreslování: nastavte render-thread-count v core.conf. Dokumentace BlueMap doporučuje 1 na strojích se čtyřmi nebo méně jádry.
• Vykreslujte, když je klid: ve špičce spusťte /bluemap stop a v noci /bluemap start, dokud běží první vykreslení.
• Pauza při hráčích online: player-render-limit v plugin.conf zastaví vykreslování, jakmile je připojeno tolik hráčů.
• Nastavte hranici světa. Zabrání tomu, aby mapa i práce s vykreslováním donekonečna rostly, jak hráči prozkoumávají.
• Zmrazte mapy, které nepotřebujete živé, například End, jakmile je prozkoumaný.

Úložiště: soubory nebo databáze

Ve výchozím stavu BlueMap ukládá mapu jako komprimované soubory v bluemap/web/maps v úložišti vašeho serveru. Mapa roste s prozkoumanou oblastí, takže u velkého světa hlídejte místo na disku.

Mapu můžete místo toho přesunout do databáze. V storages/sql.conf nastavte připojení k MySQL, MariaDB, PostgreSQL nebo SQLite, pak v konfiguračním souboru mapy nastavte storage: "sql" a načtěte konfiguraci znovu:

connection-url: "jdbc:mysql://DB_HOST:3306/DB_NAME"
connection-properties: {
    user: "DB_USER",
    password: "DB_PASSWORD"
}

Paper obsahuje ovladač pro MySQL; Spigot, Fabric a Forge potřebují doplnit ovladač JDBC. Každý Minecraft tarif od HytHost zahrnuje databáze MySQL, které vytvoříte v záložce Databases v panelu.