Plugin Minecraft InteractiveChat

🔌 Sobre o InteractiveChat

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

🎯 Objetivo

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

⚙️ Recursos

• Substitui nomes de jogadores no chat por conteúdo interativo de hover/clique.
• Mostra a prévia do item na mão no chat por meio de uma palavra-chave (por exemplo, [item]).
• Mostra o conteúdo do inventário do jogador no chat por meio de uma palavra-chave (por exemplo, [inv]) e permite escolher layouts de exibição.
• Mostra o conteúdo do baú do ender no chat por meio de uma palavra-chave (por exemplo, [ender]).
• Cria palavras-chave/placeholders interativos personalizados para uso no chat.
• Menções a jogadores com notificações opcionais (som, título, action bar, boss bar) 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 suportam isso (recursos que exigem 1.16+ para comportamentos RGB).

🧩 Para quem é

• Administradores de servidor que querem interações de chat mais ricas e conteúdo com hover/clique.
• Redes que usam proxy (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 digita [item] no chat global para mostrar uma dica interativa do item que está segurando, para os outros inspecionarem.
• Um moderador envia uma mensagem formatada no chat usando placeholders e prévias 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

• Baixe o JAR oficial do plugin e os plugins de dependência necessários.
• Coloque o InteractiveChat.jar (e os jars de dependência) no diretório plugins/ do servidor.
• Inicie o servidor.
• Edite a configuração do plugin, se necessário, e reinicie o servidor para aplicar as mudanças.

📦 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 você planeja usar o plugin com BungeeCord ou Velocity, instale o InteractiveChat tanto no proxy quanto nos servidores backend e ative a opção proxy/bungeecord na configuração do InteractiveChat em cada servidor backend.

🧠 Notas técnicas

• O plugin modifica o chat no nível do pacote; ele exige uma biblioteca de pacotes (ProtocolLib ou PacketEvents) para interceptar/modificar mensagens nos servidores backend.
• Suporte a proxy: BungeeCord e Velocity são suportados; para ativar placeholders e menções entre servidores, o plugin precisa 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 tags de fonte personalizada são suportados para servidores/clientes que suportam esses recursos (o comportamento RGB requer suporte do servidor/cliente, normalmente disponível em 1.16+).

🤝 Quando este plugin é útil

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