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

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

NameTypeFixedDescription
flowflowyesExecution trigger (implicit)
attempttable (attemptData)yesAttempt data to modify
(custom)anynoUser-added pins become data fields for the constructor

Outputs

NameTypeFixedDescription
attempttable (attemptData)yesModified attempt with stars added by constructor

Behavior

  • C:workOnce():
    1. Collects non-fixed, non-flow custom pin values into pinData
    2. Calls self.mgr.activity:addAttemptData(attempt, pinData) if available
    3. Passes through modified attempt
  • Unlike attemptStars (which directly sets unlockedStars), 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
end

Comparison with attemptStars

FeatureattemptStarsmissionAttemptStars
Star logicDirect bool pins → unlockedStarsDelegated to activity:addAttemptData()
Custom pinsBool onlyAny type
Use caseSimple pass/fail starsMission-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`.

On this page

PinsInputsOutputsBehaviorUsage ExampleComparison with attemptStarsAdditional Exportsinit()See Also