Architectury API: katsaus välittäjäkirjastoon Minecraftin alustariippumattomille modeille

Modien tekeminen useille Minecraftin lataajille pakottaa kehittäjät yleensä kirjoittamaan ja ylläpitämään erillisiä koodikantoja Fabricille, Forgelle ja NeoForgelle. Architectury API -kirjasto ratkaisee tämän ongelman tarjoamalla välittävän abstraktiokerroksen modin koodin ja lataajakohtaisten API-rajapintojen välille. Sen ansiosta kehittäjät voivat tehdä alustariippumattomia modeja, joissa suurin osa koodista on jaettua, ja kääntäminen kullekin ympäristölle tapahtuu automaattisesti. Pelaajille tämä kirjasto on pakollinen riippuvuus kymmenien suosittujen lisäosien käyttämiseksi.

Architectury API:n konsepti ja tekniset edut

Architectury API:n päätavoite on minimoida toistuva koodi modikehityksessä. Sen sijaan, että tekijät opettelisivat ja käyttäisivät Fabricin ja Forgen erillisiä tapahtuma- ja rekisteröintijärjestelmiä, he käyttävät yhtenäisiä välittäjäluokkia.

Kirjaston kehittäjille tarjoamat keskeiset mekanismit:

• Yhtenäinen rekisteri: mahdollistaa uusien lohkojen, esineiden, biomien tai olioiden rekisteröinnin yhden yhteisen rajapinnan kautta, jonka kirjasto sitten itse mukauttaa kyseisen lataajan vaatimuksiin.

• Verkkoliikenne: yksinkertaistaa mukautettujen datapakettien lähettämistä asiakkaan ja palvelimen välillä yhdistämällä Forgen ja Fabricin omat verkkoprotokollat.

• Tapahtumien käsittely: tarjoaa yhteisen listan pelitapahtumista (kuten lohkon kanssa vuorovaikutus, mobin kuolema tai valikon avaaminen), jolloin kehittäjän ei tarvitse kirjoittaa erillisiä tapahtumakuuntelijoita jokaiselle järjestelmälle.

• Buildin automatisointi: kehitysympäristöön kuuluva Gradle-laajennus generoi automaattisesti lopulliset .jar-tiedostot kullekin lataajalle jaetusta koodista.

Vaikutus yhteensopivuuteen ja suosittuihin riippuvaisiin modeihin

Architectury API:n käyttö yksinkertaistaa huomattavasti modien ylläpitoa ja päivittämistä uusiin Minecraft-versioihin, sillä kehittäjien tarvitsee päivittää vain itse kirjasto sen sijaan, että he kirjoittaisivat oman lisäosansa logiikan uudelleen. Tämä tekee Architectury API:sta monen suuren projektin selkärangan.

Esimerkkejä tunnetuista modeista, jotka tarvitsevat tätä kirjastoa:

• Cloth Config API: suosittu kirjasto asetusnäyttöjen luomiseen, joka käyttää Architecturyn työkaluja asetusvalikoiden piirtämiseen.

• Rough Enough Items (REI): suosittu käyttöliittymä crafting-reseptien selaamiseen, joka nojaa alustariippumattomiin verkkopaketteihin ja rekistereihin.

• Lighty: valotason visualisointimodi, joka tarvitsee Architecturyn seuratakseen renderöintitapahtumia sekä Fabricissa että Forgessa.

• Better Archeology: lisäosa, joka tuo uusia arkeologisia rakenteita, esineitä ja lohkoja eri lataajille yhteisten rekisteröintityökalujen avulla.

Jos pelaaja yrittää käynnistää minkä tahansa näistä modeista ilman, että vastaava Architectury API -versio on ensin asennettu, pelin asiakasohjelma keskeyttää latauksen välittömästi ja näyttää virheilmoituksen, joka vaatii kirjaston lisäämistä.

Yhteensopivuuden erityispiirteet ja asennusvaatimukset

Kehitystiimi julkaisee Architectury API:n puhtaasti teknisenä pluginina. Pelaajan täytyy ladata kirjastotiedosto, joka vastaa tarkalleen hänen pelin versiotaan ja valittua lataajaa (Fabric, Forge tai NeoForge).

Asennus tapahtuu vakiokaavan mukaisesti — siirtämällä .jar-tiedosto mods-kansioon. Kirjasto ei luo omia asetustiedostoja config-kansioon, sillä sen asetukset on integroitu suoraan riippuvaisiin modeihin. Se toimii taustalla eikä vaadi manuaalista puuttumista asetuksiin, mikä poistaa väärän konfiguraation aiheuttamien kaatumisten riskin.

Yhteenveto

Verrattuna useiden erillisten projektien rakentamiseen ja ylläpitoon eri lataajille, Architectury API antaa kehittäjille mahdollisuuden työskennellä yhdessä yhteisessä projektissa. Kirjaston suurin rajoite on lisäaika, jonka tekijät tarvitsevat sen sisäisten työkalujen opetteluun. Tämä modi on pakollinen asennus pelaajille, jotka haluavat käyttää nykyaikaisia, teknisesti pitkälle kehitettyjä modeja modipaketeissaan.