<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>
| 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.
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 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.
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. |
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 <br/> 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.