JamLib — una biblioteca técnica para otros mods de Minecraft

JamLib — una biblioteca técnica para otros mods de Minecraft

JamLib es un mod de biblioteca para Minecraft que, por sí solo, no añade objetos, bloques, mobs ni estructuras al juego. Es un envoltorio utilitario que ofrece a los autores de otros mods lo siguiente: una abstracción de plataforma entre loaders, un sistema de archivos de configuración ya preparado y un detector de archivos jar reempaquetados. Sin esta biblioteca, los mods que la requieren simplemente no se iniciarán.

Qué hace el mod

La biblioteca resuelve tres tareas para el desarrollador a la vez:

• Abstracciones de plataforma basadas en Architectury: el mismo código funciona en Fabric, Forge, NeoForge y Quilt sin ramas separadas.

• Una API de configuración en formato JSON5 con una pantalla de ajustes automática dentro del juego.

• Comprobación del archivo jar de un mod en busca de señales de reempaquetado desde «espejos» piratas.

Desde el punto de vista del jugador, la biblioteca no añade nada a la jugabilidad. Lo único que se puede notar es un nuevo elemento en el menú de mods para cualquier mod que use JamLib para sus ajustes. Si tales mods están presentes en el pack, en la ventana correspondiente aparecerá una página con deslizadores, interruptores y campos de entrada, generada automáticamente.

Configuraciones JSON5

El JSON estándar no permite comentarios en el código. JSON5, con el que trabaja la biblioteca a través de la dependencia Jankson, sí lo permite. En la práctica esto significa que los archivos de ajustes de los mods construidos sobre JamLib se ven como .json5 y ya contienen comentarios que describen cada parámetro junto con su valor predeterminado justo encima.

Los archivos conservan las modificaciones del usuario al reescribirse: si añades tu propia nota con una línea //, se mantendrá en su sitio después de que se guarde la configuración de nuevo. Las bibliotecas JSON estándar no pueden hacer esto.

Las pantallas de ajustes se generan por separado. En Fabric y Quilt, la interfaz se integra a través del menú de mods estándar; en Forge y NeoForge, a través de la API de pantallas de configuración integrada del loader. Los autores de mods no necesitan escribir una GUI a mano: JamLib toma los campos de la clase de configuración y construye widgets con validación para ellos: rangos numéricos, una expresión regular para cadenas, avisos sobre la necesidad de reiniciar el juego.

Detector de mods reempaquetados

Una función aparte comprueba si el archivo .jar del mod instalado se descargó de una fuente oficial. Algunos sitios reempaquetan mods con sus propios nombres y a veces incluyen software de terceros. JamLib compara el nombre real del archivo con el campo JamLib-File-Name de su manifiesto. Si no coinciden, se muestra una advertencia en el chat tras cargar el mundo. El mensaje se muestra una vez por cada archivo sospechoso, tras lo cual se recuerda el nombre de ese .jar.

La comprobación solo se aplica a los mods cuyos autores añadieron deliberadamente JamLib-File-Name a su manifiesto (es decir, mods del mismo desarrollador o de quienes integraron esta función manualmente). La biblioteca no escanea todos los .jar de la carpeta mods en busca de virus o código malicioso: no es un antivirus.

Conclusión

JamLib libera al desarrollador de un mod de escribir manualmente un sistema de configuración y una abstracción de plataforma para cuatro loaders a la vez. Instalar JamLib solo tiene sentido junto con un mod dependiente que lo requiera. Si un pack no tiene ningún mod de JamCoreModding ni de otro autor externo basado en esta biblioteca, el .jar de JamLib simplemente quedará en la carpeta mods sin un rol activo.