Plugin Minecraft BKCommonLib

🔌 Sobre o BKCommonLib

BKCommonLib é uma biblioteca e plugin do lado do servidor para servidores Minecraft que centraliza utilitários de baixo nível, helpers de reflection, remapeamento em tempo de execução e pequenos frameworks, para que outros plugins não precisem usar NMS (internals do servidor Minecraft) diretamente. Ele foi projetado para ser uma única camada de compatibilidade: quando o Minecraft ou forks do servidor mudam internals, o BKCommonLib é atualizado para que os plugins dependentes muitas vezes não precisem mudar nada.

🎯 Objetivo

Fornecer uma camada estável e reutilizável de compatibilidade e utilitários para desenvolvedores de plugins e administradores de servidor. O BKCommonLib reduz a quantidade de código específico de versão que os autores de plugins precisam distribuir e expõe APIs de nível mais alto para manipulação de pacotes, conversões, frameworks de comandos e outras operações de baixo nível.

⚙️ Recursos

• Geração e remapeamento de classes em tempo de execução via o sistema de reflection/template do Mountiplex.
• Utilitários de framework de comandos integrados (integração com o Cloud Command Framework).
• Framework base para plugins com helpers de ciclo de vida, verificações de dependências e APIs práticas para registrar listeners e comandos.
• Utilitários de conversão de tipos (conversões automáticas entre tipos Bukkit e tipos internos quando necessário).
• Utilitários e camadas de compatibilidade para muitos forks e versões de servidor, evitando que os plugins usem NMS diretamente.

🧩 Para quem é

• Desenvolvedores de plugins que querem uma camada de compatibilidade multi-versão e utilitários de reflection.
• Administradores de servidor que operam redes com muitos plugins de terceiros que dependem de uma biblioteca de compatibilidade comum.
• Operadores técnicos de servidores que precisam de comportamento consistente entre forks do Paper/Spigot.

🏗️ Casos de uso de exemplo

• Um plugin usa o BKCommonLib para lidar com diferenças de pacotes entre versões do Minecraft, para que o próprio jar do plugin possa permanecer inalterado entre atualizações.
• Um desenvolvedor usa os utilitários de framework de comandos incluídos para implementar comandos anotados com suporte a sugestões e tratamento de permissões.
• Um servidor executa plugins que dependem do BKCommonLib para reduzir a frequência de atualizações imediatas após o lançamento de uma versão do Minecraft.

⚙️ Instalação

📥 Configuração

• Baixe o jar oficial do BKCommonLib na distribuição oficial do plugin (coloque o jar fornecido na pasta plugins/ do seu servidor).
• Reinicie o servidor para que o plugin carregue durante a inicialização.
• Verifique a saída do console do servidor em busca das mensagens de inicialização do BKCommonLib para confirmar que ele foi iniciado corretamente.

📦 Dependências

• O BKCommonLib é distribuído como um plugin de biblioteca; não são necessárias dependências adicionais de plugins Bukkit/Spigot para a biblioteca principal em si.

🧠 Observações técnicas

• O software de servidor compatível confirmado inclui forks do Spigot e do Paper (o projeto lista explicitamente Spigot, PaperMC, Purpur e outros forks comuns).
• O projeto declara compatibilidade com versões do Minecraft 1.8 e mais novas ao usar a versão mais recente do BKCommonLib.
• O BKCommonLib é lançado sob a licença MIT.
• O projeto empacota/oculta bibliotecas de terceiros (por exemplo, Cloud Command Framework, ASM, Javassist, Objenesis, SnakeYAML e Gson), conforme observado pelo autor.

🤝 Quando este plugin é útil

Se você mantém plugins ou administra um servidor em que vários plugins precisam de acesso consistente a recursos de baixo nível do servidor sem que cada plugin lide com NMS, o BKCommonLib oferece uma camada de compatibilidade compartilhada e utilitários para desenvolvedores que reduzem o código específico de versão por plugin e o esforço de manutenção.