Set UI Race Recovery (Flowgraph Node)

Overview

• Node Name: Set UI Race Recovery
• Category: repeat_instant
• File: extensions/flowgraph/nodes/ui/raceRecoveriesUsed.lua
• Author: BeamNG

Sets the UI recovery counter to show how many recoveries the player has used. Supports both numeric and custom string display. Clears when no value or no flow is active.

Pin Schema

Input Pins

How It Works

1. work() - Called every frame:
   • If cur is set and flow is active:
     • If cur is a string: passes it directly to guihooks.trigger('RaceRecoveryCounterSet', str).
     • If cur is a number and max is set: formats as "Recoveries Used: cur / max".
     • If cur is a number without max: formats as "Recoveries Used: cur".
   • Otherwise: triggers guihooks.trigger('RaceRecoveryCounterReset') to clear.

Lua Code Example

-- Show recoveries with max:
guihooks.trigger('RaceRecoveryCounterSet', "Recoveries Used: 2 / 5")

-- Show recoveries without max:
guihooks.trigger('RaceRecoveryCounterSet', "Recoveries Used: 3")

-- Custom string:
guihooks.trigger('RaceRecoveryCounterSet', "No recoveries left!")

-- Clear:
guihooks.trigger('RaceRecoveryCounterReset')

Key Dependencies

• guihooks.trigger('RaceRecoveryCounterSet', str) - Sets the recovery counter text
• guihooks.trigger('RaceRecoveryCounterReset') - Clears the recovery counter

See Also

• Medal / Auto Medal (Flowgraph Node) - Related reference
• Clear Messages (Flowgraph Node) - Related reference
• Context Translation (Flowgraph Node) - Related reference
• FlowGraph Guide - Guide