Servidores Minecraft com plugin HolographicDisplays

## 🔌 Sobre o Holographic Displays O Holographic Displays é um plugin para Minecraft que fornece hologramas flutuantes persistentes, capazes de exibir texto e itens. O plugin disponibiliza comandos no jogo para criar e editar hologramas e oferece uma API para desenvolvedores integrarem hologramas noutros plugins. ## 🎯 Objetivo O plugin resolve a necessidade de mostrar informações flutuantes, etiquetas, menus e elementos visuais no mundo sem criar entidades visíveis permanentes. É útil para administração de servidores, exibições cosméticas, menus no mundo e integrações em que os plugins precisam apresentar dados aos jogadores em locais fixos. ## ⚙️ Funcionalidades - Criar e remover hologramas com nome em locais específicos. - Adicionar, remover, definir e inserir linhas de texto nos hologramas. - Exibir itens flutuantes como linhas de holograma (suporte a itens flutuantes). - Ler linhas de um ficheiro de texto para um holograma. - Ler e renderizar imagens num holograma a partir de um ficheiro ou URL (com mapeamento de símbolos e largura máxima configuráveis). - Alinhar, mover, copiar e teletransportar para hologramas. - Recarregar a configuração do plugin e os hologramas guardados sem editar ficheiros manualmente. - API para desenvolvedores disponível para outros plugins criarem e gerirem hologramas de forma programática. ## 🧩 Para quem é - Administradores de servidores que querem exibições visuais no mundo (servidores SMP, Survival, Minigame). - Desenvolvedores de plugins que precisam de uma API para apresentar texto/itens aos jogadores no mundo. - Equipas de staff que usam hologramas para placas, menus ou painéis informativos. ## 🏗️ Exemplos de uso - Um minigame mostra as pontuações atuais acima de cada arena usando hologramas. - Um lobby de servidor exibe as regras e itens para teleporte ao clicar como linhas flutuantes. - Uma integração de plugin publica estatísticas dinâmicas dos jogadores num holograma numa localização fixa. ## ⌨️ Comandos | **Comando** | **Descrição** | **Permissão** | **Acesso** | |---|---|---:|:---| | `/hd` | Comando principal; mostra informações do plugin e a versão. | nenhuma (acessível a todos) | Jogador | | `/hd help` | Mostra os comandos disponíveis e ajuda breve. | nenhuma (acessível a todos) | Jogador | | `/hd create <hologramName> [text]` | Cria um novo holograma na tua localização. | `holographicdisplays.create` | Admin | | `/hd delete <hologram>` | Elimina um holograma com nome. | `holographicdisplays.delete` | Admin | | `/hd list [page]` | Lista hologramas existentes e localizações. | `holographicdisplays.list` | Admin | | `/hd near <radius>` | Lista hologramas perto de ti dentro do raio. | `holographicdisplays.near` | Admin | | `/hd teleport <hologram>` | Teleporta para a localização de um holograma. | `holographicdisplays.teleport` | Admin | | `/hd align <axis> <hologram> <reference>` | Alinha um holograma com outro num eixo específico. | `holographicdisplays.align` | Admin | | `/hd movehere <hologram>` | Move um holograma para a tua posição. | `holographicdisplays.movehere` | Admin | | `/hd edit <hologram>` | Abre as opções de edição de um holograma. | `holographicdisplays.edit` | Admin | | `/hd addline <hologram> <text>` | Adiciona uma linha de texto a um holograma. | `holographicdisplays.addline` | Admin | | `/hd removeline <hologram> <number>` | Remove uma linha numerada de um holograma. | `holographicdisplays.removeline` | Admin | | `/hd setline <hologram> <number> <newText>` | Altera o texto de uma linha específica. | `holographicdisplays.setline` | Admin | | `/hd insertline <hologram> <number> <text>` | Insere uma linha após o índice indicado. | `holographicdisplays.insertline` | Admin | | `/hd info <hologram>` | Mostra o conteúdo do holograma com números de linha. | `holographicdisplays.info` | Admin | | `/hd copy <from> <to>` | Copia o conteúdo de um holograma para outro. | `holographicdisplays.copy` | Admin | | `/hd readtext <hologram> <file>` | Lê linhas de um ficheiro para um holograma. | `holographicdisplays.readtext` | Admin | | `/hd readimage <hologram> <image> <width> [-a]` | Renderiza uma imagem no holograma a partir de um ficheiro ou URL. | `holographicdisplays.readimage` | Admin | | `/hd reload` | Recarrega a configuração e os hologramas guardados. | `holographicdisplays.reload` | Admin | Nota: a documentação indica que cada subcomando tem uma permissão individual (por exemplo, `/hd list` requer `holographicdisplays.list`). O comando principal `/hd` está acessível a todos. ## 🔐 Permissões | **Permissão** | **Descrição** | **Padrão** | |---|---|---:| | `holographicdisplays.<subcommand>` | Permissão individual para cada subcomando de `/hd` (exemplo: `holographicdisplays.list`). | não especificado | | `holographicdisplays.update` | Receber notificações de atualização ao entrar, se ativado na configuração. | não especificado | | `holographicdisplays.*` | Concede todas as permissões de holographicdisplays (se for suportado pelo plugin de permissões). | não especificado | ## ⚙️ Instalação ### 📥 Configuração - Faz download do JAR oficial do plugin num catálogo de confiança. - Coloca o JAR no diretório `plugins/` do servidor para Bukkit/Spigot. - Reinicia o servidor e verifica a consola para confirmar que o plugin foi carregado. ### 📦 Dependências - A documentação oficial resumida não lista dependências obrigatórias; verifica a página de download para integrações opcionais durante a instalação. ### 🧾 Configuração - O plugin suporta ficheiros de configuração e hologramas guardados; usa o comando de recarregar fornecido para aplicar alterações depois de editar os ficheiros. - A renderização de imagens e o mapeamento de símbolos são configuráveis através da configuração do plugin. ## 🧠 Notas técnicas - A documentação oficial inclui um guia de atualização para Minecraft 1.13+ relativamente a mudanças nos nomes dos materiais e ao tratamento de imagens/ícones. - Há uma API para desenvolvedores documentada para integrações de plugins. ## 🤝 Quando este plugin é útil Se precisares de exibições persistentes e editáveis no mundo para informação, menus ou integrações de plugins, o Holographic Displays oferece hologramas com nome, importação de ficheiros/imagens e uma API para que outros plugins possam criar e atualizar hologramas de forma fiável.

Plugins