LibJF — Tekninen modikirjasto ja ydin kolmansien osapuolien modien tukemiseen Minecraftissa

LibJF — Tekninen modikirjasto ja ydin kolmansien osapuolien modien tukemiseen Minecraftissa

LibJF on modulaarinen kirjasto tekijältä JFronny, joka sisältää joukon jaettuja komponentteja hänen omille modeilleen. Pelaajan tietokoneelle tätä modia ei yleensä asenneta yksinään, vaan pakollisena riippuvuutena — ilman sitä vastaavat modit eivät käynnisty. LibJF ei lisää reseptejä, mobeja tai uusia palikoita Minecraftiin. Sen tehtävä on toinen: erottaa toistuvat toiminnot — asetusten muotoilu, käännösjärjestelmä, paikallinen HTTP-palvelin, kaksi aputagia — erilliseksi projektiksi ja käyttää niitä uudelleen saman kehittäjän eri modeissa.

Tarkoitus modipaketissa

Kirjasto on jaettu erillisiin moduuleihin, joista kukin vastaa omasta tehtävästään: asetustiedostojen muotoilu ja niiden pelin sisäinen valikko, esineiden tagit, käännös, verkkokomponentit. LibJF:stä riippuvat modit lataavat vain ne moduulit, joita ne todella käyttävät. Siksi pelin ensimmäisen käynnistyksen jälkeen config/-kansioon ei ilmesty vain yhtä tiedostoa, vaan useita (yksi jokaista aktiivista moduulia kohden).

Yksi perusvaikutuksista, jonka pelaaja huomaa heti, on asetusten automaattinen uudelleenlataus. Parametri watchForChanges on oletuksena käytössä: jos muutat mitä tahansa LibJF:n kautta toimivaa asetustiedostoa, muutokset otetaan käyttöön ilman pelin uudelleenkäynnistystä.

Yleiset tagit esineille ja haarniskoille

LibJF lisää kaksi tagia, jotka ovat saatavilla sekä muille modeille että vanilla-datapackeille:

Itse tagit ovat tyhjiä — ne täytetään datapackilla tai kolmannen osapuolen modilla. Esimerkiksi täyden nahkasetin tekemiseksi "läpäisemättömäksi" selviytymistilassa riittää, kun luot pienen datapackin, joka lisää minecraft:leather_helmet, minecraft:leather_chestplate, minecraft:leather_leggings ja minecraft:leather_boots tagitiedostoon libjf:overpowered.

Käännösosajärjestelmä

Moduuli libjf-translate-v1 antaa kehittäjän muille modeille pääsyn merkkijonojen käännöspalveluun. Kirjasto itsessään ei käännä mitään chatissa tai käyttöliittymässä — se määrittää vain, minkä ulkoisen palvelun kautta pyynnöt kulkevat, jos kuluttajamodi kutsuu niitä. Tuettuna on neljä palveluntarjoajavaihtoehtoa:

• Google — julkinen Google Translate -käyttöliittymä (oletusarvo).

• DeepLX — DeepL API:n avoin toteutus.

• LibreTranslate — itse isännöity avoimen lähdekoodin ratkaisu; vaatii instanssin osoitteen määrittämisen erikseen.

• Noop — tynkä, joka palauttaa syötetyn tekstin muuttumattomana; hyödyllinen testeissä ja käännöksen poistamisessa kokonaan käytöstä.

Erillinen throttleMillis parametri asettaa minimitauon palvelukutsujen välille. Tämä rajoitus on tarpeen, jotta vältetään ilmaisen API:n tilapäiset estot kuluttajamodin toistuvien pyyntöjen vuoksi.

Paikallinen verkkopalvelin

Moduuli libjf-web-v1 käynnistää pienen HTTP-palvelimen pelin sisällä. Tekijän muut modit käyttävät sitä silloin, kun asiakkaalle on annettava enemmän kuin tavallinen verkkopaketti (esim. staattinen sivu tai esikatselutiedosto). Pelaajan tavallisessa ympäristössä tämä moduuli on yleensä hiljaa: portti on avoinna vain paikallisesti (127.0.0.1), ja tiedostojen jakaminen on poistettu käytöstä.

Yksityisten palvelimien järjestelmänvalvojat voivat ottaa käyttöön mielivaltaisten tiedostojen jakamisen kansiosta config/wwwroot staattisina resursseina erillisen asetusparametrin kautta — tämä on valinnainen ominaisuus, jota ei ole aktivoitu oletuksena.

Yhteenveto

LibJF on riippuvuuskirjasto, jota tarvitaan, kun modipaketti sisältää saman kehittäjän modin tai datapackin, joka käyttää libjf:overpowered tai libjf:shulker_boxes_illegal -tageja. Tämän luokan muihin kirjastoihin verrattuna se erottuu modulaarisella arkkitehtuurilla ja paikallisen HTTP-palvelimen sekä käännöskerroksen läsnäololla, mitä useimmat apukirjastot eivät tarjoa. Tavalliseen vanilla Minecraft Java Edition -modipakettiin LibJF:ää ei ole järkevää asentaa; modipaketeille, joissa on JFronnyn modeja, se on pakollinen komponentti.