StartScreen Drag Dial (Flowgraph Node)

Overview

• Node Name: StartScreen Drag Dial
• Category: repeat_instant
• File: extensions/flowgraph/nodes/ui/updatedUI/startScreenDial.lua

Adds a drag race dial setup panel to the start screen, allowing racers to set their target dial time. The racer who finishes closest to their dial without going under wins.

Pin Schema

Input Pins

Output Pins

Internals

Key Methods

How It Works

1. init() creates a panel: { type = "dragDial", header = "Dial Setup", text = "...", dials = {}, pages = { main = true } }.
2. On each work(), fetches drag data via gameplay_drag_general.getData().
3. Iterates over racers, creating a dial entry for each with label (Player/Opponent + Lane), key, default value (12), and disabled flag for non-playable racers.
4. Adds the panel via mgr.modules.ui:addUIElement() and outputs the dials table.
5. onDialSetByDialPanel() is called from the UI when the player adjusts their dial.

Usage Example

-- Flowgraph chain:
-- [StartScreen Begin] → (build) → [StartScreen Drag Dial] → [Screen Finish]
--                                        ↓ dials (table of dial settings)

-- Each dial entry looks like:
{
  label = "Player's Dial: Lane 1",
  key = "player",
  value = 12,         -- default dial time in seconds
  disabled = false,    -- player can edit
  racerId = "racer1"
}

Key Dependencies

• gameplay_drag_general.getData() - provides racer/lane data
• mgr.modules.ui:addUIElement() - adds the dial panel
• onDialSetByDialPanel hook - UI callback for dial changes

See Also

• EndScreen Begin (Flowgraph Node) - Related reference
• EndScreen Drift Stats (Flowgraph Node) - Related reference
• EndScreen Lap Times (Flowgraph Node) - Related reference
• FlowGraph Guide - Guide