Plugin Minecraft InteractionVisualizer

🔌 Sobre o InteractionVisualizer

InteractionVisualizer é um plugin de Minecraft que renderiza representações visuais e animações do lado do cliente para blocos funcionais e entidades relevantes (por exemplo: crafting tables, furnaces, enchantment tables). Os visuais são enviados aos jogadores através de packets e não criam blocos ou entidades do lado do servidor — são apenas exibições do lado do cliente e não afetam o estado do mundo.

🎯 Objetivo

O plugin torna visíveis para os jogadores próximos as interações com blocos funcionais comuns, mostrando itens, progresso, hologramas e animações enquanto os jogadores usam GUIs. Destina-se a donos de servidores que querem um feedback visual mais rico e informativo quando os jogadores interagem com interfaces no mundo.

⚙️ Funcionalidades

• Visualiza muitos blocos funcionais e os respetivos itens/entidades com animações (crafting table, furnace, enchantment table e outros).
• Exibições apenas do lado do cliente: os visuais não criam entidades persistentes ou interagíveis no servidor.
• Alternadores de exibição por bloco e alternadores globais de módulos.
• O estado de alternância do jogador é guardado numa base de dados (SQLite por defeito; MySQL suportado).
• Placeholders do PlaceholderAPI estão disponíveis para o estado de alternância do jogador.
• Fornece uma API de desenvolvimento / wiki para add-ons.
• Consciência de integração com plugins comuns para desativar ou ajustar animações (plugins de vanish, OpenInv, etc.).

🧩 Para quem é

• Servidores Survival e SMP que querem um feedback visual mais imersivo para interações com blocos.
• Servidores decorativos/roleplay que preferem um acabamento visual do lado do cliente sem modificar os dados do mundo.
• Administradores de servidores que querem controlo opcional por jogador sobre efeitos visuais.

🏗️ Exemplos de uso

• Mostrar itens a aparecer numa crafting table enquanto um jogador preenche os espaços da receita, para que os jogadores próximos vejam o progresso.
• Exibir um holograma de progresso do furnace e visuais de itens gerados enquanto um jogador interage com a interface do furnace.
• Permitir que os jogadores escolham que módulos de exibição veem (itemstands, dropped items, holograms).

⌨️ Comandos

🔐 Permissões

⚙️ Instalação

📥 Configuração

• Descarrega o JAR oficial do plugin e quaisquer JARs de dependência necessários.
• Coloca os ficheiros JAR na pasta plugins/ do teu servidor.
• Inicia o servidor e verifica a consola para confirmar que o plugin carregou.
• Edita a configuração conforme necessário e reinicia o servidor para aplicar as alterações.

📦 Dependências

• ProtocolLib (necessário para versões mais antigas do servidor / tratamento de packets quando especificado).
• LightAPI Fork (necessário para versões mais antigas onde é usado).

Integrações opcionais/soft indicadas pelo projeto (usadas para ajustar o comportamento): EssentialsX, OpenInv, PlaceholderAPI, SuperVanish, PremiumVanish, CMI.

🧾 Configuração

• O plugin guarda os alternadores por jogador em SQLite por defeito e suporta MySQL para armazenamento persistente entre servidores.
• Cada exibição de bloco e cada módulo pode ser desativado através da configuração do plugin.

🧠 Notas técnicas

• Construído com base na API do Spigot; também indica compatibilidade com Paper e várias builds modernas de servidor.
• As exibições são apenas do lado do cliente e não criam entidades do servidor que possam ser mortas ou persistentes.
• O plugin oferece uma API de desenvolvimento para add-ons de terceiros e as traduções são mantidas pela comunidade.
• O projeto lista uma limitação: pode não funcionar no Minecraft 1.10.2 ou inferior.

🤝 Quando este plugin é útil

Se queres feedback visual decorativo e não intrusivo para interações dos jogadores sem alterar o estado do lado do servidor, o InteractionVisualizer fornece animações baseadas em packets e controlos por jogador para aumentar a imersão enquanto mantém o mundo inalterado.