<aside> 💡

v3 builds on the slot-based system (AG0_MFDManagerComponent + AG0_MFDSlotComponent). It adds bezel keys you can press with a cursor, a page stack, display state keys, overlays, conditions and self-drawing canvas widgets. None of it requires a script: everything is set up in the slot prefab and in the page layouts. MFDF never requires Rotor Framework. Rotor Framework aircraft simply publish more signals for the pages to read.

</aside>

How a v3 display fits together

Piece Lives on What it does
AG0_MFDManagerComponent vehicle root Registers slots, runs the update loop, replicates every display's state, owns the bezel cursor.
AG0_MFDSlotComponent each display's slot entity Pages, keys, overlays, theme, bezel hotspots and electrical gating for that one display.
Page layout UI/layouts/*_v3.layout Frames carrying canvas widget components (tapes, readouts, attitude, HSD...) plus soft-key label widgets.
AG0_MFD_BezelKey ActionsManagerComponent (optional) Action-menu fallback for a bezel key, labelled from the current page.

The fastest start is to duplicate the H-47 Chinook MFD prefab and its v3 layouts, then trim them down.

Pages and the page stack

Each entry in Available Pages (AG0_MFDPageDef) has:

Field Description
PageLayoutPath The page's layout.
PageId Path-style id. Top level: VSD, HSD, WCA. Subpage: INST/FUEL. Falls back to PageName.
Bezel What each key does while this page is on top (see Bezel entries).
DefaultOverlays Overlay ids switched on when the page is entered.
InheritBezel Keys not assigned here fall through to the parent page (INST/FUEL inherits INST).

Pages sit on a stack. Push opens a page on top (use it for anything that should return), Goto replaces the top, Pop returns to the page underneath, and Home clears the stack to Default Page Index.

Keys (display state)

Keys are named integers that make up a display's state, for example screen.half, hsd.map, map.scale. They replicate with the display. Each AG0_MFDKeyDef has:

Field Description
Name Key name, e.g. hsd.centered.
Default Value at first power-on.
Min / Max Range for IncKey / CycleKey.
Wrap Wrap at the ends instead of clamping.
CycleValues Explicit values CycleKey steps through, e.g. 1,2,5,10,20.

Widgets and conditions read keys by name. A widget can bind straight to a key instead of a signal.

Overlays

An overlay (AG0_MFDOverlayDef, id = PageName) is a layout drawn on top of the current page. A half-format VSD is an overlay. Fields:

Field Description
PageLayoutPath Optional. An overlay with no layout can still carry bezel entries.
Bezel Entries that override the page's entries for the same key while the overlay is shown.
ExclusiveWith Overlay ids hidden when this one is shown.
AllowedWhen Live condition. A switched-on overlay only shows while it holds, e.g. key screen.half and not page VSD.

Bezel entries

Each page or overlay lists AG0_MFDBezelEntry items. Several entries can share a KeyId: the first visible entry for a key wins, so stateful keys are written as one entry per state.

Field Description
KeyId Edge letter + index: T1..T7, B1..B7, L1..L9, R1..R9. Must match the bezel map.
Label Soft-key label. Use &lt;br/&gt; for line breaks (the 3D tooltip and action menu show it on one line). {key} inserts the value of LabelKey.
LabelKey Key whose value replaces {key}.
Command What a press does (table below).
Arg / IntArg Argument for the command.
VisibleWhen Condition for the entry to exist at all. Empty = always.
EnabledWhen When false the label draws dimmed and presses do nothing.
BoxedWhen Draws a box around the label (active control layer).
StrikeWhen Draws a cyan strike-through (selection unavailable).
Command Arg / IntArg
Push / Goto Page id.
Pop / Home -
ToggleOverlay / ShowOverlay / HideOverlay Overlay id.
SetKey Key name, IntArg = value.
ToggleKey Key name (0 and 1).
CycleKey Key name (next CycleValue, or Min..Max).
IncKey Key name, IntArg = step (may be negative).
Power Toggles display power. Keep this for the power control only.
Brightness IntArg = percent step.
MapZoom IntArg = percent step.
Script Class name of an AG0_MFDCommandHandler subclass.
Sequence Several steps in one press, separated by semicolons: goto ID, push ID, pop, home, set KEY N, toggle KEY, cycle KEY, inc KEY N, show OVL, hide OVL, overlay OVL. Example: set screen.half 1; goto HSD.

An entry with no command is a pure status label: it shows but a press does nothing.