Migration auf referenzierte GUI-Menüs

Category Menus enthalten kein eigenes Layout mehr. Der Layout-Pool, das Hauptlayout, der Fenstertyp und die Sounds liegen in einem Open GUI-Entry, auf den das Feld menu verweist. So bleibt der Editor schlank und große Seiten werden nicht langsam veröffentlicht.

Was mit alten Seiten passiert

Beim Start sucht die Erweiterung nach Category Menus, die noch ein Layout enthalten, und wandelt sie einmalig um: Sie verschiebt das Layout in ein neues Chassis-Open-GUI und setzt menu. Die Umwandlung schreibt nur dann, wenn alle Seiten umgewandelt wurden; andernfalls lässt sie deine Seiten unverändert und versucht es beim nächsten Start erneut. Sichere deinen Ordner pages, bevor du aktualisierst, und aktualisiere Quest Codex und GUI gemeinsam.

Ein Category Menu, das weiterhin kein menu hat, wird in der Konsole gemeldet, da sein Öffnen nichts bewirkt.

Manuelle Umstellung

Für jedes ältere Category Menu:

1. Erstelle ein Open GUI und verschiebe guiType, audio, layoutPool und mainLayoutId dorthin.
2. Setze menu im Category Menu auf diesen Entry.
3. Behalte category, title, rows und sortDisplay im Category Menu.
4. Stelle sicher, dass rows zur size des Open GUI passt.

Semantik von gap

Vor Quest Codex 0.3.0 war das gap eines Markers ein Abstand. Jetzt ist es eine Schrittweite, die alle GUI-Erweiterungen gemeinsam nutzen: 1 platziert benachbarte Slots und 2 lässt einen leeren Slot dazwischen. Um den früheren Abstand eines alten Menüs wiederherzustellen, verdopple die Schrittweite: Aus gap 1 wird 2.

Speicherung des Trackings

Für dauerhaftes Mehrfach-Tracking legst du einen Quest Codex Tracking Data-Entry auf einer statischen Seite an und verweist in trackingArtifact darauf. Ändere seine artifactId nicht mehr, sobald Spieler ihn nutzen, sonst gehen ihre verfolgten Quests verloren.