Monologue (Flowgraph Node)

Overview

• Node Name: Monologue
• Category: once_f_duration
• File: extensions/flowgraph/nodes/ui/monologue.lua

Shows a sequence of messages one after another using the ui_message toast system. Each message has its own duration. The node has a duration behaviour - it starts, plays through all messages, then finishes.

Pin Schema

Input Pins

Dynamic Pins

The node supports a configurable count. For each index i, two pins are created:

• message_<i> (any) - the message text
• duration_<i> (number, default 5) - duration in seconds

Internals

How It Works

1. workOnce() - Resets time to 0 and sets duration state to 'started'.
2. work() - Called each frame:
   • On first call, computes endTime by summing all durations.
   • If time >= endTime, sets duration state to 'finished'.
   • Otherwise, advances time by dtSim and iterates through messages:
     • Accumulates elapsed time per message.
     • When the current time falls within a message's window and it hasn't been shown yet, calls ui_message() with the message text, duration, category, and icon.
3. drawCustomProperties() - Editor UI with an integer input to change the message count.
4. updatePins(old, new) - Adds or removes message_<i> / duration_<i> pin pairs.

Serialization

• _onSerialize() - Saves mode and count.
• _onDeserialized() - Restores count and rebuilds pins via updatePins(1, count).

Lua Code Example

-- What the node does internally for each message:
ui_message("Watch out for the turn!", 5, "flowgraph", "error")

-- After 5 seconds, the next message appears:
ui_message("Great job!", 3, "flowgraph", "error")

Key Dependencies

• ui_message() - BeamNG toast message function
• Duration behaviour mixin - provides setDurationState() for started/finished lifecycle

See Also

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