Guía de BlueMap: un mapa web 3D para tu servidor de Minecraft

Qué es BlueMap

BlueMap lee los archivos de tu mundo, los renderiza en teselas de mapa 3D y las sirve a través de un pequeño servidor web integrado. Con zoom cercano ves los bloques en 3D completo; al alejarte, una vista general plana. Los marcadores en vivo muestran dónde están los jugadores y el mapa se actualiza a medida que cambia el mundo.

Solo renderiza mundos de Java Edition. La versión actual, BlueMap 5.29, está disponible para:

Para una versión más antigua de Minecraft, descarga una versión anterior de BlueMap que la incluya. Cada versión en Modrinth y Hangar indica las versiones que admite.

Instalar BlueMap

1. Descarga el archivo que corresponda a tu servidor desde Modrinth, Hangar o las releases de BlueMap en GitHub: el jar -paper para Paper, -fabric para Fabric, etc.
2. Colócalo en la carpeta plugins (Paper, Spigot) o en la carpeta mods (Fabric, Forge, NeoForge) y reinicia el servidor. Cómo subir plugins se explica en cómo instalar plugins de Minecraft.
3. BlueMap crea su configuración en plugins/BlueMap/, o en config/bluemap/ en servidores con mods, con un mapa ya preparado para cada uno de tus mundos.

En este punto la consola te indica que BlueMap está esperando. No renderizará nada hasta que aceptes la descarga, que es el siguiente paso.

Aceptar la descarga en core.conf

Para dibujar los bloques, BlueMap necesita las texturas y los modelos del cliente de Minecraft, que descarga de Mojang. Abre core.conf y cambia:

accept-download: true

Al activarlo aceptas el EULA de Mojang y confirmas que tienes Minecraft Java Edition. Guarda el archivo y ejecuta /bluemap reload, o reinicia. BlueMap descarga los recursos y empieza a renderizar.

Dar al mapa web su propio puerto

El servidor web de BlueMap escucha por defecto en el puerto 8100. En tu propia máquina, abre ese puerto y visita http://your-ip:8100. En servidores alojados normalmente no puedes elegir un puerto libremente, así que usas uno asignado a tu servidor:

1. Consigue un segundo puerto para tu servidor. En HytHost, abre la pestaña Network del panel y añade una asignación: el panel elige un puerto libre y lo abre por ti.
2. Abre webserver.conf y pon ese número en port:

   port: 25570

3. Ejecuta /bluemap reload y abre http://your-server-ip:25570 en un navegador.

No uses el puerto del juego; ese es de Minecraft. Para mostrar el mapa en tu propio dominio sin número de puerto, pon delante un proxy inverso como nginx; la documentación de BlueMap tiene ejemplos listos.

Comandos de BlueMap

Cada comando tiene un permiso del tipo bluemap.<command>, por ejemplo bluemap.reload. La mayor parte del tiempo no necesitarás ninguno: BlueMap detecta los cambios en el mundo y los renderiza por su cuenta.

Mantener el renderizado ligero

BlueMap renderiza en hilos en segundo plano, no en el hilo principal del servidor, pero el renderizado sigue usando CPU. El primer renderizado de un mundo grande es la parte pesada; después, solo se vuelven a dibujar los chunks que cambian.

• Hilos de renderizado: ajusta render-thread-count en core.conf. La documentación de BlueMap recomienda 1 en máquinas con cuatro núcleos o menos.
• Renderiza cuando haya calma: ejecuta /bluemap stop en las horas de más actividad y /bluemap start por la noche mientras dura el primer renderizado.
• Pausa con jugadores conectados: player-render-limit en plugin.conf detiene el renderizado cuando hay ese número de jugadores conectados.
• Pon un borde del mundo. Evita que el mapa, y el trabajo de renderizado, crezcan sin fin mientras los jugadores exploran.
• Congela los mapas que no necesites en vivo, como el End una vez explorado.

Almacenamiento: archivos o una base de datos

Por defecto BlueMap guarda el mapa como archivos comprimidos en bluemap/web/maps, dentro del almacenamiento de tu servidor. El mapa crece con la zona explorada, así que vigila el espacio en disco en un mundo grande.

También puedes mover un mapa a una base de datos. En storages/sql.conf, configura la conexión a MySQL, MariaDB, PostgreSQL o SQLite; después pon storage: "sql" en el archivo de configuración del mapa y recarga:

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

Paper incluye un driver de MySQL; Spigot, Fabric y Forge necesitan que añadas un driver JDBC. Todos los planes de Minecraft de HytHost incluyen bases de datos MySQL, que creas en la pestaña Databases del panel.