Paginated Advancements & Custom Frames — Minecraft Java Edition 1.18.1 - 26.1+

Vaniljainen saavutusten käyttöliittymä rajoittaa välilehtien näyttämistä. Vakioikkunalla on kiinteä leveys ja korkeus, jotka on mitoitettu vain kuudelle välilehdelle. Jos asennat suuren modipaketin, jossa jokainen suuri modi lisää oman etenemishaaransa, uudet välilehdet alkavat ulottua näytön reunojen yli, mennä päällekkäin tai kadota kokonaan käyttöliittymästä. Paginated Advancements & Custom Frames -modifikaatio laajentaa saavutusvalikon vakioikkunaa lisäämällä sivutetun navigoinnin, ensisijaisten haarojen kiinnitysjärjestelmän, sisäänrakennetun virheenkorjaustyökalun sekä tuen täysin uusille kuvakekehyksille resurssipakettien tai datapakettien avulla.

Tekninen toimintaperiaate ja vanilja-käyttöliittymän rajoitusten ratkaiseminen

Vanilja-luokka AdvancementsScreen käyttää kovakoodattuja koordinaatteja saavutusikkunan piirtämiseen (koko on 252 kertaa 140 pikseliä). Ohjauselementit, kuten välilehtiruudukko ja taustan piirto, on sidottu kiinteisiin ikkunakokoihin, mikä tekee skaalaamisen korkealle näytön resoluutiolle mahdottomaksi. Luokalla AdvancementTab on niin ikään kiinteät rajat välilehtikuvakkeiden piirtämiselle pääkehyksen reunan ympärille.

Paginated Advancements & Custom Frames tekee muutoksia suoraan asiakasohjelman graafisen käyttöliittymän piirtologiikkaan käyttämällä Mixin-injektioita luokkiin MixinAdvancementsScreen ja MixinAdvancementTab. Kovakoodattujen vakioiden käyttämisen sijaan modifikaatio sieppaa käyttöliittymän alustuksen ja lukee pelin ikkunan nykyisen koon. Näiden tietojen perusteella lasketaan saavutuskehyksen optimaalinen koko, joka laajenee mukautuvasti ja vie suurimman osan näytöstä.

Järjestelmä ryhmittelee automaattisesti kaikki rekisteröidyt välilehdet erillisiksi sivuiksi (sivutus). Algoritmi laskee suurimman mahdollisen välilehtien määrän, joka mahtuu ikkunan ylä- ja alapaneelin rajoihin, kaavalla, joka ottaa huomioon ikkunan leveyden ja asetetut marginaalit. Jos saavutushaarojen määrä ylittää sivun rajan, modifikaatio luo lisää virtuaalisia sivuja ja lisää interaktiiviset nuolipainikkeet käyttöliittymän alaosaan. Sivuja vaihdettaessa piirtomoottori piilottaa epäaktiivisten sivujen välilehdet, mikä estää keskusmuistin ylikuormittumisen graafisilla objekteilla ja poistaa elementtien päällekkäisyydestä johtuvat ristiriidat.

Keskeiset mahdollisuudet ja toiminnallisuus

Paginated Advancements & Custom Frames -modin pääasiallinen toiminto on graafisen saavutusvalikon uudelleenjärjestely. Modifikaatio tarjoaa useita käytännöllisiä työkaluja navigointiin:

·        Dynaaminen sivutus: Lisää sivunvaihtonuolet saavutusikkunan alakulmaan. Pelaajat voivat selata mitä tahansa määrää välilehtiä, vaikka pakettiin olisi aktivoitu yli viisikymmentä modifikaatiota omine tehtäväketjuineen.

·        Välilehtien kiinnittäminen: Käyttäjä voi lisätä minkä tahansa välilehden suosikkilistalle. Tätä varten jokaisessa välilehdessä on erityinen tähden muotoinen painike. Kiinnitetty välilehti siirtyy automaattisesti ensimmäiselle sivulle ja näytetään listan alussa riippumatta sen aakkos- tai pelinsisäisestä lajittelujärjestyksestä.

·        Istunnon tilan säilyttäminen: Modi muistaa viimeksi avatun saavutusvälilehden. Jos valikko suljetaan ja avataan uudelleen näppäimellä L, käyttöliittymä näyttää saman välilehden, johon pelaaja jäi, sen sijaan että se palaisi ensimmäiseen vakiovälilehteen.

·        Saavutusten virheenkorjaaja (Advancement Debugger): Erityinen tila pakettien kehittäjille ja tehtävien tekijöille. Se aktivoidaan asetuksista tai ottamalla käyttöön laajennetut työkaluvihjeet (näppäimet F3 + H). Kun kohdistin viedään saavutuskuvakkeen päälle, näytetään ylimääräinen työkaluvihjeikkuna, joka sisältää teknistä tietoa: sisäisen tunnisteen (esimerkiksi minecraft:adventure/arbalistic) ja luettelon laukaisimista (ehdoista), jotka vaaditaan sen suorittamiseen. Näppäinyhdistelmä Ctrl + C kopioi valitun saavutuksen tunnisteen leikepöydälle.

