Skip to content

hide-tutorials: suppress the adventure mode start tutorial - #1622

Open
Alistair-Afton wants to merge 1 commit into
DFHack:masterfrom
Alistair-Afton:fix-hide-tutorials-5779
Open

Alistair-Afton wants to merge 1 commit into
DFHack:masterfrom
Alistair-Afton:fix-hide-tutorials-5779

Conversation

@Alistair-Afton

@Alistair-Afton Alistair-Afton commented Sep 15, 2026

Copy link
Copy Markdown

Summary

  • default the tutorial checkbox to off when viewscreen_setupadventurest opens (want_tutorial = false); the player can still check it if they want the tutorial
  • clear plotinfo.flags.need_to_do_tutorial and close any open ADVENTURE_START_* help popup on map load and when the adventure screen appears, cancelling a tutorial that is already pending
  • the popups from hide_all_popups only cover ADVENTURE_POPUP_* contexts, so the start tutorial sequence was entirely unhandled

Fixes DFHack/dfhack#5779

Testing

  • In a live adventure session (DF 0.53.16): skip_adventure_tutorial closes a forced ADVENTURE_START_MESSAGE popup and clears the pending flag
  • Verified live that setting need_to_do_tutorial advances the help context to ADVENTURE_START_MESSAGE, confirming the flag drives the tutorial sequence
  • The setup screen itself was not exercised end to end (creating a fresh adventurer); the want_tutorial write is a single field assignment verified against the current structures

The first adventure tutorial (enabled by the tutorial checkbox at
adventurer creation) was not covered: it is not a POPUP_ context, so
hide_all_popups never touched it, and the dialog requires dismissing
through the ? button.

Now the setup screen's want_tutorial checkbox defaults to off (the
player can still opt in), and a pending tutorial is cancelled on map
load / dungeonmode entry by clearing plotinfo.flags.need_to_do_tutorial
and closing any open ADVENTURE_START_* help popup.

Fixes DFHack/dfhack#5779
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.

Issue: hide-tutorials doesn't hide first adventure mode tutorial

1 participant