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

Vanilla rozhraní pokroků omezuje zobrazení záložek. Standardní okno má pevně danou šířku a výšku, vypočtené pouze pro šest záložek. Pokud nainstalujete velkou sadu modifikací, kde každý velký mod přidává vlastní větev postupu, nové záložky začnou přesahovat okraje obrazovky, překrývat se navzájem nebo z rozhraní úplně mizet. Modifikace Paginated Advancements & Custom Frames rozšiřuje standardní okno nabídky pokroků tím, že přidává stránkovou navigaci, systém připínání prioritních větví, vestavěný ladicí nástroj a podporu zcela nových rámečků pro ikony pomocí resource packů či datapacků.

Technický princip fungování a řešení omezení vanilla rozhraní

Vanilla třída AdvancementsScreen používá k vykreslení okna pokroků napevno zakódované souřadnice (velikost je 252 krát 140 pixelů). Ovládací prvky, jako je mřížka záložek a vykreslení pozadí, jsou vázány na statické rozměry okna, což znemožňuje škálování pro vysoké rozlišení monitoru. Třída AdvancementTab má rovněž pevné hranice pro vykreslování ikon záložek po obvodu hlavního rámu.

Paginated Advancements & Custom Frames zavádí změny přímo do logiky vykreslování grafického rozhraní klienta pomocí Mixin injekcí do tříd MixinAdvancementsScreen a MixinAdvancementTab. Místo použití napevno zapsaných konstant modifikace zachytává inicializaci rozhraní a načítá aktuální rozměry okna hry. Na základě těchto dat se vypočítá optimální velikost rámu pokroků, který se adaptivně rozšiřuje a zabírá většinu obrazovky.

Systém automaticky seskupuje všechny registrované záložky do samostatných stránek (stránkování). Algoritmus vypočítá maximální počet záložek, které se vejdou do horního a dolního panelu okna, podle vzorce, který zohledňuje šířku okna a nastavené okraje. Pokud počet větví pokroků překročí limit stránky, modifikace vytvoří další virtuální stránky a přidá interaktivní tlačítka se šipkami v dolní části rozhraní. Při přepínání stránek vykreslovač skrývá záložky z neaktivních stránek, čímž zabraňuje přetížení operační paměti grafickými objekty a odstraňuje konflikty překrývání prvků.

Klíčové možnosti a funkce

Hlavní funkcí Paginated Advancements & Custom Frames je reorganizace grafické nabídky pokroků. Modifikace nabízí několik praktických nástrojů pro navigaci:

·        Dynamické stránkování: Přidává šipky pro přepínání stránek do dolního rohu okna pokroků. Hráči mohou procházet libovolný počet záložek, i když je v sadě aktivováno více než padesát modifikací s vlastními řetězci úkolů.

·        Připínání záložek: Uživatel může přidat libovolnou záložku do seznamu oblíbených. K tomu slouží speciální tlačítko ve tvaru hvězdičky na každé záložce. Připnutá záložka se automaticky přesune na první stránku a zobrazí se na začátku seznamu bez ohledu na své abecední nebo herní pořadí řazení.

·        Zachování stavu relace: Mod si pamatuje naposledy otevřenou záložku pokroků. V případě zavření nabídky a jejího opětovného otevření klávesou L rozhraní zobrazí stejnou záložku, na které hráč skončil, místo resetování na první standardní záložku.

·        Ladicí nástroj pokroků (Advancement Debugger): Speciální režim pro vývojáře sad a autory questů. Aktivuje se v konfiguraci nebo při zapnutí rozšířených popisků (klávesy F3 + H). Při najetí kurzorem na ikonu pokroku se zobrazí další okno s popiskem obsahující technické informace: interní identifikátor (například minecraft:adventure/arbalistic) a seznam spouštěčů (podmínek) potřebných ke splnění. Klávesová kombinace Ctrl + C zkopíruje identifikátor vybraného pokroku do schránky.

Nastavení, kompatibilita a ekosystém

Parametry zobrazení nabídky pokroků může uživatel změnit prostřednictvím konfiguračního souboru. Umístění a formát souboru závisí na loaderu modifikací:

·        Fabric a Quilt: Pro fungování nastavení je nutná instalace knihovny Cloth Config API. Parametry se zapisují do souboru paginatedadvancements.json (nebo paginatedadvancements.json5) ve složce config.

·        NeoForge: Verze modu počínaje 2.8.0 používají vestavěný konfigurační systém NeoForge, což vylučuje potřebu dalších knihoven. Soubor se generuje pod názvem paginatedadvancements-client.toml ve složce config.

V konfiguračním souboru jsou k dispozici následující klíčové parametry:

·        showDebugTooltips – logická hodnota (true nebo false), která řídí zobrazení technických informací pro ladění pokroků.

·        maxDebugLines – celé číslo, které omezuje maximální počet řádků spouštěčů v okně popisku a zabraňuje přesahu textu mimo obrazovku v případě velkého počtu požadavků.

·        disableBackgroundFade – parametr pro vypnutí ztmavení pozadí hry během prohlížení nabídky pokroků.

·        spacing – krok v pixelech pro úpravu vzdálenosti mezi sousedními záložkami na panelu.

·        enablePinning – povoluje nebo zakazuje hráčům připínat vybrané záložky.

Modifikace podporuje systém přizpůsobení ikon prostřednictvím mechanismu Custom Frames (vlastní rámečky). Ve výchozím nastavení nabízí Minecraft tři typy rámečků: task (běžný úkol), goal (cíl) a challenge (výzva). Mod umožňuje vytvářet nové typy pomocí datapacků.

Pro přidání nového rámečku je nutné vytvořit soubor JSON v datapacku na cestě:

assets/<identifikátor_modu>/advancement_frame_types/<název_rámečku>.json

Příklad obsahu souboru:

Textury pro rámeček se umisťují na cesty:

·       assets/<identifikátor_modu>/textures/gui/sprites/advancements/<název_rámečku>_unobtained.png – vzhled rámečku před splněním pokroku.

·      assets/<identifikátor_modu>/textures/gui/sprites/advancements/<název_rámečku>_obtained.png – vzhled rámečku po splnění.

K přiřazení vytvořeného rámečku ke konkrétnímu pokroku se používá mapovací soubor v datapacku na cestě assets/<identifikátor_modu>/advancement_frames/<název_souboru>.json:

Mod byl vyvinut jako čistě klientský nástroj, a proto nevyžaduje instalaci na server. Je plně kompatibilní s velkými industriálními a magickými mody (jako jsou Create, Ender IO, Botania), které přidávají složité systémy questů a četné záložky pokroků. Pro uživatele starého loaderu Forge je k dispozici neoficiální adaptace modu s názvem ForgedPaginatedAdvancements. Pro spuštění nejnovějších verzí modu na platformě NeoForge 26.1+ je povinné použití běhového prostředí Java 25.

Závěr

Paginated Advancements & Custom Frames efektivně řeší problém omezeného prostoru vanilla rozhraní pokroků, který se stává kritickým ve velkých sadách modifikací. Na rozdíl od obdobného Better Advancements, který okno převážně škáluje bez přidávání stránek, tento mod nabízí jasné rozdělení na stránky a pohodlné připínání záložek. Modifikace zjednodušuje práci vývojářů modifikovaných sad díky vestavěnému debuggeru a flexibilnímu systému registrace nových typů rámečků prostřednictvím struktur JSON v datapackách. Jediným znatelným omezením je nutnost vytváření dalších resource packů klienta pro správné zobrazení vlastních grafických rámečků.