---
title: "BlueMap no Minecraft: mapa 3D do servidor no navegador"
description: "Instale o BlueMap no Paper, Fabric ou Forge, aceite o download no core.conf, controle o render inicial e publique o mapa atrás do Nginx com HTTPS."
url: "https://streethosting.com.br/guias/minecraft/bluemap-mapa-3d-servidor-minecraft"
category: "minecraft"
slug: "bluemap-mapa-3d-servidor-minecraft"
datePublished: "2026-09-28"
dateModified: "2026-09-28"
author: "Equipe StreetHosting"
difficulty: "intermediario"
language: "pt-BR"
keywords:
  - "bluemap minecraft"
  - "instalar bluemap servidor"
  - "mapa 3d servidor minecraft"
  - "bluemap nginx https"
  - "bluemap ou dynmap"
---

# Como mostrar o mundo do seu servidor Minecraft em 3D com o BlueMap

O BlueMap transforma o mundo do servidor em um mapa 3D que qualquer pessoa abre no navegador. Veja como instalar, liberar a porta 8100, segurar o consumo do primeiro render e publicar o mapa com HTTPS.

> **Resposta rápida**
>
> Para usar o **BlueMap no Minecraft**, coloque o plugin na pasta plugins (ou o mod na pasta mods), ligue o servidor uma vez, troque `accept-download` para true no core.conf e rode /bluemap reload. O mapa abre no navegador pela porta 8100. Em uma VPS, limite as threads do primeiro render e publique o mapa atrás do Nginx com HTTPS em vez de deixar a porta aberta.

## O que o BlueMap faz

O BlueMap lê os arquivos do mundo e monta um mapa 3D que qualquer pessoa abre no navegador, sem entrar no jogo. Dá para girar a câmera, descer até o nível das construções e ver a posição dos jogadores online. Perto da câmera ele mostra os blocos em alta resolução; de longe, uma versão simplificada que carrega rápido.

Depois do primeiro render, o mapa acompanha o mundo sozinho. Quando alguém quebra ou coloca blocos, aquele trecho é refeito cerca de um minuto depois, e uma vez por dia o BlueMap confere o mundo inteiro atrás de mudanças que tenham escapado. Você não precisa mandar atualizar nada na mão.

Para a comunidade, o mapa vira vitrine: dá para mandar o link no Discord e mostrar a cidade que a turma construiu. Para a staff, ajuda a achar construções abandonadas e áreas destruídas. Ele funciona só com a edição Java; jogadores Bedrock que entram por Geyser aparecem normalmente, porque o servidor continua sendo Java.

## Instalar no Paper, Fabric ou Forge

O BlueMap existe como plugin e como mod. Baixe o arquivo certo para a plataforma e para a versão exata do seu servidor na página oficial do projeto:

| Servidor | Onde colocar o arquivo | Pasta de configuração |
| --- | --- | --- |
| Paper, Spigot ou Folia | Pasta plugins | plugins/BlueMap |
| Fabric | Pasta mods, com a Fabric API | config/bluemap |
| Forge ou NeoForge | Pasta mods | config/bluemap |
| Sem servidor ligado | Versão de linha de comando, rodada à parte | Criada ao lado do arquivo |

As versões mais recentes do BlueMap acompanham o Minecraft 26.x e pedem Java 25, o mesmo que o próprio jogo exige a partir da 26.1. Se o seu servidor ainda está na 1.21, use a última versão do BlueMap que lista a 1.21 entre as compatíveis. Com o arquivo no lugar, reinicie o servidor: o BlueMap cria a pasta de configuração e avisa no console que está esperando a sua autorização.

> **Dica**
>
> A versão de linha de comando serve para renderizar uma cópia do mundo em outra máquina, sem gastar processador do servidor do jogo. É útil em mundos enormes ou para gerar um mapa de uma temporada antiga já encerrada.

## Aceitar o download e escolher a porta

Para desenhar as texturas, o BlueMap precisa baixar os recursos do cliente do Minecraft direto da Mojang. Ele não faz isso sozinho: você autoriza no core.conf, e, ao mudar para true, aceita também os termos de uso da Mojang para esse download. Depois confira a porta no webserver.conf:

```
# plugins/BlueMap/core.conf
accept-download: true

# plugins/BlueMap/webserver.conf
enabled: true
webroot: "bluemap/web"
port: 8100
```

Salve e rode `/bluemap reload` no console. O render começa, e o mapa já abre em http://IP_DO_SERVIDOR:8100 mesmo antes de terminar. O comando `/bluemap` sozinho mostra o andamento.

