Tasklist Message (Flowgraph Node)

Overview

• Node Name: Tasklist Message
• Category: once_instant
• File: extensions/flowgraph/nodes/ui/tasklistMessage.lua

Shows a goal entry in the Goal List (tasklist) app. Each goal has a label, optional subtext, an identifier for uniqueness, and active/clear states.

Pin Schema

Input Pins

Output Pins

How It Works

1. workOnce() - Triggers guihooks.trigger('SetTasklistTask', data) with:
   • clear - whether to clear this goal entry
   • label - the goal display text
   • subtext - optional secondary text
   • active - whether the goal is currently active
   • id - unique identifier (defaults to "__" .. self.id if not set)
   • type - always "message"

Lua Code Example

-- Add a goal to the tasklist:
guihooks.trigger('SetTasklistTask', {
  clear = false,
  label = "Reach the checkpoint",
  subtext = "Drive to the marked location",
  active = true,
  id = "myGoal_01",
  type = "message",
})

-- Clear a specific goal:
guihooks.trigger('SetTasklistTask', {
  clear = true,
  id = "myGoal_01",
  type = "message",
})

Key Dependencies

• guihooks.trigger('SetTasklistTask', data) - Adds/updates/clears a goal in the tasklist UI

Previously Undocumented (Added by Audit)

• Input Pin: done (any)
• Input Pin: fail (any)

See Also

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