Cloth Config API — Minecraftin asetusnäyttöjen mod

Cloth Config API — Minecraftin asetusnäyttöjen mod

Cloth Config API on kirjasto, jota kymmenet Minecraft-modit vaativat, jotta ne voivat näyttää asetuksensa pelin sisäisenä valikkona tekstitiedoston sijaan. Itsessään se ei lisää peliin mitään: ei esineitä, ei lohkoja, ei uusia mekaniikkoja. Se on riippuvuus — ilman sitä modit, jotka käyttävät sitä, eivät käynnisty ja näyttävät virheen modilistassa.

Milloin modia tarvitaan

Kirjastoa ei asenneta yksinään, vaan muiden modien kanssa. On kaksi tapaa selvittää, tarvitaanko sitä tiettyyn modpackiin:

• Modin kuvauksessa Modrinthissa tai CurseForgessa on Dependencies-luettelossa mainittu Cloth Config API.

• Peli sulkeutuu modpackia käynnistettäessä, ja lokissa (logs/latest.log) on maininta puuttuvasta cloth-config- tai cloth-config-2-tiedostosta.

Sisäinen nimi cloth-config-2 kuuluu täsmälleen samalle modille — se on tunniste, joka ilmestyi kirjaston toisesta suuresta versiosta alkaen. Jos joku kirjoittaa "tarvitaan cloth-config-2", kyse on Cloth Config API:n nykyaikaisesta versiosta.

Kuinka avata modin asetukset

Forgessa ja NeoForgessa luettelo asennetuista modeista on sisäänrakennettu pelin päävalikkoon — kohta Mods. Jokaisen modin vieressä, joka on liittänyt Cloth Configin, näkyy asetuskuvake. Napsautus avaa erillisen näytön, jossa ovat kaikki juuri kyseisen modin parametrit.

Fabricissa lataajassa ei ole vakiomuotoista modiluetteloa, joten pääsy Cloth Config -näyttöihin toteutetaan kolmannen osapuolen modien katselutyökalun kautta — se näyttää luettelon asennetuista ja antaa napsauttaa painiketta tarvittavan kohdan vieressä.

Modin asetukset Cloth Configin avulla 

Miltä itse näyttö näyttää

Kaikki modin näytöt on koottu saman kaavan mukaan: vasemmalla parametrien luokat, keskellä itse parametrit, alhaalla Tallenna- ja Peruuta-painikkeet. Jokainen parametri näytetään käyttöliittymäelementillä, joka vastaa sen arvon tyyppiä. 

Näytön yläosassa kymmenien parametrien konfiguraatioilla on hakukenttä — se suodattaa luettelon nimen mukaan. Niiden parametrien vieressä, joille modin tekijä on määrittänyt kuvauksen, ilmestyy osoittimen viedessä päälle työkaluvihje selityksineen.

Jos syötät arvon sallitun alueen ulkopuolelta tai virheellisessä muodossa, kenttä korostuu ja tallennuspainike pysyy poissa käytöstä, kunnes virhe on korjattu. Jokaisen parametrin vieressä on palautuspainike — se palauttaa arvon siihen, minkä modin tekijä on merkinnyt oletukseksi.

Yhteenveto

Cloth Config API on infrastruktuuririippuvuus: ilman sitä osa modeista ei yksinkertaisesti käynnisty, mutta itse mod ei tuota pelissä mitään näkyvää ilman muita liitettyjä modeja. Sen tehtävä on koota eri Minecraft-modien asetukset yhteiseen visuaaliseen standardiin tusinan erilaisen käyttöliittymän sijaan. Fabricissa ja monialustaisissa modpackeissa Cloth Config API pysyy yleisimpänä yhteisenä standardina.