Guia de BlueMap: un mapa web en 3D per al teu servidor de Minecraft

Què és BlueMap

BlueMap llegeix els fitxers del món, els renderitza en tessel·les de mapa 3D i els serveix a través d'un petit servidor web integrat. De prop, veus els blocs en 3D complet; de lluny, una vista general plana. Els marcadors en directe mostren on són els jugadors, i el mapa s'actualitza a mesura que el món canvia.

Només renderitza mons de Java Edition. La versió actual, BlueMap 5.29, està disponible per a:

Per a una versió més antiga de Minecraft, descarrega una versió anterior de BlueMap que la inclogui. Cada versió a Modrinth i Hangar indica les versions que admet.

Instal·la BlueMap

1. Descarrega el fitxer que correspon al teu servidor des de Modrinth, Hangar o les versions de BlueMap a GitHub: el jar -paper per a Paper, -fabric per a Fabric, i així successivament.
2. Posa'l a la carpeta plugins (Paper, Spigot) o a la carpeta mods (Fabric, Forge, NeoForge) i reinicia el servidor. Com pujar plugins s'explica a com instal·lar plugins de Minecraft.
3. BlueMap crea la seva configuració a plugins/BlueMap/, o a config/bluemap/ en servidors amb mods, amb un mapa ja preparat per a cadascun dels teus mons.

En aquest punt la consola indica que BlueMap està esperant. No renderitzarà res fins que acceptis la descàrrega, que és el pas següent.

Accepta la descàrrega a core.conf

Per dibuixar els blocs, BlueMap necessita les textures i els models del client de Minecraft, que descarrega de Mojang. Obre core.conf i canvia:

accept-download: true

En fer-ho acceptes l'EULA de Mojang i confirmes que tens Minecraft Java Edition. Desa el fitxer i executa /bluemap reload, o reinicia. BlueMap descarrega els recursos i comença a renderitzar.

Dona al mapa web el seu propi port

El servidor web de BlueMap escolta per defecte al port 8100. A la teva pròpia màquina, obre aquest port i visita http://your-ip:8100. En servidors allotjats normalment no pots triar lliurement un port, així que utilitzes un que estigui assignat al teu servidor:

1. Aconsegueix un segon port per al teu servidor. A HytHost, obre la pestanya Network del panell i afegeix una assignació: el panell tria un port lliure i te l'obre.
2. Obre webserver.conf i posa port a aquest número:

   port: 25570

3. Executa /bluemap reload i obre http://your-server-ip:25570 en un navegador.

No facis servir el port del joc; és el de Minecraft. Per mostrar el mapa al teu propi domini sense número de port, posa-hi davant un reverse proxy com nginx; la documentació de BlueMap té exemples preparats.

Ordres de BlueMap

Cada ordre té un permís de la forma bluemap.<command>, per exemple bluemap.reload. La major part del temps no en necessites cap: BlueMap detecta els canvis al món i els renderitza pel seu compte.

Mantén lleuger el renderitzat

BlueMap renderitza en fils en segon pla, no al fil principal del servidor, però el renderitzat igualment consumeix CPU. El primer renderitzat d'un món gran és la part pesada; després, només es tornen a dibuixar els chunks que han canviat.

• Fils de renderitzat: configura render-thread-count a core.conf. La documentació de BlueMap suggereix 1 en màquines amb quatre nuclis o menys.
• Renderitza quan hi hagi calma: executa /bluemap stop a les hores de més activitat i /bluemap start a la nit mentre dura el primer renderitzat.
• Pausa amb jugadors connectats: player-render-limit a plugin.conf atura el renderitzat quan hi ha aquest nombre de jugadors connectats.
• Defineix un límit del món. Evita que el mapa, i la feina de renderitzat, creixin sense fi a mesura que els jugadors exploren.
• Congela els mapes que no necessitis en directe, com l'End un cop explorat.

Emmagatzematge: fitxers o base de dades

Per defecte BlueMap desa el mapa com a fitxers comprimits a bluemap/web/maps, dins de l'emmagatzematge del teu servidor. El mapa creix amb la zona explorada, així que vigila l'espai en disc en un món gran.

També pots moure un mapa a una base de dades. A storages/sql.conf, configura la connexió a MySQL, MariaDB, PostgreSQL o SQLite, després posa storage: "sql" al fitxer de configuració del mapa i torna a carregar:

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

Paper inclou un controlador de MySQL; Spigot, Fabric i Forge necessiten que hi afegeixis un controlador JDBC. Tots els plans de Minecraft de HytHost inclouen bases de dades MySQL, que crees a la pestanya Databases del panell.