Plugin Minecraft ItemJoin

🔌 Sobre o ItemJoin

O ItemJoin é um plugin de Minecraft para entregar automaticamente itens personalizados altamente configuráveis aos jogadores. Os itens podem ser concedidos em eventos como join, first-join, respawn, world-switch, region-enter e region-leave. O plugin foca em definições flexíveis de itens (itemflags), eventos acionadores e comandos vinculados aos itens, para que servidores possam oferecer menus de lobby, kits iniciais ou ferramentas sensíveis ao contexto sem mods customizados no cliente.

🎯 Objetivo

O ItemJoin resolve o problema de fornecer de forma confiável itens personalizados ou interativos ligados a eventos e mundos do servidor. Ele é útil para servidores de hub/lobby, servidores de minigame, redes de survival (onde os itens precisam ser limitados por mundo) e redes que precisam de menus acionados por itens ou itens que executam comandos.

⚙️ Recursos

• Conceda itens em gatilhos configuráveis: join, first-join, respawn, world-switch, region-enter/exit e eventos semelhantes.
• itemflags por item que alteram o comportamento (slot, overwrite, regras de stack, bloqueio de movimento/coleta, limites de gamemode, chance de receber, cooldowns).
• ItemCommands: associe comandos aos itens e configure o contexto de execução (console, player, server, message) e os tipos de ação (clique esquerdo/direito, clique no inventário, físico, multi-clique).
• Integração com PlaceholderAPI para nomes/lore dinâmicos dos itens e suporte a placeholders.
• Suporte a cabeças de jogador personalizadas (texturas e donos personalizados), imagens em mapas, tipped arrows, livros, banners, fogos de artifício, personalização de armaduras de couro e níveis de encantamento personalizados.
• Opcionalmente bloqueia o movimento ou a coleta de itens em mundos específicos e restringe itens por endereço IP ou estado de first-join.
• Criador de GUI in-game para montar conjuntos de itens e fluxo integrado de importação/criação.
• API para outros plugins: disponível em me.RockinChaos.itemjoin.api.ItemJoinAPI.

🧩 Para quem é

• Donos de servidor que precisam de itens automáticos de lobby/hub ou kits iniciais.
• Operadores de minigames e redes que precisam de itens específicos por mundo ou bússolas de menu.
• Desenvolvedores que querem um sistema de itens com hooks via API.

🏗️ Casos de uso de exemplo

• Dar aos jogadores uma bússola de menu ao entrar, que executa comandos diferentes ao clicar.
• Fornecer kits iniciais únicos no first-join enquanto impede a transferência de itens entre mundos especificados.
• Criar itens interativos que executam comandos de economia/loja com cooldowns e custos.

⌨️ Comandos

Observação: esses comandos e subcomandos foram retirados do conjunto de comandos documentado do plugin. O plugin fornece subcomandos adicionais na wiki e na saída de ajuda gerada.

🔐 Permissões

O comportamento das permissões específicas de itens é configurável; as verificações de permissão de itens vêm desativadas por padrão e precisam ser habilitadas na configuração do plugin para surtirem efeito.

⚙️ Instalação

📥 Configuração

• Baixe o jar oficial do ItemJoin e coloque-o na pasta plugins/ do seu servidor.
• Certifique-se de que não existam arquivos jar duplicados do ItemJoin em plugins/ (por exemplo, ItemJoin(1).jar).
• Reinicie o servidor para que o plugin gere sua configuração e registre os recursos para a versão do seu servidor.
• Verifique os logs do console do servidor para confirmar o carregamento do plugin e consulte a wiki do plugin para uma configuração detalhada.

📦 Dependências

O plugin não possui requisitos obrigatórios em tempo de execução, mas lista várias soft-dependencies e integrações comuns (opcionais e ativadas quando presentes):

• Vault
• AuthMe
• BetterNick
• HeadDatabase
• PlaceholderAPI
• SkinRestorerX
• TokenEnchant
• WorldEdit
• WorldGuard

Ative ou configure as integrações conforme necessário; o plugin funciona sem elas, mas recursos como placeholders, cabeças/skins personalizadas e hooks de economia dependem dos plugins correspondentes.

🧠 Notas técnicas

• Plataformas: confirmado para servidores no estilo Spigot (Spigot, Bukkit, Paper, Purpur, Folia).
• Intervalo do Minecraft suportado/testado: 1.8 até 1.21.
• O código-fonte e os releases são publicados, e o projeto expõe uma API em me.RockinChaos.itemjoin.api.ItemJoinAPI para outros plugins integrarem.
• Licença: LGPL-3.0.

🤝 Quando este plugin é útil

Se você precisa de um sistema flexível e configurável para fornecer aos jogadores itens interativos e com contexto (menus, kits iniciais, ferramentas específicas por mundo) e quer uma API para integrações, o ItemJoin oferece esses recursos com suporte a plugins comuns de placeholders e skins.