Plugin Minecraft dynmap

🔌 Sobre o Dynmap

Dynmap é uma família de plugin e mod para Minecraft que fornece mapas em tempo real, baseados na web, para servidores Minecraft. Ele renderiza blocos de mapa dos mundos carregados e oferece uma interface de mapa interativa que pode mostrar marcadores, áreas, linhas, posições em tempo real dos jogadores e balões de chat. O Dynmap permite executar o seu webserver interno ou exportar os dados do mapa para alojamento externo e oferece vários backends de armazenamento.

🎯 Objetivo

O objetivo principal do Dynmap é dar aos administradores do servidor e aos jogadores uma visão ao vivo e navegável do terreno e da atividade do servidor através de um browser. Ele resolve o problema de visualizar a disposição do mundo, acompanhar a localização dos jogadores, publicar mapas do servidor para os utilizadores e criar mapas anotados com marcadores e regiões.

⚙️ Funcionalidades

• Renderização de blocos em tempo real dos mundos do servidor (várias vistas de mapa e modos de renderização).
• Marcadores, áreas e linhas configuráveis para anotar mapas para jogadores ou staff.
• Rastreamento ao vivo de jogadores e balões de chat opcionais / integração de chat web-para-jogo.
• Vários backends de armazenamento: ficheiros planos, MySQL/SQLite/PostgreSQL/MariaDB e suporte a AWS S3 para armazenamento do mapa/web.
• Webserver integrado para servir a interface do mapa; pode ser adaptado para publicar/enviar conteúdo estático do site para armazenamento externo.
• Builds multiplataforma: existem artefactos dedicados para builds Spigot/Paper, Forge e Fabric.

🧩 Para quem é

• Donos e administradores de servidores que querem um mapa navegável do(s) seu(s) mundo(s).
• Servidores públicos SMP e de sobrevivência que publicam mapas para os jogadores.
• Servidores de minijogos ou roleplay que precisam de mapas anotados, marcadores de spawn ou sobreposições de regiões.
• Hosts que precisam de opções flexíveis de armazenamento/backing (SQL ou S3) para mapas grandes.

🏗️ Casos de uso de exemplo

• Renderizar e publicar um mapa ao vivo do Overworld para os jogadores verem online.
• Marcar cidades, lojas e pontos de referência notáveis com marcadores personalizados e contornos de áreas.
• Executar renders agendados ou sob demanda de chunks recém-explorados (renders por raio ou do mundo inteiro).

⌨️ Comandos

(Nota: o Dynmap expõe um conjunto maior de comandos de mapa e configuração na documentação oficial.)

🔐 Permissões

⚙️ Instalação

📥 Configuração

• Descarregue o JAR oficial do Dynmap para a plataforma do seu servidor e coloque-o no diretório plugins/ (ou mods/ para Forge/Fabric).
• Reinicie o servidor e verifique a consola para confirmar que o Dynmap carregou e criou as suas pastas de configuração e de mapas.
• Configure mapas, marcadores, backend de armazenamento e opções do webserver nos ficheiros de configuração do Dynmap criados na primeira execução.

📦 Dependências

• As builds do Dynmap incluem suporte para drivers JDBC em muitas distribuições Spigot/Paper; outras plataformas podem exigir drivers adicionais ou mods de compatibilidade para backends SQL.
• Plugins de integração (por exemplo, WorldGuard, Towny, Citizens) são fornecidos através de integrações separadas do Dynmap; não são dependências obrigatórias em tempo de execução.

🧾 Configuração

• O Dynmap usa ficheiros de configuração YAML criados no primeiro arranque. A configuração controla mapas, definições de renderização, conjuntos de marcadores, backend de armazenamento e o comportamento do webserver.
• Os backends de armazenamento suportados incluem ficheiros planos, MySQL, SQLite, PostgreSQL, MariaDB e armazenamento opcional AWS S3 para alojar dados do mapa.

🧠 Notas técnicas

• As fontes oficiais do projeto fornecem builds específicos por plataforma para Spigot/Paper, Forge e Fabric.
• A base de código do Dynmap é lançada sob a licença Apache-2.0.
• O projeto suporta execução em Java 8 em tempo de execução, enquanto os requisitos de compilação variam consoante o destino e podem exigir versões mais recentes do JDK para builds modernas.
• O Dynmap oferece APIs publicadas (DynmapCoreAPI e dynmap-api) usadas por plugins de integração; estas são as interfaces estáveis para extensões de terceiros.

🤝 Quando este plugin é útil

Se quiser um mapa persistente e navegável do seu servidor Minecraft (para navegação, rastreamento de jogadores ou mapas da comunidade), o Dynmap oferece uma solução configurável e multiplataforma com vários backends de armazenamento e um rico conjunto de funcionalidades de renderização e marcadores.