Paginated Advancements & Custom Frames — Minecraft Java Edition 1.18.1 - 26.1+

La interfaz vanilla de logros limita la visualización de pestañas. La ventana estándar tiene un ancho y un alto fijos, calculados solo para seis pestañas. Si se instala un paquete grande de modificaciones, donde cada mod importante añade su propia rama de progresión, las nuevas pestañas empiezan a salirse de los límites de la pantalla, a superponerse entre sí o a desaparecer por completo de la interfaz. La modificación Paginated Advancements & Custom Frames amplía la ventana estándar del menú de logros, añadiendo navegación por páginas, un sistema para fijar las ramas prioritarias, una herramienta de depuración integrada y la compatibilidad con marcos totalmente nuevos para los iconos mediante paquetes de recursos o paquetes de datos.

Principio técnico de funcionamiento y solución de las limitaciones de la interfaz vanilla

La clase vanilla AdvancementsScreen utiliza coordenadas codificadas de forma fija para renderizar la ventana de logros (el tamaño es de 252 por 140 píxeles). Los elementos de control, como la cuadrícula de pestañas y el renderizado del fondo, están vinculados a dimensiones de ventana estáticas, lo que imposibilita el escalado para una alta resolución de monitor. La clase AdvancementTab también tiene límites rígidos para dibujar los iconos de las pestañas en el perímetro del marco principal.

Paginated Advancements & Custom Frames introduce cambios directamente en la lógica de renderizado de la interfaz gráfica del cliente mediante inyecciones Mixin en las clases MixinAdvancementsScreen y MixinAdvancementTab. En lugar de usar constantes codificadas de forma fija, la modificación intercepta la inicialización de la interfaz y lee las dimensiones actuales de la ventana del juego. A partir de estos datos se calcula el tamaño óptimo del marco de logros, que se amplía de forma adaptativa ocupando la mayor parte de la pantalla.

El sistema agrupa automáticamente todas las pestañas registradas en páginas separadas (paginación). El algoritmo calcula el número máximo de pestañas que pueden caber dentro de los límites de los paneles superior e inferior de la ventana mediante una fórmula que tiene en cuenta el ancho de la ventana y los márgenes establecidos. Si el número de ramas de logros supera el límite de la página, la modificación crea páginas virtuales adicionales y añade botones de flecha interactivos en la parte inferior de la interfaz. Al cambiar de página, el renderizador oculta las pestañas de las páginas inactivas, evitando la sobrecarga de la memoria RAM con objetos gráficos y eliminando los conflictos de superposición de elementos.

Características y funcionalidad principales

La función principal de Paginated Advancements & Custom Frames es la reorganización del menú gráfico de logros. La modificación ofrece varias herramientas prácticas para la navegación:

·        Paginación dinámica: Añade flechas para cambiar de página en la esquina inferior de la ventana de logros. Los jugadores pueden examinar cualquier número de pestañas, incluso si en el paquete hay activadas más de cincuenta modificaciones con sus propias cadenas de tareas.

·        Fijación de pestañas: El usuario puede añadir cualquier pestaña a la lista de favoritas. Para ello hay un botón especial en forma de estrella en cada pestaña. Una pestaña fijada se mueve automáticamente a la primera página y se muestra al principio de la lista, independientemente de su orden de clasificación alfabético o interno del juego.

·        Conservación del estado de la sesión: El mod recuerda la última pestaña de logros abierta. En caso de cerrar el menú y volver a abrirlo con la tecla L, la interfaz mostrará la misma pestaña en la que el jugador se detuvo, en lugar de restablecerse a la primera pestaña estándar.

·        Depurador de logros (Advancement Debugger): Un modo especial para desarrolladores de paquetes y autores de misiones. Se activa en la configuración o al habilitar las descripciones emergentes avanzadas (teclas F3 + H). Al pasar el cursor sobre un icono de logro, se muestra una ventana emergente adicional con información técnica: el identificador interno (por ejemplo, minecraft:adventure/arbalistic) y la lista de desencadenadores (condiciones) necesarios para su cumplimiento. La combinación de teclas Ctrl + C copia el identificador del logro seleccionado al portapapeles.

