Architectury API: přehled prostřednické knihovny pro multiplatformní mody v Minecraftu

Tvorba modů pro více loaderů Minecraftu obvykle nutí vývojáře psát a udržovat samostatné kódové báze pro Fabric, Forge a NeoForge. Knihovna Architectury API tento problém řeší tím, že nabízí prostřední vrstvu abstrakce mezi kódem modu a specifickými API jednotlivých loaderů. Umožňuje vývojářům vytvářet multiplatformní mody, kde je většina kódu sdílená a kompilace pro jednotlivá prostředí probíhá automaticky. Pro hráče je tato knihovna povinnou závislostí, bez které nelze spustit desítky oblíbených doplňků.

Koncept a technické výhody Architectury API

Hlavním cílem Architectury API je minimalizovat duplicitní kód při vývoji modů. Místo učení se a používání oddělených systémů událostí a registrace Fabricu a Forge autoři pracují s jednotnými prostřednickými třídami.

Hlavní mechanismy, které knihovna vývojářům nabízí:

• Sjednocený registr: umožňuje registrovat nové bloky, předměty, biomy nebo entity prostřednictvím jednoho společného rozhraní, které knihovna sama přizpůsobí požadavkům konkrétního loaderu.

• Síťová komunikace: zjednodušuje odesílání vlastních datových paketů mezi klientem a serverem sjednocením specifických síťových protokolů Forge a Fabricu.

• Zpracování událostí: nabízí společný seznam herních událostí (například interakce s blokem, smrt moba nebo otevření menu), takže vývojář nemusí psát samostatné posluchače událostí pro každý systém zvlášť.

• Automatizace sestavení: speciální rozšíření pro vývojové prostředí Gradle automaticky generuje finální soubory .jar pro každý loader ze sdíleného kódu.

Dopad na kompatibilitu a oblíbené závislé mody

Používání Architectury API výrazně zjednodušuje údržbu a aktualizaci modů pro nové verze Minecraftu, protože vývojářům stačí aktualizovat pouze samotnou knihovnu, aniž by museli přepisovat logiku vlastních doplňků. Díky tomu je Architectury API základem mnoha rozsáhlých projektů.

Příklady známých modů, které tuto knihovnu vyžadují:

• Cloth Config API: oblíbená knihovna pro tvorbu konfiguračních obrazovek, která využívá nástroje Architectury k vykreslování menu nastavení.

• Rough Enough Items (REI): oblíbené rozhraní pro prohlížení craftovacích receptů, které se opírá o multiplatformní síťové pakety a registry.

• Lighty: mod pro vizualizaci úrovně osvětlení, který potřebuje Architectury ke sledování vykreslovacích událostí na Fabricu i Forge.

• Better Archeology: doplněk, který zavádí nové archeologické stavby, předměty a bloky napříč různými loadery pomocí sdílených registračních nástrojů.

Pokud se hráč pokusí spustit kterýkoli z těchto modů bez předchozí instalace odpovídající verze Architectury API, klient hry okamžitě přeruší načítání a zobrazí chybovou zprávu vyžadující doplnění knihovny.

Zvláštnosti kompatibility a požadavky na instalaci

Vývojářský tým vydává Architectury API jako čistě technický plugin. Hráč si musí stáhnout soubor knihovny, který přesně odpovídá jeho verzi hry a zvolenému loaderu (Fabric, Forge nebo NeoForge).

Instalace probíhá standardním způsobem — přesunutím souboru .jar do složky mods. Knihovna nevytváří vlastní konfigurační soubory ve složce config, protože její nastavení jsou integrována přímo do závislých modů. Běží na pozadí a nevyžaduje ruční zásahy do nastavení, což vylučuje riziko pádů kvůli nesprávné konfiguraci.

Závěr

Ve srovnání s vytvářením a údržbou několika samostatných projektů pro různé loadery umožňuje Architectury API vývojářům pracovat v jednom společném projektu. Hlavním omezením knihovny je dodatečný čas, který autoři potřebují na seznámení s jejími vnitřními nástroji. Tento mod je povinnou instalací pro hráče, kteří chtějí ve svých modpacích používat moderní, technicky pokročilé mody.