BlueMap útmutató: 3D webes térkép a Minecraft szerveredhez

Mi az a BlueMap

A BlueMap beolvassa a világfájlokat, 3D térképcsempékké rendereli őket, és egy kis beépített webszerveren keresztül szolgálja ki. Közelről teljes 3D-ben látod a blokkokat, távolról egy lapos áttekintést. Élő jelölők mutatják, hol vannak a játékosok, és a térkép frissül, ahogy a világ változik.

Csak Java Edition világokat renderel. A jelenlegi kiadás, a BlueMap 5.29, a következőkhöz érhető el:

Régebbi Minecraft verzióhoz tölts le egy régebbi BlueMap kiadást, amely támogatja azt. A Modrinthon és a Hangaron minden kiadásnál látszik, mely verziókat támogatja.

A BlueMap telepítése

1. Töltsd le a szerverednek megfelelő fájlt a Modrinthról, a Hangarról vagy a BlueMap GitHub kiadásai közül: Paperhez a -paper jart, Fabrichoz a -fabric változatot, és így tovább.
2. Tedd a plugins mappába (Paper, Spigot) vagy a mods mappába (Fabric, Forge, NeoForge), és indítsd újra a szervert. A pluginok feltöltéséről a Minecraft pluginok telepítése útmutató szól.
3. A BlueMap a konfigurációját a plugins/BlueMap/ mappában hozza létre, moddolt szervereken a config/bluemap/ mappában, és minden világodhoz már be van állítva egy térkép.

Ekkor a konzol jelzi, hogy a BlueMap várakozik. Semmit sem renderel, amíg el nem fogadod a letöltést, ez a következő lépés.

Fogadd el a letöltést a core.conf fájlban

A blokkok megrajzolásához a BlueMapnek szüksége van a Minecraft kliens textúráira és modelljeire, amelyeket a Mojangtól tölt le. Nyisd meg a core.conf fájlt, és módosítsd:

accept-download: true

Ezzel elfogadod a Mojang EULA-ját, és megerősíted, hogy rendelkezel Minecraft Java Editionnel. Mentsd a fájlt, és futtasd a /bluemap reload parancsot, vagy indítsd újra a szervert. A BlueMap letölti az erőforrásokat és elkezdi a renderelést.

Adj saját portot a webes térképnek

A BlueMap webszervere alapértelmezés szerint a 8100-as porton figyel. Saját gépen nyisd meg ezt a portot, és látogasd meg a http://your-ip:8100 címet. Hostolt szervereken általában nem választhatsz szabadon portot, ezért a szerveredhez rendelt portot használod:

1. Szerezz egy második portot a szerverednek. A HytHostnál nyisd meg a panel Network fülét, és adj hozzá egy allokációt: a panel kiválaszt egy szabad portot és megnyitja neked.
2. Nyisd meg a webserver.conf fájlt, és állítsd a port értékét erre a számra:

   port: 25570

3. Futtasd a /bluemap reload parancsot, és nyisd meg a http://your-server-ip:25570 címet egy böngészőben.

Ne használd a játék portját; az a Minecrafté. Ha a térképet a saját domaineden, portszám nélkül szeretnéd megjeleníteni, tegyél elé egy reverse proxyt, például nginxet; a BlueMap dokumentációjában kész példák vannak.

BlueMap parancsok

Minden parancshoz tartozik egy bluemap.<command> formájú jogosultság, például bluemap.reload. Legtöbbször egyikre sincs szükséged: a BlueMap magától észreveszi a világ változásait és rendereli őket.

Tartsd könnyűnek a renderelést

A BlueMap háttérszálakon renderel, nem a szerver fő szálán, de a renderelés így is használja a CPU-t. Egy nagy világ első renderelése a megterhelő rész; utána csak a megváltozott chunkok rajzolódnak újra.

• Renderelő szálak: állítsd be a render-thread-count értékét a core.conf fájlban. A BlueMap dokumentációja legfeljebb négymagos gépeken 1-et javasol.
• Renderelj, amikor csend van: forgalmas órákban futtasd a /bluemap stop, éjjel pedig a /bluemap start parancsot, amíg az első renderelés tart.
• Szünet, ha játékosok vannak fent: a plugin.conf fájlban a player-render-limit leállítja a renderelést, amint ennyi játékos van online.
• Állíts be világhatárt. Így a térkép, és vele a renderelési munka, nem nő a végtelenségig, ahogy a játékosok felfedeznek.
• Fagyaszd le azokat a térképeket, amelyekre élőben nincs szükséged, például az Endet, ha már fel van fedezve.

Tárolás: fájlok vagy adatbázis

Alapértelmezés szerint a BlueMap tömörített fájlokként tárolja a térképet a bluemap/web/maps mappában, a szervered tárhelyén. A térkép a felfedezett területtel együtt nő, ezért nagy világnál figyeld a lemezterületet.

A térképet áthelyezheted adatbázisba is. A storages/sql.conf fájlban állítsd be a kapcsolatot MySQL, MariaDB, PostgreSQL vagy SQLite felé, majd a térkép konfigurációs fájljában állítsd be a storage: "sql" értéket, és töltsd újra:

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

A Paper tartalmaz MySQL drivert; Spigothoz, Fabrichoz és Forge-hoz JDBC drivert kell hozzáadni. Minden HytHost Minecraft csomag tartalmaz MySQL adatbázisokat, amelyeket a panel Databases fülén hozhatsz létre.