Configuración, compatibilidad y ecosistema

El usuario puede cambiar los parámetros de visualización del menú de logros a través del archivo de configuración. La ubicación y el formato del archivo dependen del cargador de modificaciones:

·        Fabric y Quilt: Para que la configuración funcione, es necesario instalar la biblioteca Cloth Config API. Los parámetros se escriben en el archivo paginatedadvancements.json (o paginatedadvancements.json5) en la carpeta config.

·        NeoForge: Las versiones del mod a partir de la 2.8.0 utilizan el sistema de configuración integrado de NeoForge, lo que elimina la necesidad de bibliotecas adicionales. El archivo se genera con el nombre paginatedadvancements-client.toml en la carpeta config.

En el archivo de configuración están disponibles los siguientes parámetros clave:

·        showDebugTooltips – un valor booleano (true o false) que controla la visualización de la información técnica para la depuración de logros.

·        maxDebugLines – un número entero que limita el número máximo de líneas de desencadenadores en la ventana emergente, evitando que el texto se salga de la pantalla cuando hay un gran número de requisitos.

·        disableBackgroundFade – un parámetro para desactivar el oscurecimiento del fondo del juego durante la visualización del menú de logros.

·        spacing – el paso en píxeles para ajustar la distancia entre pestañas adyacentes en el panel.

·        enablePinning – permite o prohíbe a los jugadores fijar las pestañas seleccionadas.

La modificación admite un sistema de personalización de iconos mediante el mecanismo Custom Frames (marcos personalizados). De forma predeterminada, Minecraft ofrece tres tipos de marcos: task (tarea normal), goal (objetivo) y challenge (desafío). El mod permite crear nuevos tipos mediante paquetes de datos.

Para añadir un nuevo marco es necesario crear un archivo JSON en el paquete de datos en la siguiente ruta:

assets/<identificador_del_mod>/advancement_frame_types/<nombre_del_marco>.json

Ejemplo del contenido del archivo:

Las texturas del marco se colocan en las siguientes rutas:

·       assets/<identificador_del_mod>/textures/gui/sprites/advancements/<nombre_del_marco>_unobtained.png – aspecto del marco antes de completar el logro.

·      assets/<identificador_del_mod>/textures/gui/sprites/advancements/<nombre_del_marco>_obtained.png – aspecto del marco después de completarlo.

Para vincular el marco creado a un logro concreto se utiliza un archivo de mapeo en el paquete de datos en la ruta assets/<identificador_del_mod>/advancement_frames/<nombre_del_archivo>.json:

El mod se desarrolló como una utilidad puramente del lado del cliente, por lo que no requiere instalación en el servidor. Es totalmente compatible con grandes mods industriales y mágicos (como Create, Ender IO, Botania) que añaden complejos sistemas de misiones y numerosas pestañas de logros. Para los usuarios del antiguo cargador Forge está disponible una adaptación no oficial del mod con el nombre de ForgedPaginatedAdvancements. Para ejecutar las últimas versiones del mod en la plataforma NeoForge 26.1+ es obligatorio el uso del entorno de ejecución Java 25.

Conclusión

Paginated Advancements & Custom Frames resuelve de forma eficaz el problema del espacio limitado de la interfaz vanilla de logros, que se vuelve crítico en los grandes paquetes de modificaciones. A diferencia de su análogo Better Advancements, que principalmente escala la ventana sin añadir páginas, este mod ofrece una clara división en páginas y una cómoda fijación de pestañas. La modificación simplifica el trabajo de los desarrolladores de paquetes modificados gracias al depurador integrado y al flexible sistema de registro de nuevos tipos de marcos mediante las estructuras JSON de los paquetes de datos. La única limitación notable es la necesidad de crear paquetes de recursos del cliente adicionales para la correcta visualización de los marcos gráficos personalizados.