Plugin Minecraft InteractiveChat

🔌 Sobre o InteractiveChat

InteractiveChat é um plugin de Minecraft que melhora o chat no jogo, substituindo nomes simples de jogadores e palavras-chave por conteúdo interativo (mensagens ao passar o rato, ações de clique) e permitindo que os jogadores mostrem itens, inventários e baús do ender diretamente no chat. Foi concebido para funcionar por cima de plugins de formatação de chat existentes, modificando pacotes em vez de substituir os sistemas de chat.

🎯 Objetivo

InteractiveChat resolve o problema do chat estático, apenas texto, ao adicionar elementos interativos e placeholders ricos, para que os jogadores possam partilhar detalhes de itens/ferramentas e o conteúdo do inventário com interações de hover e clique. Também suporta funcionalidade entre servidores em redes com proxy, permitindo recursos de chat interativo em todos os servidores backend.

⚙️ Funcionalidades

• Substitui nomes de jogadores no chat por conteúdo interativo de hover/clique.
• Mostra a pré-visualização do item na mão no chat através de uma palavra-chave (por exemplo, [item]).
• Mostra o conteúdo do inventário do jogador no chat através de uma palavra-chave (por exemplo, [inv]) e permite escolher layouts de apresentação.
• Mostra o conteúdo do baú do ender no chat através de uma palavra-chave (por exemplo, [ender]).
• Cria palavras-chave/placeholders interativos personalizados para usar no chat.
• Menção de jogadores com notificações opcionais (som, título, barra de ação, barra de boss) quando suportado pela versão do servidor.
• Suporte entre servidores para BungeeCord e Velocity quando configurado no proxy e nos backends.
• Suporta placeholders do PlaceholderAPI e integra a tradução dos nomes dos materiais dos itens para o idioma do cliente.
• Códigos de cor RGB e suporte a fontes personalizadas para mensagens em servidores que os suportam (recursos que exigem 1.16+ para comportamentos RGB).

🧩 Para quem é

• Administradores de servidores que querem interações de chat mais ricas e conteúdo com hover/clique.
• Redes que usam proxies (BungeeCord/Velocity) e precisam de chat interativo entre servidores backend.
• Comunidades que querem que os jogadores mostrem itens ou inventários no chat sem mods externos.

🏗️ Casos de uso de exemplo

• Um jogador escreve [item] no chat global para mostrar uma dica interativa do item que está a segurar, para os outros inspecionarem.
• Um moderador envia uma mensagem formatada no chat usando placeholders e pré-visualizações inline do inventário para suporte ou revisão.
• Uma rede com proxy ativa o plugin no proxy e nos backends para que menções e placeholders funcionem entre servidores.

⌨️ Comandos

Nota: acima estão apenas os comandos explicitamente listados pelas fontes oficiais. Os nós de permissão são incluídos quando o plugin os documenta; caso contrário, a coluna de permissão mostra não especificado.

🔐 Permissões

(Apenas os nós de permissão explicitamente fornecidos pela documentação oficial do plugin estão listados acima.)

⚙️ Instalação

📥 Configuração

• Descarrega o JAR oficial do plugin e os plugins de dependência necessários.
• Coloca o InteractiveChat.jar (e os jars de dependência) no diretório plugins/ do servidor.
• Inicia o servidor.
• Edita a configuração do plugin, se necessário, e reinicia o servidor para aplicar as alterações.

📦 Dependências

Dependências confirmadas necessárias em servidores backend (Spigot/Paper/etc.):

• ProtocolLib (ou) PacketEvents (+ módulo de pacotes relevante)
• PlaceholderAPI
• Vault

Notas: as dependências não são necessárias no software de proxy; se planeias usar o plugin com BungeeCord ou Velocity, instala o InteractiveChat tanto no proxy como nos servidores backend e ativa a opção proxy/bungeecord na configuração do InteractiveChat em cada servidor backend.

🧠 Notas técnicas

• O plugin modifica o chat ao nível do pacote; exige uma biblioteca de pacotes (ProtocolLib ou PacketEvents) para intercetar/modificar mensagens nos servidores backend.
• Suporte a proxy: BungeeCord e Velocity são suportados; para ativar placeholders e menções entre servidores, o plugin tem de estar instalado no proxy e em todos os servidores backend, com a opção bungeecord ativada na configuração de cada backend.
• O PlaceholderAPI é usado para resolver placeholders e requer que quaisquer expansões necessárias sejam instaladas separadamente para esses placeholders funcionarem.
• Os nomes dos materiais dos itens são traduzidos para o idioma do cliente de cada jogador, quando aplicável.
• Códigos de cor RGB e etiquetas de fonte personalizada são suportados para servidores/clientes que suportem essas funcionalidades (o comportamento RGB requer suporte do servidor/cliente, normalmente disponível em 1.16+).

🤝 Quando este plugin é útil

Se quer adicionar pré-visualizações inspecionáveis de itens/ferramentas, partilha de inventário, palavras-chave de chat clicáveis e funcionalidades de chat interativo entre servidores, mantendo o plugin de formatação de chat que já usa, o InteractiveChat oferece uma integração ao nível do pacote que sobrepõe conteúdo interativo aos sistemas de chat padrão.