Forge Config API Port — Minecraft Java Edition

Základní Minecraft neobsahuje vestavěné nástroje pro pohodlné nastavení herních parametrů nebo modifikací, což nutí vývojáře vytvářet vlastní systémy pro ukládání konfigurací. Mod loader Forge nabízí hotové řešení v podobě vlastního konfiguračního systému, ale Fabric historicky nemá pro tento účel jednotný standard. Vývojáři multiplatformních módů tak musí psát samostatný konfigurační kód pro každý zaváděč, čímž tráví spoustu času rutinní prací. Knihovna Forge Config API Port tento problém řeší přenesením časem prověřeného konfiguračního rozhraní Forge na Fabric a Quilt.

Jak knihovna funguje

Forge Config API Port funguje jako prostředník mezi kódem modifikace a souborovým systémem hry. V prostředí Fabric plně obnovuje originální balíčky net.minecraftforge.common.ForgeConfigSpec a net.neoforged.fml.config. Vývojář napíše popis konfigurace pouze jednou pomocí standardní syntaxe Forge a knihovna automaticky vytvoří příslušné soubory na disku a spravuje their načítání.

Formát konfiguračních souborů TOML

Knihovna ukládá veškerá nastavení ve formátu TOML. Tento formát nabízí pohodlnou strukturu pro čtení a úpravy pomocí běžného textového editoru. Každý parametr může obsahovat komentáře, výchozí hodnoty a také jasné limity přípustných hodnot (minimální a maximální číslo). Konfigurační soubory se po prvním spuštění modifikace automaticky objeví ve složce config v kořenovém adresáři hry. Mají příponu .toml a název určený vývojářem módu.

Automatická synchronizace a dynamické opětovné načítání

Jednou z nejdůležitějších vlastností Forge Config API Port je vestavěná podpora pro synchronizaci a dynamické opětovné načítání konfigurací:

• Synchronizace mezi serverem a klientem (Sync): když se hráč připojí k serveru, server automaticky odešle svá nastavení klientovi. Tím se předchází konfliktům způsobeným různými verzemi konfigurací u hráčů na serveru.

• Dynamické opětovné načítání (Reload): knihovna sleduje změny v TOML souborech v reálném čase. Pokud konfigurační soubor během hry upravíte a uložíte, Forge Config API Port okamžitě aktualizuje parametry v paměti RAM bez nutnosti restartovat klienta Minecraftu.

Tyto mechanismy fungują automaticky a zbavují vývojáře nutnosti ručně kódovat síťovou interakci pro synchronizaci konfiguračních hodnot.

Význam pro hráče a vývojáře

Běžným hráčům Forge Config API Port nepřidává žádný viditelný obsah, nové bloky ani předměty. Jejich role spočívá v zajištění funkčnosti jiných modifikací. Bez instalace této knihovny se hra jednoduše nespustí, pokud jiné módy odkazují na její třídy. Modifikace je vyžadována především uživateli Fabricu, protože Forge a NeoForge mají tyto funkce ve své struktuře již ve výchozím nastavení.

Pro vývojáře je knihovna nepostradatelným nástrojem při vytváření multiplatformních projektů. Umožňuje jim:

1. Ušetřit stovky řádků kódu, které dříve padly na vývoj samostatné logiky ukládání nastavení pro různé zaváděče.

2. Zajistit stejný zážitek ze správy módů pro koncové uživatele, protože konfigurační soubory mají identickou strukturu na Fabricu i Forge.

3. Využívat výkonnou sadu nástrojů pro validaci hodnot od Forge, která v případě chyb automaticky opraví nesprávné vstupy uživatele a obnoví výchozí hodnoty.

Populární závislé modifikace

Vývojář knihovny, známý pod přezdívkou Fuzs (nebo Fuzs_), ji používá ve všech svých populárních módech. Zde je několik známých příkladů:

• Easy Magic: mód, který mění mechaniku stolu kouzel, umožňuje ukládat předměty do inventáře stolu a přidává nové způsoby vylepšování kouzel.

• Trading Post: blok, který sjednocuje obchodní nabídky všech vesničanů v okolí do jednoho rozhraní.

• Visuality: mód na vizuální efekty, který přidává realistické částice bláta, jisker a cákance vody z různých akcí mobů.

• Easy Shulker Boxes: umožňuje interakci s shulker boxy přímo z inventáře bez nutnosti jejich pokládání na zem.

Kromě projektů od Fuzs používají Forge Config API Port stovky dalších vývojářů k přenosu své práce z Forge na Fabric, díky čemuž mají hráči přístup k obrovské knihovně kvalitního obsahu.