- **Na hospedagem gerenciada:** o mapa precisa de uma porta própria. Os planos Minecraft a partir de 8 GB incluem portas extras aleatórias; coloque no webserver.conf o número que o painel liberou.
- **Na VPS:** para um teste rápido, libere a 8100 no firewall. Para o uso de verdade, siga a seção do Nginx e feche a porta de novo.
- **Mundos que você não quer no mapa:** cada mundo tem um arquivo na pasta maps. Remova o arquivo e rode `/bluemap purge` com o nome do mapa para apagar o que já foi renderizado.

Um detalhe que confunde muita gente: o registro SRV que deixa os jogadores entrarem sem digitar porta vale só para o Minecraft. O navegador não usa SRV, então o link do mapa precisa levar a porta, ou ser servido por um subdomínio próprio pelo Nginx, como na seção seguinte.

## O primeiro render sem travar o jogo

Na primeira vez, o BlueMap processa todos os chunks já gerados do mundo. Em um mapa grande, isso leva horas e ocupa várias threads do processador. Como o Minecraft depende de um núcleo livre para a thread principal, o render sem limite pode derrubar o TPS justamente no horário em que os jogadores estão online.

O controle fica no core.conf. O padrão de `render-thread-count` é -2, que significa todos os núcleos menos dois. Em servidores com 4 vCPU ou menos, fixe em 1. Com 6 a 8 vCPU, 2 ou 3 threads costumam dar conta do render sem roubar processador do jogo.

```
# core.conf
render-thread-count: 1

# plugin.conf
# pausa o render quando houver 10 ou mais jogadores online
player-render-limit: 10
```

