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

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

NameTypeFixedDescription
flowflowyesExecution trigger (implicit)

Outputs

NameTypeFixedDescription
aggregatetableyesRaw aggregate data object
bestTypestringyes (hidden)Best attempt type achieved
passedboolyes (hidden)Whether mission has been passed
completedboolyes (hidden)Whether mission has been completed
attemptCountnumberyes (hidden)Total number of attempts
mostRecentDatenumberyes (hidden)Timestamp of most recent attempt
aggTextstringyesAggregate as plain text ("key: value. key: value.")
aggHtmlstringyesAggregate as HTML unordered list
(custom)anynoallowCustomOutPins - aggregate fields auto-mapped to matching pins

Behavior

  • C:workOnce():
    1. Resolves progress key from activity.currentProgressKey or defaultProgressKey
    2. Reads saveData.progress[progressKey].aggregate
    3. Formats all aggregate fields as text and HTML list
    4. Maps individual aggregate keys to any matching custom output pins
  • savePins = true for 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 automatically

Additional 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`.

On this page

PinsInputsOutputsBehaviorUsage ExampleAdditional Exportsinit()See Also