BlueMap — plugin para generar un mapa del mundo 3D interactivo en el navegador para Minecraft
Guía completa sobre el plugin BlueMap para Minecraft, que crea un mapa 3D interactivo en el navegador. Características, comandos y…
Guía completa sobre el plugin BlueMap para Minecraft, que crea un mapa 3D interactivo en el navegador. Características, comandos y configuración.
BlueMap — plugin para generar un mapa del mundo 3D interactivo en el navegador para Minecraft
BlueMap es un plugin de Minecraft que lee los archivos del mundo y construye un modelo de superficie tridimensional a partir de ellos, accesible en un navegador a través de un servidor web incorporado. El cliente estándar renderiza el mundo solo alrededor del jugador y no proporciona una vista desde arriba o desde el exterior. El plugin forma un mapa completo con la capacidad de rotar la cámara, cambiar al modo de perspectiva o isométrico (plano) y ver estructuras simplemente siguiendo una URL. Resuelve un problema: la visualización externa del mundo del servidor sin necesidad de entrar al juego.
Cómo funciona el renderizado
El plugin divide los chunks en tiles y genera dos capas de detalle: modelos hires con geometría de bloques completa y un mapa lowres para la visión lejana. Hires se activa con un zoom cercano — entonces son visibles bloques específicos, texturas y alturas. Con un zoom mayor, se carga una capa simplificada con manchas de color de los biomas y el paisaje.
Proceso de renderizado en la interfaz web: los tiles se cargan gradualmente al hacer zoom.
El renderizado se realiza de forma asíncrona en un grupo de hilos separado. El hilo principal del servidor de Minecraft no se bloquea — mientras la CPU tenga núcleos libres, los jugadores no sentirán lag por la construcción del mapa. El propio plugin rastrea los cambios en el mundo: BlueMap comprueba periódicamente los archivos mca, detecta los chunks modificados y renderiza solo esos. Los comandos manuales como /bluemap update rara vez son necesarios — principalmente para diagnósticos.
Renderizado en la interfaz web en primera persona
Comandos
El plugin registra un comando raíz único /bluemap con subcomandos. La mayoría de los casos no requieren ningún comando — el renderizado funciona automáticamente.
Comando | Qué hace | |
| muestra el estado del renderizado y la cola | |
| recarga las configuraciones; | |
| pausa y reanuda todo el renderizado (se mantiene tras reiniciar) | |
| congela un mapa específico (sin actualizaciones) | |
| elimina completamente los datos del mapa; se volverá a renderizar | |
| fuerza la actualización de los chunks modificados en el radio | |
| vuelve a renderizar todo, incluso si no hubo cambios | |
| busca problemas típicos del mapa en el punto especificado |
Ejecución del comando /bluemap
Configuración
La carpeta del plugin contiene cuatro archivos de configuración: core.conf, plugin.conf, webapp.conf, webserver.conf. Así como tres subcarpetas: maps/ (un .conf por cada mundo), packs/ (paquetes de recursos para el renderizado) y storages/ (file.conf para el sistema de archivos, sql.conf para la base SQL).
core.conf
El archivo principal. El parámetro clave es accept-download, que debe establecerse en true para el primer inicio. El parámetro render-thread-count (por defecto 1) establece el número de hilos de renderizado — un valor negativo significa «número de núcleos de la CPU menos el valor absoluto del número». metrics (true) controla el envío de estadísticas anónimas.
plugin.conf
Parámetros de visibilidad de los jugadores en el mapa y comportamiento del renderizado:
Parámetro | Qué hace |
| transmite las posiciones de los jugadores online a la aplicación web |
| modos en los que el jugador no es visible. Valores: |
| oculta a los jugadores escondidos por un plugin vanish |
| oculta a los jugadores con el efecto de la poción de invisibilidad |
| oculta a los jugadores que se agachan |
| umbral de luz solar; |
| umbral de luz del bloque |
| elimina de la lista a los jugadores que están en otro mundo |
| segundos entre el guardado de marcadores en el almacenamiento; |
| segundos entre el guardado de las posiciones de los jugadores |
| descarga las skins de Mojang cuando el jugador entra |
| número de jugadores online al que se detiene el renderizado; |
| minutos entre comprobaciones completas de cambios omitidos |
webapp.conf
Configuración de la aplicación web. default-to-flat-view (false) determina la vista inicial — perspectiva o isométrica. Los controles deslizantes hires-slider-default (100) y lowres-slider-default (2000) establecen la distancia de renderizado detallado y simplificado en bloques. resolution-default (1) acepta valores 0.5, 1 o 2. Las matrices scripts y styles vinculan archivos JS y CSS personalizados.
webserver.conf
Servidor web incorporado. enabled (true) — activar o desactivar. port (8100) — el puerto. webroot ("bluemap/web") — directorio con los archivos de la aplicación web (debe coincidir con el webroot en webapp.conf). La sección log configura el registro de la actividad HTTP en un archivo.
Conclusión
BlueMap permite la visualización externa del mundo en formato de modelo 3D completo con rotación de cámara y vuelo libre. El plugin es ideal para servidores de supervivencia y RPG, donde es importante que los jugadores compartan coordenadas e inspeccionen construcciones; para servidores de minijuegos sin un mundo permanente es innecesario.
Instalación
Una instalación típica lleva unos 5 minutos. El proceso es el mismo; solo cambian el loader y el build correspondiente.
- 1Stop your Minecraft server.
- 2Drop the plugin .jar into the server /plugins folder.
- 3Start the server once so the plugin generates its config files.
- 4Edit /plugins/<name>/config.yml as needed, then run /reload confirm or restart.
