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`.
Adds star data to an attempt using the mission type's addAttemptData constructor method, allowing mission-type-specific star logic. Category: once_instant.
Pins
Inputs
| Name | Type | Fixed | Description |
|---|---|---|---|
flow | flow | yes | Execution trigger (implicit) |
attempt | table (attemptData) | yes | Attempt data to modify |
| (custom) | any | no | User-added pins become data fields for the constructor |
Outputs
| Name | Type | Fixed | Description |
|---|---|---|---|
attempt | table (attemptData) | yes | Modified attempt with stars added by constructor |
Behavior
C:workOnce():- Collects non-fixed, non-flow custom pin values into
pinData - Calls
self.mgr.activity:addAttemptData(attempt, pinData)if available - Passes through modified attempt
- Collects non-fixed, non-flow custom pin values into
- Unlike
attemptStars(which directly setsunlockedStars), this delegates to the activity's own star logic allowCustomInPins = true,savePins = true
Usage Example
-- For mission types with custom star evaluation:
-- [Activity Attempt] → [Mission Attempt Stars] → [Aggregate Attempt]
-- The activity's addAttemptData method handles star logic:
function MissionType:addAttemptData(attempt, pinData)
attempt.unlockedStars = attempt.unlockedStars or {}
if pinData.lapTime < self.goldTime then
attempt.unlockedStars.star_gold = true
end
endComparison with attemptStars
| Feature | attemptStars | missionAttemptStars |
|---|---|---|
| Star logic | Direct bool pins → unlockedStars | Delegated to activity:addAttemptData() |
| Custom pins | Bool only | Any type |
| Use case | Simple pass/fail stars | Mission-type-specific evaluation |
Additional Exports
init()
-
name-string- (see source) -
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
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`.
Request Abandon Node
Listens for the player pressing the abandon/quit button during a mission. When this node exists in a flowgraph, the mission must be stopped manually (auto-stop is suppressed). Category: `logic`.