Plugin de Minecraft nightcore

🔌 Acerca de NightCore

NightCore es una biblioteca ligera para el desarrollo de plugins de servidores Minecraft. Proporciona utilidades reutilizables, herramientas de datos y puentes de integración para que otros plugins no tengan que reimplementar funcionalidades comunes. El proyecto se distribuye bajo GPL-3.0 y se mantiene junto con un conjunto de plugins que dependen de él.

🎯 Propósito

NightCore existe para centralizar las necesidades comunes de los desarrolladores (configuración, localización, helpers de base de datos, análisis de comandos, puentes de ítems y economía, etc.) para que los autores de plugins puedan centrarse en la lógica de las funciones en lugar de en la infraestructura. Es útil para desarrolladores y administradores de servidores que ejecutan o despliegan varios plugins impulsados por NightExpress/NightCore.

⚙️ Funcionalidades

• Puente de servidor con soporte unificado para Spigot, Paper y Folia.
• Puente de economía para integrarse con varios plugins de moneda/economía.
• Puente de ítems y soporte para proveedores de ítems personalizados para sistemas de ítems de terceros.
• Puente de permisos para integrarse con distintos plugins de permisos.
• Utilidades de comandos: análisis de argumentos, tipos de argumentos personalizados y helpers de autocompletado.
• Herramientas de configuración YAML con lectura/escritura estilo esquema y preservación de comentarios.
• Herramientas de localización para archivos de idioma estructurados y mensajes parametrizados.
• Herramientas de base de datos con soporte para SQLite y MySQL y helpers para sincronizar datos de tablas.
• Utilidades de GUI de inventario y de pantalla de diálogo.
• Helpers y wrappers de utilidad para jugador, entidad, ubicación e ItemStack.
• Helpers de PersistentDataContainer y utilidades de reflexión para tareas avanzadas.
• Rastreador de bloques colocados por jugadores que almacena los datos de colocación en el almacenamiento nativo de chunks.

🧩 Para quién es

• Desarrolladores de plugins que crean o mantienen plugins Spigot/Paper/Folia, especialmente la familia de plugins NightExpress.
• Administradores de servidores que despliegan varios plugins y prefieren una capa de utilidades compartida.

🏗️ Casos de uso de ejemplo

• Un plugin usa el puente de economía de NightCore para interactuar con el plugin de economía que esté presente en el servidor.
• Un desarrollador usa los esquemas de configuración y localización de NightCore para evitar escribir código repetitivo de manejo de archivos.
• Un servidor instala un plugin NightExpress que requiere NightCore como biblioteca compartida.

⚙️ Instalación

📥 Configuración

• Descarga el JAR oficial del plugin NightCore desde la página de distribución del proyecto.
• Coloca el JAR en el directorio plugins/ de tu servidor junto con otros plugins compatibles con Bukkit.
• Reinicia el servidor y verifica en la consola que NightCore se haya cargado correctamente.

📦 Dependencias

• No se documentan dependencias externas obligatorias; NightCore ofrece puentes para integrarse con sistemas comunes (economía, permisos, ítems personalizados) cuando esos sistemas están presentes.

🧠 Notas técnicas

• Plataformas compatibles confirmadas: Spigot, Paper, Purpur y Folia.
• Las entradas de compatibilidad documentadas incluyen rangos modernos de versiones de Minecraft (ejemplos mostrados en las páginas oficiales de distribución). Los propietarios de servidores deberían usar la build de NightCore que coincida con la versión de Minecraft de su servidor.
• Licenciado bajo GPL-3.0.

🤝 Cuándo es útil este plugin

Si mantienes o desarrollas plugins que necesitan utilidades comunes del servidor (configuración, localización, helpers de BD, análisis de comandos, integración con economía/ítems/permisos), NightCore reduce el trabajo duplicado al proporcionar una capa de biblioteca compartida y mantenida.