Skip to content

docs: add main menu guide and nest the mystery gift series#37

Open
Zodiarche wants to merge 2 commits into
mainfrom
docs/main-menu-page
Open

docs: add main menu guide and nest the mystery gift series#37
Zodiarche wants to merge 2 commits into
mainfrom
docs/main-menu-page

Conversation

@Zodiarche

@Zodiarche Zodiarche commented Jun 10, 2026

Copy link
Copy Markdown
Collaborator

Summary

Adds a Main Menu customization guide to the UI development section (EN + FR), migrated from docs/MainMenu.md in the engine repository. The page goes further than the original document: it explains the registration model (action + visibility condition), warns that register_button appends to the already-registered defaults instead of replacing them, covers the Quit icon/text fallback for new buttons, and uses the prepend convention from the monkey-patching guide in its examples.

Second commit: nests the 11-step Mystery Gift series into its own sidebar category (psdk/ui-development/mystery-gift/). Without this, any standalone guide added to psdk/ui-development (starting with this one) was picked up by the "Mystery Gift — Step X / Y" progress tracker, which keys on sourceDirName. The series now has its own category (collapsible in the sidebar, own generated index), the tracker gate targets the new directory, and ui-development becomes the home for standalone UI guides.

Note: the 11 series pages change URL (/psdk/ui-development/<slug> becomes /psdk/ui-development/mystery-gift/<slug>). Old shared links will 404; decision made to accept this rather than add a redirects plugin.

Related issues

Closes #36

Test plan

  • bun run typecheck passes.
  • bun run build passes on both locales: validates all internal links, confirming nothing else pointed at the old series URLs.
  • Code examples cross-checked against the engine source (scripts/4 Systems/100 Menu/100 Menu.rb and 300 MenuButtonBase.rb).
  • Visual checks to do during review: the progress tracker shows on series pages only (e.g. /psdk/ui-development/mystery-gift/prepare-ui-assets) and NOT on the new guide (/psdk/ui-development/customize-main-menu); sidebar shows the Mystery Gift group plus the standalone guide in both locales (bun run preview for the FR pass).

Screenshots

The page embeds the in-game Main Menu screenshot from the engine repository (static/img/psdk/ui-development/main-menu.png).

@Zodiarche Zodiarche changed the title docs: add main menu customization guide docs: add main menu guide and nest the mystery gift series Jun 10, 2026
@Zodiarche Zodiarche self-assigned this Jun 11, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Add a Main Menu customization guide (migrated from the engine repo)

1 participant