Get Progress Node
Retrieves the aggregated progress data for the current mission's progress key, formatting it as text and HTML for display. Category: `once_p_duration`.
Retrieves the aggregated progress data for the current mission's progress key, formatting it as text and HTML for display. Category: once_p_duration.
Pins
Inputs
| Name | Type | Fixed | Description |
|---|---|---|---|
flow | flow | yes | Execution trigger (implicit) |
Outputs
| Name | Type | Fixed | Description |
|---|---|---|---|
aggregate | table | yes | Raw aggregate data object |
bestType | string | yes (hidden) | Best attempt type achieved |
passed | bool | yes (hidden) | Whether mission has been passed |
completed | bool | yes (hidden) | Whether mission has been completed |
attemptCount | number | yes (hidden) | Total number of attempts |
mostRecentDate | number | yes (hidden) | Timestamp of most recent attempt |
aggText | string | yes | Aggregate as plain text ("key: value. key: value.") |
aggHtml | string | yes | Aggregate as HTML unordered list |
| (custom) | any | no | allowCustomOutPins - aggregate fields auto-mapped to matching pins |
Behavior
C:workOnce():- Resolves progress key from
activity.currentProgressKeyordefaultProgressKey - Reads
saveData.progress[progressKey].aggregate - Formats all aggregate fields as text and HTML list
- Maps individual aggregate keys to any matching custom output pins
- Resolves progress key from
savePins = truefor persistent custom pins- Numbers formatted with
%0.2d, strings as-is
Usage Example
-- Connect to display progress on start screen:
-- [Activity Flow].started → [Get Progress] → [UI Display]
-- Output example:
-- aggText: "bestTime: 45. attemptCount: 03. passed: true."
-- aggHtml: "<ul><li>bestTime: 45</li><li>attemptCount: 03</li>...</ul>"
-- Custom output pins named to match aggregate keys
-- get their values automaticallyAdditional Exports
init()
-
color-any- (see source) -
description-string- (see source) -
category-string- (see source) -
pinSchema-table- (see source) -
tags-table- (see source)
See Also
- Activity Attempt Node - Related reference
- Activity Flow Node - Related reference
- Activity Hook Trigger Node - Related reference
- FlowGraph Guide - Guide
Auto Star Goals Node
Automatically populates the tasklist UI app with goals derived from the mission's active stars. Category: `once_instant`.
Mission Attempt Stars Node
Adds star data to an attempt using the mission type's `addAttemptData` constructor method, allowing mission-type-specific star logic. Category: `once_instant`.