Plugin de Minecraft BKCommonLib

🔌 Acerca de BKCommonLib

BKCommonLib es una biblioteca y plugin del lado del servidor para servidores de Minecraft que centraliza utilidades de bajo nivel, helpers de reflection, remapeo en tiempo de ejecución y pequeños frameworks, para que otros plugins no tengan que usar NMS (internals del servidor Minecraft) directamente. Está diseñado para ser una única capa de compatibilidad: cuando Minecraft o los forks del servidor cambian sus internals, BKCommonLib se actualiza para que los plugins dependientes a menudo no necesiten cambios por sí mismos.

🎯 Propósito

Proporcionar una capa estable y reutilizable de compatibilidad y utilidades para desarrolladores de plugins y administradores de servidores. BKCommonLib reduce la cantidad de código específico de versión que los autores de plugins deben distribuir y expone APIs de mayor nivel para el manejo de paquetes, conversiones, frameworks de comandos y otras operaciones de bajo nivel.

⚙️ Características

• Generación y remapeo de clases en tiempo de ejecución mediante el sistema de reflection/template de Mountiplex.
• Utilidades integradas para el framework de comandos (integración con Cloud Command Framework).
• Framework base para plugins con helpers de ciclo de vida, comprobaciones de dependencias y APIs prácticas para registrar listeners y comandos.
• Utilidades de conversión de tipos (conversiones automáticas entre tipos Bukkit y tipos internos cuando sea necesario).
• Utilidades y capas de compatibilidad para muchos forks y versiones de servidor, de modo que los plugins eviten usar NMS directamente.

🧩 Para quién es

• Desarrolladores de plugins que quieren una capa de compatibilidad multiversión y utilidades de reflection.
• Administradores de servidores que ejecutan redes con muchos plugins de terceros que dependen de una biblioteca de compatibilidad común.
• Operadores técnicos de servidores que necesitan un comportamiento consistente entre forks de Paper/Spigot.

🏗️ Casos de uso de ejemplo

• Un plugin usa BKCommonLib para manejar diferencias de paquetes entre versiones de Minecraft, de modo que el propio jar del plugin pueda permanecer sin cambios entre actualizaciones.
• Un desarrollador usa las utilidades de framework de comandos incluidas para implementar comandos anotados con soporte para sugerencias y gestión de permisos.
• Un servidor ejecuta plugins que dependen de BKCommonLib para reducir la frecuencia de actualizaciones inmediatas después de una versión de Minecraft.

⚙️ Instalación

📥 Configuración

• Descarga el jar oficial de BKCommonLib desde la distribución oficial del plugin (coloca el jar proporcionado en la carpeta plugins/ de tu servidor).
• Reinicia el servidor para que el plugin cargue durante el inicio.
• Revisa la salida de la consola del servidor en busca de los mensajes de inicio de BKCommonLib para confirmar que se inicializó correctamente.

📦 Dependencias

• BKCommonLib se distribuye como un plugin de biblioteca; no se requieren dependencias adicionales de plugins Bukkit/Spigot para la biblioteca principal en sí.

🧠 Notas técnicas

• El software de servidor compatible confirmado incluye forks de Spigot y Paper (el proyecto enumera explícitamente Spigot, PaperMC, Purpur y otros forks comunes).
• El proyecto indica compatibilidad con versiones de Minecraft 1.8 y superiores al usar la versión más reciente de BKCommonLib.
• BKCommonLib se publica bajo la licencia MIT.
• El proyecto incluye/oculta bibliotecas de terceros (por ejemplo, Cloud Command Framework, ASM, Javassist, Objenesis, SnakeYAML y Gson), según indica el autor.

🤝 Cuándo es útil este plugin

Si mantienes plugins o administras un servidor en el que varios plugins necesitan acceso coherente a funciones de bajo nivel del servidor sin que cada plugin gestione NMS, BKCommonLib ofrece una capa de compatibilidad compartida y utilidades para desarrolladores que reducen el código específico de versión por plugin y la carga de mantenimiento.