Ghid BlueMap: o hartă web 3D pentru serverul tău Minecraft

Ce este BlueMap

BlueMap citește fișierele lumii tale, le randează în plăci de hartă 3D și le servește printr-un mic server web integrat. De aproape vezi blocurile în 3D complet; de departe, o vedere de ansamblu plată. Marcajele live arată unde sunt jucătorii, iar harta se actualizează pe măsură ce lumea se schimbă.

Randează doar lumi Java Edition. Versiunea actuală, BlueMap 5.29, există pentru:

Pentru o versiune mai veche de Minecraft, descarcă o versiune mai veche de BlueMap care o listează. Fiecare versiune de pe Modrinth și Hangar arată ce versiuni suportă.

Instalează BlueMap

1. Descarcă fișierul potrivit serverului tău de pe Modrinth, Hangar sau din release-urile BlueMap de pe GitHub: jar-ul -paper pentru Paper, -fabric pentru Fabric și așa mai departe.
2. Pune-l în folderul plugins (Paper, Spigot) sau mods (Fabric, Forge, NeoForge) și repornește serverul. Încărcarea pluginurilor este explicată în cum instalezi pluginuri Minecraft.
3. BlueMap își creează configurația în plugins/BlueMap/, sau în config/bluemap/ pe serverele cu moduri, cu câte o hartă deja pregătită pentru fiecare lume.

În acest moment consola îți spune că BlueMap așteaptă. Nu va randa nimic până nu accepți descărcarea, care este pasul următor.

Acceptă descărcarea în core.conf

Ca să deseneze blocurile, BlueMap are nevoie de texturile și modelele din clientul Minecraft, pe care le descarcă de la Mojang. Deschide core.conf și modifică:

accept-download: true

Setând asta, accepți EULA Mojang și confirmi că deții Minecraft Java Edition. Salvează fișierul și rulează /bluemap reload sau repornește. BlueMap descarcă resursele și începe randarea.

Dă hărții web un port propriu

Serverul web BlueMap ascultă implicit pe portul 8100. Pe propriul calculator deschizi acel port și accesezi http://your-ip:8100. Pe serverele găzduite de obicei nu poți alege liber un port, așa că folosești unul alocat serverului tău:

1. Obține un al doilea port pentru server. La HytHost, deschide tab-ul Network din panou și adaugă o alocare: panoul alege un port liber și îl deschide pentru tine.
2. Deschide webserver.conf și setează port la acel număr:

   port: 25570

3. Rulează /bluemap reload și deschide http://your-server-ip:25570 în browser.

Nu folosi portul jocului; acela este al Minecraft. Ca să afișezi harta pe propriul domeniu fără număr de port, pune în fața ei un reverse proxy precum nginx; documentația BlueMap are exemple gata făcute.

Comenzile BlueMap

Fiecare comandă are o permisiune de forma bluemap.<command>, de exemplu bluemap.reload. De cele mai multe ori nu ai nevoie de niciuna: BlueMap observă schimbările din lume și le randează singur.

Păstrează randarea ușoară

BlueMap randează în thread-uri de fundal, nu pe thread-ul principal al serverului, dar randarea tot consumă CPU. Prima randare a unei lumi mari este partea grea; după aceea sunt redesenate doar chunk-urile modificate.

• Thread-uri de randare: setează render-thread-count în core.conf. Documentația BlueMap recomandă 1 pe mașinile cu patru nuclee sau mai puține.
• Randează când e liniște: rulează /bluemap stop în orele aglomerate și /bluemap start noaptea, cât timp rulează prima randare.
• Pauză cu jucători online: player-render-limit din plugin.conf oprește randarea când sunt conectați atâția jucători.
• Setează o graniță a lumii. Împiedică harta, și munca de randare, să crească la nesfârșit pe măsură ce jucătorii explorează.
• Îngheață hărțile de care nu ai nevoie live, cum ar fi End-ul după ce a fost explorat.

Stocare: fișiere sau bază de date

Implicit, BlueMap salvează harta ca fișiere comprimate în bluemap/web/maps, în spațiul serverului tău. Harta crește odată cu zona explorată, așa că urmărește spațiul pe disc la o lume mare.

Poți muta în schimb o hartă într-o bază de date. În storages/sql.conf, setează conexiunea la MySQL, MariaDB, PostgreSQL sau SQLite, apoi setează storage: "sql" în fișierul de configurare al hărții și reîncarcă:

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

Paper include un driver MySQL; Spigot, Fabric și Forge au nevoie de un driver JDBC adăugat. Fiecare plan Minecraft HytHost include baze de date MySQL, pe care le creezi în tab-ul Databases din panou.