Guia do BlueMap: um mapa web 3D para o teu servidor de Minecraft

O que é o BlueMap

O BlueMap lê os ficheiros do teu mundo, renderiza-os em tiles de mapa 3D e serve-os através de um pequeno servidor web integrado. De perto, vês os blocos em 3D completo; de longe, uma vista geral plana. Os marcadores em tempo real mostram onde estão os jogadores e o mapa atualiza-se à medida que o mundo muda.

Só renderiza mundos Java Edition. A versão atual, BlueMap 5.29, existe em versões para:

Para uma versão mais antiga do Minecraft, descarrega uma versão anterior do BlueMap que a inclua. Cada versão no Modrinth e no Hangar indica as versões que suporta.

Instalar o BlueMap

1. Descarrega o ficheiro adequado ao teu servidor a partir do Modrinth, do Hangar ou das releases do BlueMap no GitHub: o jar -paper para Paper, -fabric para Fabric, e assim por diante.
2. Coloca-o na pasta plugins (Paper, Spigot) ou na pasta mods (Fabric, Forge, NeoForge) e reinicia o servidor. O envio de plugins está explicado em como instalar plugins no Minecraft.
3. O BlueMap cria a sua configuração em plugins/BlueMap/, ou em config/bluemap/ em servidores com mods, com um mapa já preparado para cada um dos teus mundos.

Neste ponto, a consola indica que o BlueMap está à espera. Não vai renderizar nada até aceitares a transferência, que é o passo seguinte.

Aceitar a transferência no core.conf

Para desenhar os blocos, o BlueMap precisa das texturas e dos modelos do cliente de Minecraft, que descarrega da Mojang. Abre o core.conf e altera:

accept-download: true

Ao ativá-lo, aceitas o EULA da Mojang e confirmas que tens o Minecraft Java Edition. Guarda o ficheiro e executa /bluemap reload, ou reinicia. O BlueMap descarrega os recursos e começa a renderizar.

Dar ao mapa web uma porta própria

O servidor web do BlueMap escuta na porta 8100 por predefinição. Na tua própria máquina, abre essa porta e visita http://your-ip:8100. Em servidores alojados normalmente não podes escolher uma porta livremente, por isso usas uma atribuída ao teu servidor:

1. Obtém uma segunda porta para o teu servidor. Na HytHost, abre o separador Network no painel e adiciona uma alocação: o painel escolhe uma porta livre e abre-a por ti.
2. Abre o webserver.conf e define port com esse número:

   port: 25570

3. Executa /bluemap reload e abre http://your-server-ip:25570 num browser.

Não uses a porta do jogo; essa é do Minecraft. Para mostrar o mapa no teu próprio domínio sem número de porta, coloca à frente um reverse proxy como o nginx; a documentação do BlueMap tem exemplos prontos.

Comandos do BlueMap

Cada comando tem uma permissão do tipo bluemap.<command>, por exemplo bluemap.reload. Na maior parte das vezes não precisas de nenhum: o BlueMap deteta as alterações no mundo e renderiza-as sozinho.

Manter a renderização leve

O BlueMap renderiza em threads de segundo plano, não na thread principal do servidor, mas a renderização continua a usar CPU. A primeira renderização de um mundo grande é a parte pesada; depois disso, só os chunks alterados são redesenhados.

• Threads de renderização: define render-thread-count no core.conf. A documentação do BlueMap sugere 1 em máquinas com quatro núcleos ou menos.
• Renderiza quando estiver calmo: executa /bluemap stop nas horas de maior movimento e /bluemap start à noite enquanto decorre a primeira renderização.
• Pausa com jogadores online: player-render-limit no plugin.conf para a renderização quando houver esse número de jogadores ligados.
• Define uma borda do mundo. Impede que o mapa, e o trabalho de renderização, cresçam sem fim à medida que os jogadores exploram.
• Congela os mapas de que não precisas em tempo real, como o End depois de explorado.

Armazenamento: ficheiros ou base de dados

Por predefinição, o BlueMap guarda o mapa como ficheiros comprimidos em bluemap/web/maps, no armazenamento do teu servidor. O mapa cresce com a área explorada, por isso vigia o espaço em disco num mundo grande.

Em alternativa, podes mover um mapa para uma base de dados. Em storages/sql.conf, configura a ligação a MySQL, MariaDB, PostgreSQL ou SQLite, depois define storage: "sql" no ficheiro de configuração do mapa e recarrega:

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

O Paper inclui um driver MySQL; Spigot, Fabric e Forge precisam que adiciones um driver JDBC. Todos os planos de Minecraft da HytHost incluem bases de dados MySQL, que crias no separador Databases do painel.