Plugin Minecraft nightcore

🔌 Sobre o NightCore

NightCore é uma biblioteca leve para o desenvolvimento de plugins de servidor Minecraft. Ela oferece utilitários reutilizáveis, ferramentas de dados e pontes de integração para que outros plugins não precisem reimplementar funcionalidades comuns. O projeto é distribuído sob a GPL-3.0 e é mantido junto de um conjunto de plugins que dependem dele.

🎯 Objetivo

O NightCore existe para centralizar preocupações comuns dos desenvolvedores (configuração, localização, helpers de base de dados, parsing de comandos, pontes para itens e economia, etc.) para que os autores de plugins possam focar na lógica das funcionalidades em vez da infraestrutura. É útil para desenvolvedores e administradores de servidores que executam ou colocam em funcionamento vários plugins alimentados por NightExpress/NightCore.

⚙️ Funcionalidades

• Ponte de servidor que oferece suporte unificado para Spigot, Paper e Folia.
• Ponte de economia para integração com vários plugins de moeda/economia.
• Ponte de itens e suporte a fornecedor de itens personalizados para sistemas de itens de terceiros.
• Ponte de permissões para integrar com diferentes plugins de permissões.
• Utilitários de comandos: parsing de argumentos, tipos de argumentos personalizados e helpers de conclusão por tab.
• Ferramentas de configuração YAML com leitura/escrita ao estilo de esquema e preservação de comentários.
• Ferramentas de localização para ficheiros de idioma estruturados e mensagens parametrizadas.
• Ferramentas de base de dados com suporte para SQLite e MySQL e helpers para sincronizar dados de tabelas.
• Utilitários de interface gráfica de inventário e de ecrã de diálogo.
• Helpers e wrappers de utilidade para jogador, entidade, localização e ItemStack.
• Helpers de PersistentDataContainer e utilitários de reflexão para tarefas avançadas.
• Rastreador de blocos colocados por jogadores que armazena os dados de colocação no armazenamento nativo de chunks.

🧩 Para quem é

• Desenvolvedores de plugins que criam ou mantêm plugins Spigot/Paper/Folia, especialmente a família de plugins NightExpress.
• Administradores de servidores que implantam vários plugins e preferem uma camada partilhada de utilitários.

🏗️ Exemplos de uso

• Um plugin usa a ponte de economia do NightCore para interagir com o plugin de economia que estiver presente no servidor.
• Um desenvolvedor usa os esquemas de configuração e localização do NightCore para evitar escrever código repetitivo de gestão de ficheiros.
• Um servidor instala um plugin NightExpress que requer o NightCore como biblioteca partilhada.

⚙️ Instalação

📥 Configuração

• Faça o download do JAR oficial do plugin NightCore na página de distribuição do projeto.
• Coloque o JAR no diretório plugins/ do seu servidor, juntamente com outros plugins compatíveis com Bukkit.
• Reinicie o servidor e verifique na consola se o NightCore foi carregado com sucesso.

📦 Dependências

• Não há dependências externas obrigatórias documentadas; o NightCore fornece pontes para integração com sistemas comuns (economia, permissões, itens personalizados) quando esses sistemas estão presentes.

🧠 Notas técnicas

• Plataformas suportadas confirmadas: Spigot, Paper, Purpur e Folia.
• As entradas de compatibilidade documentadas incluem intervalos modernos de versões do Minecraft (exemplos mostrados nas páginas oficiais de distribuição). Os proprietários de servidores devem usar a build do NightCore que corresponda à versão do Minecraft do seu servidor.
• Licenciado sob GPL-3.0.

🤝 Quando este plugin é útil

Se mantém ou desenvolve plugins que precisam de utilitários comuns de servidor (configuração, localização, helpers de BD, parsing de comandos, integração com economia/itens/permissões), o NightCore reduz o trabalho duplicado ao fornecer uma camada de biblioteca partilhada e mantida.