End Screen (Flowgraph Node)

Overview

• Node Name: End Screen
• Category: once_instant
• File: extensions/flowgraph/nodes/ui/endScreen.lua

Shows the scenario/mission end screen with customizable buttons, stats, medals, and portraits. Triggers the scenario-end UI state.

Pin Schema

Input Pins

Dynamic Pins

Custom button pins are created via the editor. Each button adds:

• Input: string - button label text
• Output: flow - fires when that button is clicked

Internals

Key Methods

Data Properties

How It Works

1. When triggered, workOnce() calls openDialogue().
2. openDialogue() assembles a statsData table with title, text, time, medal, points, buttons, and portrait info.
3. If the flowgraph has an associated mission activity, it also builds missionData with progress, leaderboard, and star info.
4. It triggers guihooks.trigger('ChangeState', {state = 'scenario-end', params = {...}}).
5. Custom buttons call back via core_flowgraphManager.getManagerGraphNode(...) to invoke buttonPushed().
6. When a button is pushed, the corresponding output flow pin fires and the dialogue closes.

Usage Example

-- The node builds and triggers data like:
guihooks.trigger('ChangeState', {
  state = 'scenario-end',
  params = {
    stats = {
      title = "Race Complete",
      text = "You finished in 1st place!",
      time = "01:23.45",
      overall = { failed = false, medal = "gold", points = 100, maxPoints = 100 },
      buttons = {
        { label = "Retry", cmd = 'extensions.hook("onResetGameplay")' },
        { label = "Continue", cmd = '...' },
      },
    },
    portrait = { success = "/ui/portraits/happy.png" },
  }
})

Key Dependencies

• guihooks.trigger('ChangeState', ...) - transitions the UI state
• gameplay_missions_missions - mission lookup for next-mission buttons
• gameplay_missions_progress - leaderboard and progress formatting
• core_flowgraphManager.getManagerGraphNode() - button callback routing

Previously Undocumented (Added by Audit)

• C:getCmd(action) - Function handling getCmd logic

See Also

• Medal / Auto Medal (Flowgraph Node) - Related reference
• Clear Messages (Flowgraph Node) - Related reference
• Context Translation (Flowgraph Node) - Related reference
• FlowGraph Guide - Guide