1. Gere o mundo antes com o Chunky, como mostra o guia de [pré geração de chunks com Chunky](https://streethosting.com.br/guias/minecraft/pre-gerar-chunks-servidor-minecraft-chunky), e só depois faça o primeiro render.
2. Use `/bluemap stop` para pausar o render no pico e `/bluemap start` para retomar de madrugada.
3. Congele mapas que não mudam mais, como o de um evento encerrado, com `/bluemap freeze`.
4. Acompanhe o espaço em disco: mapas grandes ocupam vários gigabytes, mesmo com a compressão padrão.

Depois do primeiro render, o BlueMap só atualiza os chunks alterados, e o consumo cai para um nível que a maioria dos servidores nem sente.

## Publicar com Nginx e HTTPS

Em uma VPS, o jeito mais seguro e bonito é servir o mapa em um subdomínio como mapa.seudominio.com.br, com cadeado de HTTPS e sem número de porta no link. Primeiro, faça o BlueMap escutar só na própria máquina, para que ninguém acesse a porta 8100 por fora:

```
# webserver.conf
ip: "127.0.0.1"
port: 8100
```

Depois crie o site no Nginx, em `/etc/nginx/sites-available/mapa`:

```
server {
    listen 80;
    server_name mapa.seudominio.com.br;

    location / {
        proxy_pass http://127.0.0.1:8100;
        proxy_set_header Host $host;
        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
    }
}
```

```
sudo ln -s /etc/nginx/sites-available/mapa /etc/nginx/sites-enabled/
sudo nginx -t && sudo systemctl reload nginx
sudo certbot --nginx -d mapa.seudominio.com.br
sudo ufw delete allow 8100/tcp
```

Se preferir o mapa em um caminho do site principal, como seudominio.com.br/mapa, use `location /mapa/` com `proxy_pass http://127.0.0.1:8100/;`, com a barra no final dos dois. O funcionamento do proxy reverso está em [Nginx como proxy reverso na VPS](https://streethosting.com.br/guias/vps/configurar-nginx-reverse-proxy-vps), e a emissão e renovação do certificado em [certificado SSL com Let's Encrypt](https://streethosting.com.br/guias/vps/certificado-ssl-vps-lets-encrypt-nginx).

Em servidores survival, um mapa aberto para qualquer pessoa também revela onde fica a base de cada jogador. Se isso incomoda a comunidade, proteja o mapa com senha no próprio Nginx. Crie o arquivo de usuários e acrescente as duas linhas de autenticação dentro do bloco location:

```
sudo apt install -y apache2-utils
sudo htpasswd -c /etc/nginx/.mapa_senhas membros

# dentro de location / { ... }
auth_basic "Mapa do servidor";
auth_basic_user_file /etc/nginx/.mapa_senhas;
```

Passe o usuário e a senha só no canal de membros do Discord e troque a senha quando alguém sair da staff ou da comunidade.

## Arquivo ou banco SQL

O BlueMap guarda os pedaços do mapa em um armazenamento definido na pasta storages. Cada mapa aponta para um deles no próprio arquivo em maps.

- **Arquivo, o padrão:** os dados ficam em pastas dentro do servidor, compactados. É o mais simples e permite que o Nginx sirva os arquivos direto do disco em mapas muito acessados, com o modelo que a documentação oficial fornece.
- **Banco SQL:** MySQL, MariaDB, PostgreSQL ou SQLite, configurados no sql.conf com a URL de conexão, o usuário e a senha. Faz sentido quando o mapa é servido de outra máquina ou quando milhares de arquivos pequenos atrapalham o seu backup.

> **Atenção**
>
> Tire a pasta de dados do BlueMap do backup do servidor. O mapa pode ser gerado de novo a partir do mundo, e incluir milhares de arquivos de imagem deixa cada cópia maior e mais lenta. Mantenha no backup só a pasta de configuração, que é pequena e guarda todos os seus ajustes.

## BlueMap ou Dynmap

Os dois fazem mapa web do servidor, com filosofias diferentes. O passo a passo do outro está em [Dynmap no servidor Minecraft](https://streethosting.com.br/guias/minecraft/dynmap-mapa-online-servidor-minecraft).

| Critério | BlueMap | Dynmap |
| --- | --- | --- |
| Visual | 3D navegável, com câmera livre | 2D, em vista plana ou em perspectiva |
| Porta padrão | 8100 | 8123 |
| Plataformas | Paper, Spigot, Folia, Fabric, Forge, NeoForge e Sponge | Plugin para Paper e Spigot, com versões para Fabric e Forge |
| Peso no navegador | Maior, pede placa de vídeo razoável | Leve, abre bem em celular simples |
| Extras | Marcadores por API e addons | Chat pelo navegador e muitos plugins de marcadores |

Escolha um só. Rodar os dois ao mesmo tempo dobra o render e o espaço em disco sem ganho real para os jogadores. Se você está trocando o Dynmap pelo BlueMap, remova o jar do Dynmap e, depois de conferir que o mapa novo está completo, apague a pasta de dados dele para liberar espaço. Avise a comunidade do link novo, porque a porta e o endereço mudam.

## Onde rodar o servidor com mapa

O BlueMap disputa processador com o jogo durante o render, então o ideal é ter núcleos de sobra além do que a thread principal usa. As VPS Ryzen usam Ryzen 9 9950X de até 5,7 GHz, com DDR5 e NVMe, em São Paulo:

- **4 vCPU, 8 GB e 80 GB NVMe por R$ 114,00:** mundo pequeno ou médio, com o render em 1 thread.
- **6 vCPU, 16 GB e 160 GB NVMe por R$ 214,00:** render em 2 ou 3 threads sem afetar o jogo e disco folgado para os mapas.
- **8 vCPU, 24 GB e 240 GB NVMe por R$ 314,00:** mundo grande, mapa web muito acessado e banco de dados na mesma máquina.

A página de [VPS para Minecraft](https://streethosting.com.br/vps-minecraft) reúne esses degraus, e a linha completa está em [VPS Ryzen](https://streethosting.com.br/vps/ryzen). Se você não quer cuidar de Nginx e firewall, o [Minecraft Pro](https://streethosting.com.br/minecraft-pro) de 8 GB, por R$ 88,00, já inclui uma porta extra para o mapa, e o de 10 GB, por R$ 110,00, inclui cinco. Os planos de 4 e 6 GB não têm porta extra, então o mapa web fica de fora neles, além de disputar a pouca memória com o próprio jogo.

## Perguntas frequentes

### Qual é a porta padrão do BlueMap?

A porta padrão do servidor web do BlueMap é a 8100, configurada no arquivo webserver.conf. Na hospedagem gerenciada, troque pela porta extra que o painel liberou. Em uma VPS, o melhor é deixar o BlueMap escutando só na própria máquina e publicar o mapa pelo Nginx com HTTPS.

### Por que o BlueMap não renderiza nada depois de instalar?

Porque ele vem travado até você aceitar o download dos recursos do jogo. Abra o core.conf, mude para true a opção que autoriza esse download e rode /bluemap reload. Lembre também que só aparecem no mapa os chunks que já foram gerados no mundo.

### O BlueMap deixa o servidor Minecraft com lag?

O primeiro render é pesado, porque processa o mundo inteiro usando várias threads. Limite a quantidade de threads no core.conf e, se precisar, pause o render com /bluemap stop nos horários de pico. Depois do primeiro render, ele só atualiza os trechos que mudaram, e o impacto cai bastante.

### Dá para usar o BlueMap em servidor Fabric ou Forge?

Sim. Além do plugin para Paper, Spigot e Folia, existem versões em mod para Fabric, Forge e NeoForge. No servidor com mods, o arquivo vai para a pasta mods e a configuração fica em config/bluemap. Baixe sempre a versão que lista a sua versão exata do Minecraft.

### BlueMap ou Dynmap: qual usar?

O BlueMap entrega um mapa 3D navegável e acompanha as versões novas do jogo. O Dynmap gera um mapa 2D mais leve para o navegador e tem chat web e muitos plugins de marcadores antigos. Escolha um só, porque rodar os dois dobra o trabalho de render no servidor.

## Guias relacionados

- [Como instalar o Dynmap no servidor Minecraft: mapa online em tempo real](https://streethosting.com.br/guias/minecraft/dynmap-mapa-online-servidor-minecraft.md)
- [Como pré gerar chunks no servidor Minecraft com Chunky](https://streethosting.com.br/guias/minecraft/pre-gerar-chunks-servidor-minecraft-chunky.md)
- [Como configurar o Nginx como reverse proxy na VPS](https://streethosting.com.br/guias/vps/configurar-nginx-reverse-proxy-vps.md)
- [Certificado SSL na VPS com Let's Encrypt e Nginx](https://streethosting.com.br/guias/vps/certificado-ssl-vps-lets-encrypt-nginx.md)
- [Como migrar seu servidor Minecraft para uma VPS](https://streethosting.com.br/guias/minecraft/migrar-servidor-minecraft-para-vps.md)

## Produtos citados

- https://streethosting.com.br/vps-minecraft
- https://streethosting.com.br/vps/ryzen
- https://streethosting.com.br/minecraft-pro

## Dados estruturados

```json
[
  {
    "@context": "https://schema.org",
    "@type": [
      "Article",
      "TechArticle"
    ],
    "headline": "Como mostrar o mundo do seu servidor Minecraft em 3D com o BlueMap",
    "name": "BlueMap no Minecraft: mapa 3D do servidor no navegador",
    "abstract": "O BlueMap transforma o mundo do servidor em um mapa 3D que qualquer pessoa abre no navegador. Veja como instalar, liberar a porta 8100, segurar o consumo do primeiro render e publicar o mapa com HTTPS.",
    "description": "Instale o BlueMap no Paper, Fabric ou Forge, aceite o download no core.conf, controle o render inicial e publique o mapa atrás do Nginx com HTTPS.",
    "datePublished": "2026-09-28",
    "dateModified": "2026-09-28",
    "author": {
      "@type": "Organization",
      "name": "Equipe StreetHosting"
    },
    "publisher": {
      "@type": "Organization",
      "name": "StreetHosting",
      "url": "https://streethosting.com.br"
    },
    "inLanguage": "pt-BR",
    "mainEntityOfPage": {
      "@type": "WebPage",
      "@id": "https://streethosting.com.br/guias/minecraft/bluemap-mapa-3d-servidor-minecraft"
    }
  },
  {
    "@context": "https://schema.org",
    "@type": "FAQPage",
    "mainEntity": [
      {
        "@type": "Question",
        "name": "Qual é a porta padrão do BlueMap?",
        "acceptedAnswer": {
          "@type": "Answer",
          "text": "A porta padrão do servidor web do BlueMap é a 8100, configurada no arquivo webserver.conf. Na hospedagem gerenciada, troque pela porta extra que o painel liberou. Em uma VPS, o melhor é deixar o BlueMap escutando só na própria máquina e publicar o mapa pelo Nginx com HTTPS."
        }
      },
      {
        "@type": "Question",
        "name": "Por que o BlueMap não renderiza nada depois de instalar?",
        "acceptedAnswer": {
          "@type": "Answer",
          "text": "Porque ele vem travado até você aceitar o download dos recursos do jogo. Abra o core.conf, mude para true a opção que autoriza esse download e rode /bluemap reload. Lembre também que só aparecem no mapa os chunks que já foram gerados no mundo."
        }
      },
      {
        "@type": "Question",
        "name": "O BlueMap deixa o servidor Minecraft com lag?",
        "acceptedAnswer": {
          "@type": "Answer",
          "text": "O primeiro render é pesado, porque processa o mundo inteiro usando várias threads. Limite a quantidade de threads no core.conf e, se precisar, pause o render com /bluemap stop nos horários de pico. Depois do primeiro render, ele só atualiza os trechos que mudaram, e o impacto cai bastante."
        }
      },
      {
        "@type": "Question",
        "name": "Dá para usar o BlueMap em servidor Fabric ou Forge?",
        "acceptedAnswer": {
          "@type": "Answer",
          "text": "Sim. Além do plugin para Paper, Spigot e Folia, existem versões em mod para Fabric, Forge e NeoForge. No servidor com mods, o arquivo vai para a pasta mods e a configuração fica em config/bluemap. Baixe sempre a versão que lista a sua versão exata do Minecraft."
        }
      },
      {
        "@type": "Question",
        "name": "BlueMap ou Dynmap: qual usar?",
        "acceptedAnswer": {
          "@type": "Answer",
          "text": "O BlueMap entrega um mapa 3D navegável e acompanha as versões novas do jogo. O Dynmap gera um mapa 2D mais leve para o navegador e tem chat web e muitos plugins de marcadores antigos. Escolha um só, porque rodar os dois dobra o trabalho de render no servidor."
        }
      }
    ]
  }
]
```