API ReferenceGE Extensionsflowgraphnodesui
Tasklist Task (Flowgraph Node)
- **Node Name:** `Tasklist Task`
Overview
- Node Name:
Tasklist Task - Category:
once_instant - File:
extensions/flowgraph/nodes/ui/tasklistTask.lua
Shows a task/goal entry in the Tasklist App UI. Each task has a label, optional subtext, and status flags for done/fail/active states.
Note: The message app does not handle labels that start directly with a number - always prepend a string.
Pin Schema
Input Pins
| Pin | Type | Default | Description |
|---|---|---|---|
label | any | - | Display label for the goal |
sub | any | - | Subtext for the goal (hidden, tasklist only) |
identifier | string | 'flowgraph' | ID for the goal; only one message per ID shown |
done | bool | false | Whether the goal has been fulfilled |
fail | bool | - | Whether the goal has failed (hidden) |
clear | bool | true | Enable to clear the goal (hidden) |
active | bool | true | Whether the goal is active (hidden) |
attention | bool | true | Whether the goal blinks in UI for attention (hidden) |
Output Pins
Standard flow output only.
Internals
Key Methods
| Method | Description |
|---|---|
workOnce() | Triggers SetTasklistTask guihook with all pin values |
How It Works
- On execution,
workOnce()fires theSetTasklistTaskguihook with a table containingclear,label,subtext,done,fail,active,id,type, andattention. - If no
identifieris provided, defaults to"__" .. self.id. - The
typefield is always"goal".
Usage Example
-- Trigger a tasklist task via guihooks directly:
guihooks.trigger("SetTasklistTask", {
label = "Reach the checkpoint",
subtext = "Drive to the marked location",
done = false,
fail = false,
active = true,
id = "checkpoint_1",
type = "goal",
attention = true,
clear = false,
})
-- To clear a task:
guihooks.trigger("SetTasklistTask", {
id = "checkpoint_1",
clear = true,
})Key Dependencies
guihooks.trigger("SetTasklistTask", ...)- sends task data to the tasklist app UI
See Also
- Medal / Auto Medal (Flowgraph Node) - Related reference
- Clear Messages (Flowgraph Node) - Related reference
- Context Translation (Flowgraph Node) - Related reference
- FlowGraph Guide - Guide