Migration vers les menus GUI référencés

Les Category Menus ne contiennent plus leur propre disposition. Le pool de dispositions, la disposition principale, le type de fenêtre et les sons se trouvent dans une entrée Open GUI référencée par le champ menu. Cela allège l'éditeur et évite les publications lentes sur les grandes pages.

Ce qui arrive aux anciennes pages

Au démarrage, l'extension recherche les Category Menus qui contiennent encore une disposition et les convertit une seule fois : elle déplace la disposition dans un nouveau châssis Open GUI et renseigne menu. La conversion n'écrit que si toutes les pages ont été converties ; sinon, elle laisse vos pages intactes et réessaie au démarrage suivant. Sauvegardez votre dossier pages avant la mise à jour, et mettez à jour Quest Codex et GUI ensemble.

Un Category Menu qui n'a toujours pas de menu est signalé dans la console, car l'ouvrir ne fait rien.

La faire à la main

Pour chaque ancien Category Menu :

1. Créez un Open GUI et déplacez-y guiType, audio, layoutPool et mainLayoutId.
2. Renseignez menu sur le Category Menu avec cette entrée.
3. Conservez category, title, rows et sortDisplay sur le Category Menu.
4. Faites correspondre rows à la size de l'Open GUI.

Sémantique de gap

Avant Quest Codex 0.3.0, le gap d'un marqueur était un espacement. C'est désormais un pas, commun à toutes les extensions GUI : 1 place des emplacements adjacents et 2 laisse un emplacement vide entre eux. Pour retrouver l'ancien espacement d'un vieux menu, doublez le pas : gap 1 devient 2.

Stockage du suivi

Pour un suivi multiple persistant, placez une entrée Quest Codex Tracking Data dans une page statique et référencez-la depuis trackingArtifact. Conservez son artifactId inchangé dès que des joueurs l'utilisent, sinon leurs quêtes suivies deviennent orphelines.