Cloth Config API — mod para pantallas de configuración en Minecraft

Cloth Config API — mod para pantallas de configuración en Minecraft

Cloth Config API es una biblioteca que decenas de modificaciones de Minecraft requieren para mostrar sus ajustes en forma de menú dentro del juego en lugar de un archivo de texto. Por sí misma no añade nada al juego: ni objetos, ni bloques, ni mecánicas nuevas. Es una dependencia: sin ella los mods que la han vinculado no se inician y muestran un error en la lista de modificaciones.

Cuándo se necesita el mod

La biblioteca no se instala por sí sola, sino junto con otras modificaciones. Saber si hace falta para un paquete concreto se puede hacer de dos maneras:

• En la descripción del mod en Modrinth o CurseForge, en la lista Dependencies aparece Cloth Config API.

• El juego se cierra al iniciar el paquete y en el registro (logs/latest.log) aparece una mención a la ausencia de cloth-config o cloth-config-2.

El nombre interno cloth-config-2 pertenece al mismo mod: es el identificador que apareció a partir de la segunda versión principal de la biblioteca. Si alguien escribe «se necesita cloth-config-2», se refiere a la versión moderna de Cloth Config API.

Cómo abrir la configuración del mod

En Forge y NeoForge la lista de modificaciones instaladas está integrada en el menú principal del juego — la opción Mods. Junto a cada mod que ha vinculado Cloth Config aparece un icono de configuración. El clic abre una pantalla independiente con todos los parámetros de esa modificación en concreto.

En Fabric no hay una lista estándar de mods en el cargador, por lo que el acceso a las pantallas de Cloth Config se realiza mediante una herramienta externa de visualización de modificaciones — muestra la lista de lo instalado y permite pulsar el botón junto al elemento deseado.

Configuración del mod con ayuda de Cloth Config 

Cómo se ve la pantalla en sí

Todas las pantallas del mod están construidas según el mismo esquema: a la izquierda, las categorías de parámetros; en el centro, los propios parámetros; abajo, los botones Guardar y Cancelar. Cada parámetro se muestra con un elemento de la interfaz que corresponde al tipo de su valor. 

En la parte superior de la pantalla, para las configuraciones con decenas de parámetros, hay un campo de búsqueda — filtra la lista por nombre. Junto a los parámetros para los que el autor de la modificación definió una descripción, al pasar el cursor aparece una sugerencia con la explicación.

Si se introduce un valor fuera del rango permitido o en un formato no admitido, el campo se resalta y el botón de guardar queda inactivo hasta que se corrige el error. Junto a cada parámetro hay un botón de restablecer — devuelve el valor al que el autor de la modificación marcó como predeterminado.

Conclusión

Cloth Config API es una dependencia de infraestructura: sin ella una parte de las modificaciones simplemente no se inicia, pero el propio mod no aporta nada visible en el juego sin otros mods vinculados. Su papel es reducir la configuración de las distintas modificaciones de Minecraft a un estándar visual común en lugar de una decena de interfaces de distinto tipo. En Fabric y en los paquetes multiplataforma, Cloth Config API sigue siendo el estándar común más extendido.