Cloth Config API — mod per le schermate di configurazione in Minecraft

Cloth Config API — mod per le schermate di configurazione in Minecraft

Cloth Config API è una libreria richiesta da decine di modifiche in Minecraft per mostrare le proprie impostazioni sotto forma di menu nel gioco anziché in un file di testo. Di per sé non aggiunge nulla al gioco: né oggetti, né blocchi, né nuove meccaniche. È una dipendenza: senza di essa i mod che l'hanno collegata non si avviano e segnalano un errore nell'elenco delle modifiche.

Quando serve il mod

La libreria non si installa da sola, ma insieme ad altre modifiche. Si può capire se serve per una determinata raccolta in due modi:

• Nella descrizione del mod su Modrinth o CurseForge, nell'elenco Dependencies è indicato Cloth Config API.

• Il gioco si chiude all'avvio della raccolta e nel registro (logs/latest.log) compare un riferimento all'assenza di cloth-config o cloth-config-2.

Il nome interno cloth-config-2 appartiene allo stesso mod: è l'identificatore comparso a partire dalla seconda versione principale della libreria. Se qualcuno scrive «serve cloth-config-2», si tratta della versione moderna di Cloth Config API.

Come aprire le impostazioni del mod

Su Forge e NeoForge l'elenco delle modifiche installate è integrato nel menu principale del gioco — la voce Mods. Accanto a ogni mod che ha collegato Cloth Config compare un'icona delle impostazioni. Il clic apre una schermata separata con tutti i parametri proprio di quella modifica.

Su Fabric non c'è un elenco standard dei mod nel loader, perciò l'accesso alle schermate di Cloth Config si realizza tramite uno strumento esterno di visualizzazione delle modifiche — mostra l'elenco di ciò che è installato e consente di cliccare il pulsante accanto alla voce desiderata.

Impostazioni del mod con l'aiuto di Cloth Config 

Come appare la schermata stessa

Tutte le schermate del mod sono costruite secondo lo stesso schema: a sinistra le categorie dei parametri, al centro i parametri stessi, in basso i pulsanti Salva e Annulla. Ogni parametro è rappresentato da un elemento dell'interfaccia corrispondente al tipo del suo valore. 

Nella parte superiore della schermata, per le configurazioni con decine di parametri, c'è un campo di ricerca — filtra l'elenco per nome. Accanto ai parametri per cui l'autore della modifica ha impostato una descrizione, al passaggio del cursore compare un suggerimento con la spiegazione.

Se si inserisce un valore al di fuori dell'intervallo consentito o in un formato non ammesso, il campo si evidenzia e il pulsante di salvataggio diventa inattivo finché l'errore non viene corretto. Accanto a ogni parametro c'è un pulsante di ripristino — riporta il valore a quello che l'autore della modifica ha indicato come predefinito.

Conclusione

Cloth Config API è una dipendenza infrastrutturale: senza di essa una parte delle modifiche semplicemente non si avvia, ma il mod in sé non offre nel gioco nulla di visibile senza altri mod collegati. Il suo ruolo è ricondurre le impostazioni delle diverse modifiche in Minecraft a uno standard visivo comune anziché a una decina di interfacce eterogenee. Su Fabric e nelle raccolte multipiattaforma Cloth Config API rimane lo standard condiviso più diffuso.