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

O que é o BlueMap

O BlueMap lê os arquivos do seu mundo, renderiza tudo em tiles de mapa 3D e os entrega por um pequeno servidor web embutido. De perto, você vê os blocos em 3D completo; de longe, uma visão geral plana. Marcadores ao vivo mostram onde estão os jogadores, e o mapa é atualizado conforme o mundo muda.

Ele renderiza apenas mundos Java Edition. A versão atual, BlueMap 5.29, está disponível para:

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

Instalar o BlueMap

1. Baixe o arquivo que corresponde ao seu servidor no Modrinth, no Hangar ou nas releases do BlueMap no GitHub: o jar -paper para Paper, -fabric para Fabric, e assim por diante.
2. Coloque-o na pasta plugins (Paper, Spigot) ou na pasta mods (Fabric, Forge, NeoForge) e reinicie o servidor. O envio de plugins é explicado em como instalar plugins no Minecraft.
3. O BlueMap cria a configuração em plugins/BlueMap/, ou em config/bluemap/ em servidores com mods, com um mapa já configurado para cada um dos seus mundos.

Nesse ponto, o console avisa que o BlueMap está aguardando. Ele não vai renderizar nada até você aceitar o download, que é o próximo passo.

Aceitar o download no core.conf

Para desenhar os blocos, o BlueMap precisa das texturas e dos modelos do cliente do Minecraft, que ele baixa da Mojang. Abra o core.conf e altere:

accept-download: true

Ao ativar isso, você aceita o EULA da Mojang e confirma que tem o Minecraft Java Edition. Salve o arquivo e execute /bluemap reload, ou reinicie. O BlueMap baixa 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 padrão. Na sua própria máquina, abra essa porta e acesse http://your-ip:8100. Em servidores hospedados, normalmente você não pode escolher uma porta livremente, então usa uma atribuída ao seu servidor:

1. Consiga uma segunda porta para o seu servidor. Na HytHost, abra a aba Network no painel e adicione uma alocação: o painel escolhe uma porta livre e a abre para você.
2. Abra o webserver.conf e defina port com esse número:

   port: 25570

3. Execute /bluemap reload e abra http://your-server-ip:25570 em um navegador.

Não use a porta do jogo; ela é do Minecraft. Para mostrar o mapa no seu próprio domínio sem número de porta, coloque um proxy reverso como o nginx na frente; a documentação do BlueMap tem exemplos prontos.

Comandos do BlueMap

Cada comando tem uma permissão no formato bluemap.<command>, por exemplo bluemap.reload. Na maior parte do tempo você não precisa de nenhum deles: o BlueMap percebe as mudanças no mundo e as renderiza sozinho.

Mantenha a renderização leve

O BlueMap renderiza em threads em segundo plano, não na thread principal do servidor, mas a renderização ainda usa 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: defina render-thread-count no core.conf. A documentação do BlueMap sugere 1 em máquinas com quatro núcleos ou menos.
• Renderize quando estiver tranquilo: execute /bluemap stop nos horários de pico e /bluemap start à noite enquanto a primeira renderização roda.
• Pause com jogadores online: player-render-limit no plugin.conf para a renderização quando esse número de jogadores estiver conectado.
• Defina uma borda do mundo. Ela impede que o mapa, e o trabalho de renderização, cresçam sem parar conforme os jogadores exploram.
• Congele os mapas que você não precisa ao vivo, como o End depois de explorado.

Armazenamento: arquivos ou banco de dados

Por padrão, o BlueMap guarda o mapa como arquivos compactados em bluemap/web/maps, no armazenamento do seu servidor. O mapa cresce com a área explorada, então fique de olho no espaço em disco em um mundo grande.

Você também pode mover um mapa para um banco de dados. Em storages/sql.conf, configure a conexão com MySQL, MariaDB, PostgreSQL ou SQLite, depois defina storage: "sql" no arquivo de configuração do mapa e recarregue:

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

O Paper já vem com um driver MySQL; Spigot, Fabric e Forge precisam que você adicione um driver JDBC. Todos os planos de Minecraft da HytHost incluem bancos de dados MySQL, que você cria na aba Databases do painel.