Plugin Minecraft BanItem

🔌 Sobre o BanItem

BanItem é um plugin de Minecraft que bloqueia ou coloca em whitelist itens específicos e comportamentos de itens por mundo. Ele atende às necessidades de administração de servidores em que certos itens precisam ser impedidos de ser usados, colocados, apanhados ou de outra forma interagidos. O projeto fornece uma API para desenvolvedores e é distribuído sob a licença GPL-3.0.

🎯 Objetivo

O BanItem existe para dar aos operadores de servidores controlo detalhado sobre quais itens os jogadores podem usar em cada mundo. Esse controlo pode ser aplicado como uma blacklist (bloquear os itens listados) ou uma whitelist (bloquear tudo, exceto os itens explicitamente permitidos), e as permissões podem ser aplicadas por mundo e por item.

⚙️ Funcionalidades

• Modo blacklist para bloquear itens e opções especificados.
• Modo whitelist para bloquear todos os itens/opções, exceto as entradas permitidas configuradas.
• Configuração por mundo para que mundos diferentes possam impor regras diferentes para itens.
• Permissões por mundo, por item e granularidade de permissões por opção.
• Suporte para itens personalizados/modded (itens identificados por dados/metadados específicos do item).
• Implementação leve que ativa apenas os listeners necessários para as opções configuradas.
• API para desenvolvedores para que outros plugins possam consultar ou modificar bans programaticamente.
• Requer Java 1.8 e qualquer servidor baseado em Bukkit.

🧩 Para quem é

• Proprietários e administradores de servidores que precisam remover ou restringir itens específicos.
• Servidores Survival e SMP que querem impedir itens poderosos ou que podem quebrar o servidor.
• Operadores de rede que gerem vários mundos com regras de itens diferentes.
• Programadores de plugins que precisam de uma API para interagir com banimentos de itens.

🏗️ Casos de uso de exemplo

• Impedir jogadores de usar elytra, shulker boxes ou totems em mundos Survival.
• Permitir um pequeno conjunto de itens num mundo de minijogo protegido, enquanto se proíbem todos os outros através do modo whitelist.
• Bloquear itens modded/personalizados adicionados por mods do lado do cliente em servidores que os aceitam.
• Integrar o BanItem com outro plugin administrativo através da sua API para impor regras automaticamente.

⚙️ Instalação

📥 Configuração

1. Confirme que o seu servidor executa um servidor compatível com Bukkit e Java 1.8+.
2. Faça o download do ficheiro JAR oficial do plugin e coloque-o na pasta plugins/ do seu servidor.
3. Reinicie o servidor e verifique a consola do servidor para garantir que o BanItem carrega com sucesso.

📦 Dependências

• Não há dependências de plugins obrigatórias documentadas.
• Requer uma implementação de servidor compatível com Bukkit e runtime Java 1.8 ou mais recente.

🧾 Configuração

• O plugin pode ser configurado por mundo e por item.
• O projeto fornece opções de configuração para os modos blacklist/whitelist e opções por item; os nomes exatos dos ficheiros e chaves são fornecidos na documentação do projeto.

🧠 Notas técnicas

• O BanItem anuncia suporte para qualquer servidor baseado em Bukkit; as versões oficiais são fornecidas para ambientes Spigot/Bukkit.
• Está disponível uma API para desenvolvedores para que outros plugins possam aceder ao BanItem programaticamente.
• O projeto é open-source sob a licença GPL-3.0.
• Última versão assinalada: v3.8 (9 de junho de 2026).

🤝 Quando este plugin é útil

Se precisa de controlo consistente, por mundo, sobre quais itens podem ser usados pelos jogadores (incluindo suporte para itens personalizados/modded) e de uma API para integração, o BanItem oferece uma solução leve focada em regras de restrição por item e por mundo.