Composing Logic with Stacks

Use Stack when a temporary layer covers the current mode and the previous mode must resume after the layer is removed. Typical uses include nested menus, dialogue input, inspect mode, and tutorial overlays.

Mental model

Stack Root owns the ordered collection. Stack Layer is the item that can be pushed.

Only the top layer receives Update. A layer below it remains paused until every layer above it is popped.

Lifecycle output	Meaning
Push	The layer is added to the stack.
Resume	The layer becomes the active top layer.
Update	The current top layer receives its configured update.
Pause	The layer stops being top.
Pop	The layer is removed.

Build a UI stack

1. Add a Stack Root and name it UiStack.
2. Configure its update interval and interruption policy.
3. Add Stack Layers named Gameplay, PauseMenu, and Options.
4. Set every layer’s Root Name to UiStack.
5. Put show or enable work in Resume.
6. Put hide or disable work in Pause.
7. Put one-time setup and cleanup in Push and Pop.
8. Enable unique layers when a screen must not be pushed twice.

此处插图应该是 UiStack 的 Stack Root 与 Gameplay、PauseMenu、Options 三个 Stack Layer 截图；显示 Push/Resume/Update/Pause/Pop 输出，并用编号标出 Gameplay→PauseMenu→Options 的入栈顺序。

Expected runtime order:

Gameplay active
Push PauseMenu -> Gameplay pauses, PauseMenu resumes
Push Options   -> PauseMenu pauses, Options resumes
Pop Options    -> Options exits, PauseMenu resumes
Pop PauseMenu  -> PauseMenu exits, Gameplay resumes

When Stack is not the owner

Do not use Stack when two systems should update concurrently. Independent movement and upper-body state families are better expressed as separate FSM groups or processes. Do not use Stack merely because several nodes form a list.

Root and layer names are runtime relationships. Keep them stable and add comments around cross-process pushes so target ownership remains visible.

Common mistakes

Symptom	Check
A layer never joins the stack	Its Root Name must match the Stack Root title.
Lower layers keep updating	Confirm their work is connected to the layer Update lifecycle rather than a separate Trigger.
The same menu appears twice	Enable unique layers where duplicates are invalid.
Push waits unexpectedly	Check the root’s Update interruption mode and active Update work.
Two concurrent systems block each other	They should not share one last-in, first-out stack.

Related

• Choosing a Logic Model
• State-Driven Logic with FSM
• Nodes, Ports & Execution Chains