BlueMapi juhend: 3D-veebikaart sinu Minecrafti serverile

Mis on BlueMap

BlueMap loeb su maailmafaile, renderdab need 3D-kaardiplaatideks ja jagab neid väikese sisseehitatud veebiserveri kaudu. Sisse suumides näed plokke täielikus 3D-s, välja suumides lamedat ülevaadet. Reaalajas markerid näitavad, kus mängijad on, ja kaart uueneb koos maailma muutumisega.

See renderdab ainult Java Edition maailmu. Praegune väljalase, BlueMap 5.29, on saadaval järgmistele:

Vanema Minecrafti versiooni jaoks laadi alla vanem BlueMapi väljalase, mis seda versiooni toetab. Iga väljalase Modrinthis ja Hangaris näitab, milliseid versioone see toetab.

BlueMapi paigaldamine

1. Laadi oma serverile sobiv fail alla Modrinthist, Hangarist või BlueMapi GitHubi väljalasetest: Paperile -paper jar, Fabricule -fabric ja nii edasi.
2. Pane see kausta plugins (Paper, Spigot) või kausta mods (Fabric, Forge, NeoForge) ja taaskäivita server. Pluginate üleslaadimist kirjeldab juhend kuidas paigaldada Minecrafti pluginaid.
3. BlueMap loob oma seadistuse kausta plugins/BlueMap/ või modditud serverites kausta config/bluemap/, kus iga su maailma jaoks on kaart juba valmis seadistatud.

Nüüd teatab konsool, et BlueMap ootab. See ei renderda midagi enne, kui oled allalaadimisega nõustunud, ja see on järgmine samm.

Nõustu allalaadimisega failis core.conf

Plokkide joonistamiseks vajab BlueMap Minecrafti kliendi tekstuure ja mudeleid, mille see laadib alla Mojangilt. Ava core.conf ja muuda:

accept-download: true

Selle seadega nõustud Mojangi EULA-ga ja kinnitad, et omad Minecraft Java Editionit. Salvesta fail ja käivita /bluemap reload või taaskäivita server. BlueMap laadib ressursid alla ja hakkab renderdama.

Anna veebikaardile oma port

BlueMapi veebiserver kuulab vaikimisi porti 8100. Oma masinas ava see port ja mine aadressile http://your-ip:8100. Majutatud serverites ei saa porti tavaliselt vabalt valida, seega kasutad serverile määratud porti:

1. Hangi serverile teine port. HytHostis ava paneelis vahekaart Network ja lisa eraldus: paneel valib vaba pordi ja avab selle sinu eest.
2. Ava webserver.conf ja määra port sellele numbrile:

   port: 25570

3. Käivita /bluemap reload ja ava brauseris http://your-server-ip:25570.

Ära kasuta mänguporti, see kuulub Minecraftile. Kui tahad kaarti näidata oma domeenil ilma pordinumbrita, pane selle ette pöördpuhverserver (reverse proxy), näiteks nginx; BlueMapi dokumentatsioonis on valmis näited.

BlueMapi käsud

Igal käsul on õigus kujul bluemap.<command>, näiteks bluemap.reload. Enamasti ei vaja sa ühtegi neist: BlueMap märkab maailma muudatusi ja renderdab need ise.

Hoia renderdamine kerge

BlueMap renderdab taustalõimedes, mitte serveri põhilõimes, kuid renderdamine kasutab siiski CPU-d. Raske osa on suure maailma esimene renderdus; pärast seda joonistatakse uuesti ainult muutunud chunkid.

• Renderduslõimed: määra render-thread-count failis core.conf. BlueMapi dokumentatsioon soovitab väärtust 1 masinatel, millel on neli tuuma või vähem.
• Renderda, kui on vaikne: käivita tipptundidel /bluemap stop ja öösel /bluemap start, kuni esimene renderdus käib.
• Paus, kui mängijad on võrgus: player-render-limit failis plugin.conf peatab renderdamise, kui nii palju mängijaid on sees.
• Sea maailmale piir (world border). See hoiab kaardi ja renderdustöö lõputult kasvamast, kui mängijad avastavad.
• Külmuta kaardid, mida sa reaalajas ei vaja, näiteks End, kui see on avastatud.

Salvestus: failid või andmebaas

Vaikimisi salvestab BlueMap kaardi tihendatud failidena kausta bluemap/web/maps sinu serveri salvestusruumis. Kaart kasvab koos avastatud alaga, seega jälgi suure maailma puhul kettaruumi.

Kaardi saab hoopis andmebaasi viia. Failis storages/sql.conf seadista ühendus MySQL-i, MariaDB, PostgreSQL-i või SQLite'iga, seejärel määra kaardi seadistusfailis storage: "sql" ja laadi uuesti:

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

Paperiga on MySQL-i draiver kaasas; Spigot, Fabric ja Forge vajavad lisatud JDBC draiverit. Iga HytHosti Minecrafti pakett sisaldab MySQL-i andmebaase, mille lood paneeli vahekaardil Databases.