JamLib — tekninen kirjasto muille Minecraft-modeille

JamLib — tekninen kirjasto muille Minecraft-modeille

JamLib on Minecraftin kirjastomodi, joka ei itsessään lisää peliin esineitä, lohkoja, mobeja eikä rakenteita. Se on apuohjelmakääre, joka tarjoaa muiden modien tekijöille seuraavaa: alusta-abstraktion latureiden välillä, valmiin asetustiedostojärjestelmän ja uudelleenpakattujen jar-tiedostojen tunnistimen. Ilman tätä kirjastoa sitä vaativat modit eivät yksinkertaisesti käynnisty.

Mitä modi tekee

Kirjasto ratkaisee kehittäjälle kolme tehtävää samanaikaisesti:

• Architectury-pohjaiset alusta-abstraktiot — sama koodi toimii Fabricilla, Forgella, NeoForgella ja Quiltilla ilman erillisiä haaroja.

• JSON5-muotoinen asetusrajapinta, jossa on automaattinen asetusnäyttö pelissä.

• Modin jar-tiedoston tarkistus piraattipeilien uudelleenpakkaamisen merkkien varalta.

Pelaajan näkökulmasta kirjasto ei lisää mitään pelattavuuteen. Ainoa asia, jonka voi huomata, on uusi kohta modivalikossa jokaiselle modille, joka käyttää JamLibia asetuksiinsa. Jos tällaisia modeja on modipaketissa, vastaavaan ikkunaan ilmestyy automaattisesti luotu sivu liukusäätimineen, kytkimineen ja syöttökenttineen.

JSON5-asetukset

Tavallinen JSON ei salli kommentteja koodissa. JSON5, jonka kanssa kirjasto toimii Jankson-riippuvuuden kautta, sallii. Käytännössä tämä tarkoittaa, että JamLibin päälle rakennettujen modien asetustiedostot näyttävät .json5-tiedostoilta ja sisältävät jo kommentit, jotka kuvaavat kunkin parametrin ja sen oletusarvon suoraan sen yläpuolella.

Tiedostot säilyttävät käyttäjän muokkaukset uudelleenkirjoituksen yhteydessä: jos lisäät oman huomautuksesi //-rivillä, se pysyy paikallaan seuraavan asetustallennuksen jälkeenkin. Tavalliset JSON-kirjastot eivät osaa tätä.

Asetusnäytöt luodaan erikseen. Fabricilla ja Quiltilla käyttöliittymä otetaan käyttöön tavallisen modivalikon kautta, Forgella ja NeoForgella laturin sisäänrakennetun asetusnäyttörajapinnan kautta. Modien tekijöiden ei tarvitse kirjoittaa käyttöliittymää käsin: JamLib ottaa kentät asetusluokasta ja rakentaa niille validoidut widgetit — lukujen vaihteluvälit, säännöllisen lausekkeen merkkijonoille, varoitukset pelin uudelleenkäynnistyksen tarpeesta.

Uudelleenpakattujen modien tunnistin

Erillinen toiminto tarkistaa, onko asennetun modin .jar-tiedosto ladattu virallisesta lähteestä. Jotkin sivustot pakkaavat modeja uudelleen omilla nimillään ja lisäävät niihin joskus kolmannen osapuolen ohjelmistoja. JamLib vertaa tiedoston todellista nimeä sen manifestissa olevaan JamLib-File-Name-kenttään. Jos ne eivät täsmää, chattiin tulostuu varoitus maailman latautumisen jälkeen. Viesti näytetään kerran per epäilyttävä tiedosto, minkä jälkeen kyseisen .jar-tiedoston nimi muistetaan.

Tarkistus koskee vain modeja, joiden tekijät ovat tarkoituksella lisänneet JamLib-File-Namen manifestiinsa (eli saman kehittäjän modeja tai niitä, jotka ovat integroineet tämän ominaisuuden manuaalisesti). Kirjasto ei skannaa jokaista mods-kansion .jar-tiedostoa virusten tai haittakoodin varalta — se ei ole virustorjuntaohjelma.

Yhteenveto

JamLib vapauttaa modin kehittäjän kirjoittamasta manuaalisesti asetusjärjestelmää ja alusta-abstraktiota neljälle laturille kerralla. JamLibin asentaminen on järkevää vain yhdessä siitä riippuvaisen modin kanssa, joka sitä vaatii. Jos modipaketissa ei ole yhtään JamCoreModdingin tai muun kolmannen osapuolen modia, joka perustuu tähän kirjastoon, JamLibin .jar-tiedosto jää yksinkertaisesti mods-kansioon ilman aktiivista roolia.