Cloth Config API — Mod für Einstellungsbildschirme in Minecraft

Cloth Config API — Mod für Einstellungsbildschirme in Minecraft

Cloth Config API ist eine Bibliothek, die Dutzende Modifikationen in Minecraft benötigen, um ihre Einstellungen als Menü im Spiel anstatt in einer Textdatei anzuzeigen. Sie selbst fügt dem Spiel nichts hinzu: weder Gegenstände noch Blöcke noch neue Mechaniken. Sie ist eine Abhängigkeit — ohne sie starten die Mods, die sie eingebunden haben, nicht und melden einen Fehler in der Liste der Modifikationen.

Wann der Mod benötigt wird

Die Bibliothek wird nicht eigenständig installiert, sondern zusammen mit anderen Modifikationen. Ob sie für eine bestimmte Zusammenstellung benötigt wird, lässt sich auf zwei Arten herausfinden:

• In der Beschreibung des Mods auf Modrinth oder CurseForge ist in der Liste Dependencies Cloth Config API angegeben.

• Das Spiel schließt sich beim Starten der Zusammenstellung, und im Protokoll (logs/latest.log) erscheint ein Hinweis auf das fehlende cloth-config oder cloth-config-2.

Der interne Name cloth-config-2 gehört zum selben Mod — es ist der Bezeichner, der ab der zweiten großen Version der Bibliothek eingeführt wurde. Wenn jemand schreibt „benötigt cloth-config-2", ist die moderne Version von Cloth Config API gemeint.

Wie man die Einstellungen des Mods öffnet

Bei Forge und NeoForge ist die Liste der installierten Modifikationen in das Hauptmenü des Spiels integriert — der Punkt Mods. Neben jedem Mod, der Cloth Config eingebunden hat, erscheint ein Einstellungssymbol. Ein Klick öffnet einen separaten Bildschirm mit allen Parametern genau dieser Modifikation.

Bei Fabric gibt es im Loader keine standardmäßige Liste der Mods, daher wird der Zugriff auf die Cloth-Config-Bildschirme über ein externes Werkzeug zur Anzeige der Modifikationen realisiert — es zeigt die Liste des Installierten an und ermöglicht, die Schaltfläche neben dem gewünschten Punkt anzuklicken.

Einstellungen des Mods mithilfe von Cloth Config 

Wie der Bildschirm selbst aussieht

Alle Bildschirme des Mods sind nach demselben Schema aufgebaut: links — die Kategorien der Parameter, in der Mitte — die Parameter selbst, unten — die Schaltflächen Speichern und Abbrechen. Jeder Parameter wird durch ein Oberflächenelement dargestellt, das dem Typ seines Werts entspricht. 

Im oberen Teil des Bildschirms gibt es für Konfigurationen mit Dutzenden von Parametern ein Suchfeld — es filtert die Liste nach Namen. Neben Parametern, für die der Autor der Modifikation eine Beschreibung festgelegt hat, erscheint beim Überfahren mit dem Mauszeiger ein Tooltip mit einer Erläuterung.

Wenn man einen Wert außerhalb des zulässigen Bereichs oder in einem unzulässigen Format eingibt, wird das Feld hervorgehoben und die Speichern-Schaltfläche bleibt inaktiv, bis der Fehler behoben ist. Neben jedem Parameter gibt es eine Zurücksetzen-Schaltfläche — sie setzt den Wert auf den zurück, den der Autor der Modifikation als Standard markiert hat.

Fazit

Cloth Config API ist eine infrastrukturelle Abhängigkeit: ohne sie startet ein Teil der Modifikationen einfach nicht, doch der Mod selbst bietet im Spiel ohne andere eingebundene Mods nichts Sichtbares. Seine Rolle besteht darin, die Einstellungen verschiedener Modifikationen in Minecraft auf einen gemeinsamen visuellen Standard zu bringen, anstatt auf ein Dutzend unterschiedlicher Oberflächen. Bei Fabric und in plattformübergreifenden Zusammenstellungen bleibt Cloth Config API der am weitesten verbreitete gemeinsame Standard.