CrimsonUI · Lesson 5 of 9

Register Layers in a Root Layout

Beginner5 minSetupBlueprints

Before you start

  • Completed: Give CommonUI Click & Back Actions
Video coming soon

Chapters

1. Define your layer tags

Layers are gameplay tags under `UI.Layer` — define UI.Layer.Game and UI.Layer.GameMenu in Project Settings → Gameplay Tags. CrimsonUI natively ships UI.Layer.Menu and UI.Layer.Modal, and CrimsonCommon adds UI.Layer.ContextMenu. Layer pickers are restricted to the UI.Layer category.

2. Build the root layout

Create a widget Blueprint parented on `CrimsonPrimaryGameLayout`. Give it one Common Activatable Widget Stack child per layer (a full-screen overlay of stacks), then on Event On Initialized call Register Layer once per stack, pairing each layer tag with its stack.

The root layout: one CommonActivatableWidgetStack per layer, each registered with its UI.Layer tag.
Unregistered = silent
Pushing to a tag that was never registered does nothing, with no warning. If a screen refuses to appear, confirm its layer tag has a matching RegisterLayer call.

Resources