RLS Studios
ProjectsPatreonCommunityDocsAbout
Join Patreon
BeamNG Modding Docs

Guides

Reference

Server CommandsGE UtilitiesGame Engine MainNavigation GraphScreenshot CaptureServerServer ConnectionSpawnpoint ManagerSimulation TimeVehicle SpawningSuspension Frequency Tester
Flowgraph Base ModuleFlowgraph Base NodeFlowgraph Base State NodeFlowgraph Node BuilderFlowgraph GraphFlowgraph Group HelperFlowgraph LinkFlowgraph ManagerNew Node TemplateFlowgraph PinFlowgraph States ManagerFlowgraph UtilsFlowgraph Variable Storage
Activity Attempt NodeActivity Flow NodeActivity Hook Trigger NodeActivity Reset Prefabs NodeFinish Mission Node (Activity Stop)Aggregate Attempt NodeActivity Attempt Stars NodeActivity Attempt Vehicle NodeAuto Star Goals NodeGet Progress NodeMission Attempt Stars NodeRequest Abandon NodeStars Active (Flowgraph Node)

UI

Resources

BeamNG Game Engine Lua Cheat SheetGE Developer RecipesMCP Server Setup

// RLS.STUDIOS=true

Premium Mods for BeamNG.drive. Career systems, custom vehicles, and immersive gameplay experiences.

Index

HomeProjectsPatreon

Socials

DiscordPatreon (RLS)Patreon (Vehicles)

© 2026 RLS Studios. All rights reserved.

Modding since 2024

API ReferenceGE Extensionsflowgraphnodesactivity

Aggregate Attempt Node

Aggregates a mission attempt into persistent progress data, producing change objects for UI display including leaderboard updates, star unlocks, and outro text. Category: `once_p_duration`.

Aggregates a mission attempt into persistent progress data, producing change objects for UI display including leaderboard updates, star unlocks, and outro text. Category: once_p_duration.


Pins

Inputs

NameTypeFixedDescription
flowflowyesExecution trigger (implicit)
attempttable (attemptData)yesAttempt data from upstream nodes
progressKeystringyesProgress key override (defaults to activity's current/default)

Outputs

NameTypeFixedDescription
changetableyesFull change object with aggregateChange, unlockedStars, etc.
outroTextstringyesOutro text for highest achieved default star
outroTranslationtable (translationObject)yesTranslation-ready outro with attempt context
newBestTypeboolyes (hidden)Whether a new best type was achieved
(custom)anynoallowCustomOutPins - aggregate change fields auto-mapped

Behavior

  • C:workOnce():
    1. Resolves progress key (pin → activity current → activity default)
    2. Calls gameplay_missions_progress.aggregateAttempt(missionId, attempt, progressKey)
    3. Saves mission data if not in career mode
    4. Stops AI recording if module exists
    5. Determines highest default star outro text from careerSetup.starOutroTexts or defaultStarOutroTexts
    6. Maps all aggregateChange fields to matching custom output pins

Outro Text Resolution Order

  1. Check each default star (sorted) for unlocked status
  2. Use careerSetup.starOutroTexts[starKey] → fallback defaultStarOutroTexts[starKey]
  3. If no default star unlocked: noStarUnlocked text
  4. If no default stars exist: noStarExists text

Usage Example

-- Standard mission end pipeline:
-- [Activity Attempt] → [Attempt Stars] → [Aggregate Attempt] → [UI Module addRatings]

-- The change object contains:
-- change.aggregateChange - leaderboard/best changes
-- change.unlockedStarsAttempt - stars unlocked this attempt
-- change.unlockedStarsChanged - stars newly changed
-- change.starRewards - reward info per star
-- change.unlockedMissions, change.unlockedLeagues - progression unlocks

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

Finish Mission Node (Activity Stop)

Stops the current mission/activity. Defers the actual stop to `_afterTrigger` to allow the current frame's flowgraph execution to complete. Category: implicit (flow-driven).

Activity Attempt Stars Node

Adds star unlock flags to an attempt data object. User adds custom boolean pins named after star keys. Category: `once_instant`.

On this page

PinsInputsOutputsBehaviorOutro Text Resolution OrderUsage ExampleAdditional Exportsinit()See Also