Cloth Config API — een mod voor instellingenschermen in Minecraft

Cloth Config API — een mod voor instellingenschermen in Minecraft

Cloth Config API is een bibliotheek die door tientallen Minecraft-mods wordt vereist om hun instellingen als een menu in het spel te tonen in plaats van als een tekstbestand. Op zichzelf voegt ze niets aan het spel toe: geen voorwerpen, geen blokken, geen nieuwe mechanieken. Het is een afhankelijkheid — zonder haar zullen de mods die haar gebruiken niet starten en geven ze een fout weer in de modlijst.

Wanneer de mod nodig is

De bibliotheek wordt niet apart geïnstalleerd, maar samen met andere mods. Er zijn twee manieren om te bepalen of ze nodig is voor een bepaalde modpack:

• In de beschrijving van de mod op Modrinth of CurseForge staat Cloth Config API vermeld onder Dependencies.

• Het spel sluit bij het starten van de modpack, en in het logboek (logs/latest.log) verschijnt een vermelding van een ontbrekende cloth-config of cloth-config-2.

De interne naam cloth-config-2 hoort bij precies dezelfde mod — het is de identificatie die verscheen vanaf de tweede grote versie van de bibliotheek. Als iemand schrijft "je hebt cloth-config-2 nodig", dan gaat het om de moderne versie van Cloth Config API.

Hoe je de instellingen van een mod opent

Op Forge en NeoForge is de lijst met geïnstalleerde mods ingebouwd in het hoofdmenu van het spel — het item Mods. Naast elke mod die Cloth Config heeft gekoppeld, verschijnt een instellingenpictogram. Een klik opent een apart scherm met alle parameters van juist die mod.

Op Fabric is er geen standaard modlijst in de loader, dus de toegang tot de Cloth Config-schermen verloopt via een hulpmiddel van derden om mods te bekijken — het toont de lijst met geïnstalleerde mods en laat je op een knop naast het gewenste item klikken.

Instellingen van een mod met behulp van Cloth Config 

Hoe het scherm zelf eruitziet

Alle schermen van de mod zijn volgens hetzelfde schema opgebouwd: links de categorieën van parameters, in het midden de parameters zelf, en onderaan de knoppen Opslaan en Annuleren. Elke parameter wordt weergegeven met een interface-element dat overeenkomt met het type van zijn waarde. 

Bovenaan het scherm is er voor configs met tientallen parameters een zoekveld — het filtert de lijst op naam. Bij parameters waarvoor de maker van de mod een beschrijving heeft ingesteld, verschijnt bij het bewegen van de cursor een tooltip met uitleg.

Als je een waarde invoert buiten het toegestane bereik of in een ongeldig formaat, wordt het veld gemarkeerd en blijft de opslaanknop inactief totdat de fout is verholpen. Naast elke parameter is er een resetknop — die zet de waarde terug naar wat de maker van de mod als standaard heeft aangeduid.

Conclusie

Cloth Config API is een infrastructuurafhankelijkheid: zonder haar starten sommige mods gewoon niet, maar de mod zelf geeft zonder andere gekoppelde mods niets zichtbaars in het spel. Haar rol is om de instellingen van verschillende Minecraft-mods terug te brengen tot een gemeenschappelijke visuele standaard in plaats van een dozijn uiteenlopende interfaces. Op Fabric en in multiplatform-modpacks blijft Cloth Config API de meest verspreide gedeelde standaard.