Cloth Config API — mod pro obrazovky nastavení v Minecraftu

Cloth Config API — mod pro obrazovky nastavení v Minecraftu

Cloth Config API je knihovna, kterou vyžadují desítky modů pro Minecraft, aby mohly zobrazovat svá nastavení jako nabídku ve hře místo textového souboru. Sama o sobě do hry nic nepřidává: žádné předměty, žádné bloky, žádné nové mechaniky. Je to závislost — bez ní se mody, které ji využívají, nespustí a v seznamu modů vypíší chybu.

Kdy je mod potřeba

Knihovna se neinstaluje samostatně, ale spolu s dalšími mody. Zda je potřeba pro konkrétní modpack, lze zjistit dvěma způsoby:

• V popisu modu na Modrinth nebo CurseForge je v seznamu Dependencies uvedeno Cloth Config API.

• Hra se při spuštění modpacku zavře a v záznamu (logs/latest.log) se objeví zmínka o chybějícím cloth-config nebo cloth-config-2.

Interní název cloth-config-2 patří přesně témuž modu — je to identifikátor, který se objevil počínaje druhou velkou verzí knihovny. Pokud někdo píše „je potřeba cloth-config-2“, jde o moderní verzi Cloth Config API.

Jak otevřít nastavení modu

Na Forge a NeoForge je seznam nainstalovaných modů zabudovaný v hlavní nabídce hry — položka Mods. Vedle každého modu, který má připojený Cloth Config, se objeví ikona nastavení. Kliknutí otevře samostatnou obrazovku se všemi parametry právě tohoto modu.

Na Fabric v zavaděči standardní seznam modů není, takže přístup k obrazovkám Cloth Config se realizuje přes nástroj třetí strany pro prohlížení modů — zobrazí seznam nainstalovaného a umožní kliknout na tlačítko vedle potřebné položky.

Nastavení modu pomocí Cloth Config 

Jak vypadá samotná obrazovka

Všechny obrazovky modu jsou sestaveny podle stejného schématu: vlevo — kategorie parametrů, uprostřed — samotné parametry, dole — tlačítka Uložit a Zrušit. Každý parametr je zobrazen prvkem rozhraní odpovídajícím typu jeho hodnoty. 

V horní části obrazovky mají konfigurace s desítkami parametrů vyhledávací pole — filtruje seznam podle názvu. U parametrů, ke kterým autor modu zadal popis, se po najetí kurzorem objeví nápověda s vysvětlením.

Pokud zadáte hodnotu mimo povolený rozsah nebo v nepřípustném formátu, pole se zvýrazní a tlačítko uložení zůstane neaktivní, dokud chybu neopravíte. Vedle každého parametru je tlačítko obnovení — vrátí hodnotu na tu, kterou autor modu označil jako výchozí.

Závěr

Cloth Config API je infrastrukturní závislost: bez ní se část modů jednoduše nespustí, ale samotný mod ve hře bez dalších připojených modů nepřináší nic viditelného. Jeho úlohou je sjednotit nastavení různých modů pro Minecraft do společného vizuálního standardu místo desítky různorodých rozhraní. Na Fabric a v multiplatformních modpacích zůstává Cloth Config API nejrozšířenějším společným standardem.