Asetukset, yhteensopivuus ja ekosysteemi

Käyttäjä voi muuttaa saavutusvalikon näyttöparametreja asetustiedoston kautta. Tiedoston sijainti ja muoto riippuvat modifikaatioiden lataajasta:

·        Fabric ja Quilt: Asetusten toiminta edellyttää Cloth Config API -kirjaston asentamista. Parametrit kirjoitetaan config-kansiossa olevaan tiedostoon paginatedadvancements.json (tai paginatedadvancements.json5).

·        NeoForge: Modin versiot alkaen 2.8.0:sta käyttävät NeoForgen sisäänrakennettua asetusjärjestelmää, mikä poistaa lisäkirjastojen tarpeen. Tiedosto luodaan nimellä paginatedadvancements-client.toml config-kansioon.

Asetustiedostossa ovat käytettävissä seuraavat keskeiset parametrit:

·        showDebugTooltips – totuusarvo (true tai false), joka hallitsee saavutusten virheenkorjauksen teknisten tietojen näyttämistä.

·        maxDebugLines – kokonaisluku, joka rajoittaa työkaluvihjeikkunan laukaisinrivien enimmäismäärää ja estää tekstin ulottumisen näytön ulkopuolelle suuren vaatimusmäärän tapauksessa.

·        disableBackgroundFade – parametri, jolla poistetaan pelin taustan himmennys saavutusvalikon tarkastelun aikana.

·        spacing – pikseleinä ilmaistu askel paneelin vierekkäisten välilehtien välisen etäisyyden säätämiseen.

·        enablePinning – sallii tai estää pelaajia kiinnittämästä valittuja välilehtiä.

Modifikaatio tukee kuvakkeiden mukauttamisjärjestelmää Custom Frames -mekanismin (mukautetut kehykset) kautta. Oletuksena Minecraft tarjoaa kolme kehystyyppiä: task (tavallinen tehtävä), goal (tavoite) ja challenge (haaste). Modi mahdollistaa uusien tyyppien luomisen datapakettien avulla.

Uuden kehyksen lisäämiseksi on luotava JSON-tiedosto datapakettiin polkuun:

assets/<modin_tunniste>/advancement_frame_types/<kehyksen_nimi>.json

Esimerkki tiedoston sisällöstä:

Kehyksen tekstuurit sijoitetaan polkuihin:

·       assets/<modin_tunniste>/textures/gui/sprites/advancements/<kehyksen_nimi>_unobtained.png – kehyksen ulkoasu ennen saavutuksen suorittamista.

·      assets/<modin_tunniste>/textures/gui/sprites/advancements/<kehyksen_nimi>_obtained.png – kehyksen ulkoasu suorittamisen jälkeen.

Luodun kehyksen liittämiseksi tiettyyn saavutukseen käytetään datapaketissa polussa assets/<modin_tunniste>/advancement_frames/<tiedoston_nimi>.json olevaa määritystiedostoa:

Modi kehitettiin puhtaasti asiakaspuolen apuvälineeksi, joten se ei vaadi asennusta palvelimelle. Se on täysin yhteensopiva suurten teollisuus- ja taikamodien kanssa (kuten Create, Ender IO, Botania), jotka lisäävät monimutkaisia tehtäväjärjestelmiä ja lukuisia saavutusvälilehtiä. Vanhan Forge-lataajan käyttäjille on saatavilla modin epävirallinen sovitus nimeltä ForgedPaginatedAdvancements. Modin uusimpien versioiden suorittamiseen NeoForge 26.1+ -alustalla on pakollista käyttää Java 25 -ajoympäristöä.

Johtopäätös

Paginated Advancements & Custom Frames ratkaisee tehokkaasti vaniljaisen saavutusten käyttöliittymän rajallisen tilan ongelman, joka muuttuu kriittiseksi suurissa modipaketeissa. Toisin kuin vastineensa Better Advancements, joka pääosin vain skaalaa ikkunaa lisäämättä sivuja, tämä modi tarjoaa selkeän jaon sivuihin ja kätevän välilehtien kiinnittämisen. Modifikaatio yksinkertaistaa muokattujen pakettien kehittäjien työtä sisäänrakennetun virheenkorjaajan ja datapakettien JSON-rakenteiden kautta toimivan joustavan uusien kehystyyppien rekisteröintijärjestelmän ansiosta. Ainoa huomattava rajoitus on tarve luoda lisää asiakaspuolen resurssipaketteja mukautettujen graafisten kehysten oikeaa näyttämistä varten.