BlueMap vodič: 3D web karta za vaš Minecraft server

Što je BlueMap

BlueMap čita datoteke vašeg svijeta, renderira ih u 3D pločice karte i poslužuje ih kroz mali ugrađeni web server. Kad zumirate, vidite blokove u punom 3D-u; kad odzumirate, ravan pregled. Oznake uživo pokazuju gdje su igrači, a karta se ažurira kako se svijet mijenja.

Renderira samo svjetove iz Java Edition. Trenutačno izdanje, BlueMap 5.29, dolazi u verzijama za:

Za stariju verziju Minecrafta preuzmite starije izdanje BlueMapa koje je navodi. Svako izdanje na Modrinthu i Hangaru prikazuje verzije koje podržava.

Instalacija BlueMapa

1. Preuzmite datoteku koja odgovara vašem serveru s Modrintha, Hangara ili iz BlueMap izdanja na GitHubu: -paper jar za Paper, -fabric za Fabric i tako dalje.
2. Stavite je u mapu plugins (Paper, Spigot) ili mapu mods (Fabric, Forge, NeoForge) i ponovno pokrenite server. Prijenos pluginova objašnjen je u vodiču kako instalirati Minecraft pluginove.
3. BlueMap stvara svoju konfiguraciju u plugins/BlueMap/, odnosno config/bluemap/ na modanim serverima, s već postavljenom kartom za svaki vaš svijet.

U ovom trenutku konzola javlja da BlueMap čeka. Neće ništa renderirati dok ne prihvatite preuzimanje, što je sljedeći korak.

Prihvatite preuzimanje u core.conf

Za crtanje blokova BlueMap treba teksture i modele iz Minecraft klijenta, koje preuzima od Mojanga. Otvorite core.conf i promijenite:

accept-download: true

Time prihvaćate Mojangov EULA i potvrđujete da posjedujete Minecraft Java Edition. Spremite datoteku i pokrenite /bluemap reload ili ponovno pokrenite server. BlueMap preuzima resurse i počinje renderirati.

Dajte web karti vlastiti port

Web server BlueMapa prema zadanim postavkama sluša na portu 8100. Na vlastitom računalu otvorite taj port i posjetite http://your-ip:8100. Na hostanim serverima obično ne možete slobodno birati port, pa koristite onaj koji je dodijeljen vašem serveru:

1. Nabavite drugi port za svoj server. Na HytHostu otvorite karticu Network u panelu i dodajte alokaciju: panel bira slobodan port i otvara ga za vas.
2. Otvorite webserver.conf i postavite port na taj broj:

   port: 25570

3. Pokrenite /bluemap reload i otvorite http://your-server-ip:25570 u pregledniku.

Ne koristite port igre; on pripada Minecraftu. Ako želite prikazati kartu na vlastitoj domeni bez broja porta, postavite ispred nje reverse proxy poput nginxa; dokumentacija BlueMapa ima gotove primjere.

BlueMap naredbe

Svaka naredba ima dopuštenje oblika bluemap.<command>, na primjer bluemap.reload. Većinu vremena ne trebate nijednu: BlueMap sam primjećuje promjene u svijetu i renderira ih.

Neka renderiranje bude lagano

BlueMap renderira u pozadinskim nitima, ne na glavnoj niti servera, ali renderiranje ipak troši CPU. Prvo renderiranje velikog svijeta je zahtjevni dio; nakon toga ponovno se crtaju samo promijenjeni chunkovi.

• Niti za renderiranje: postavite render-thread-count u core.conf. Dokumentacija BlueMapa preporučuje 1 na računalima s četiri jezgre ili manje.
• Renderirajte kad je mirno: pokrenite /bluemap stop u prometnim satima i /bluemap start noću dok traje prvo renderiranje.
• Pauza dok su igrači online: player-render-limit u plugin.conf zaustavlja renderiranje čim je online toliko igrača.
• Postavite granicu svijeta. Tako karta, a s njom i posao renderiranja, ne raste beskonačno dok igrači istražuju.
• Zamrznite karte koje ne trebate uživo, na primjer End nakon što je istražen.

Pohrana: datoteke ili baza podataka

Prema zadanim postavkama BlueMap sprema kartu kao komprimirane datoteke u bluemap/web/maps, unutar pohrane vašeg servera. Karta raste s istraženim područjem, pa na velikom svijetu pratite prostor na disku.

Kartu možete umjesto toga premjestiti u bazu podataka. U storages/sql.conf postavite vezu na MySQL, MariaDB, PostgreSQL ili SQLite, zatim u konfiguracijskoj datoteci karte postavite storage: "sql" i ponovno učitajte:

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

Paper dolazi s MySQL driverom; za Spigot, Fabric i Forge treba dodati JDBC driver. Svaki HytHost Minecraft paket uključuje MySQL baze podataka, koje stvarate u kartici Databases u panelu.