Migração para menus GUI referenciados

Os Category Menus não guardam mais seu próprio layout. O pool de layouts, o layout principal, o tipo de janela e os sons ficam em uma entry Open GUI referenciada pelo campo menu. Isso mantém o editor leve e evita publicações lentas em páginas grandes.

O que acontece com as páginas antigas

Na inicialização, a extensão procura Category Menus que ainda carregam um layout e os converte uma única vez: move o layout para um novo Open GUI de base e define menu. A conversão só grava quando todas as páginas foram convertidas; caso contrário, deixa suas páginas intactas e tenta novamente na próxima inicialização. Faça backup da sua pasta pages antes de atualizar e atualize o Quest Codex e o GUI juntos.

Um Category Menu que ainda não tem menu é reportado no console, pois abri-lo não faz nada.

Fazendo manualmente

Para cada Category Menu antigo:

1. Crie um Open GUI e mova para ele guiType, audio, layoutPool e mainLayoutId.
2. Defina menu no Category Menu com essa entry.
3. Mantenha category, title, rows e sortDisplay no Category Menu.
4. Faça rows corresponder ao size do Open GUI.

Semântica do gap

Antes do Quest Codex 0.3.0, o gap de um marcador era um espaçamento. Agora é um passo compartilhado com todas as extensões GUI: 1 posiciona slots adjacentes e 2 deixa um slot vazio entre eles. Para restaurar o espaçamento anterior de um menu antigo, dobre o passo: gap 1 vira 2.

Armazenamento de acompanhamento

Para um acompanhamento múltiplo persistente, coloque uma entry Quest Codex Tracking Data em uma página static e referencie-a em trackingArtifact. Mantenha seu artifactId inalterado depois que os jogadores a usarem, caso contrário as quests acompanhadas deles ficam órfãs.