Push Action Map

Overview

• Node Name: Push Action Map
• Category: once_instant
• File: extensions/flowgraph/nodes/util/pushActionMap.lua

Pushes an action map onto the input stack, enabling its input bindings. Automatically pops the action map when execution stops.

Pin Schema

Input Pins

Internals

Key Methods

Auto-Cleanup

When the flowgraph execution stops, _executionStopped() automatically pops the action map. This ensures no stale action maps remain on the stack.

Known Issues

The node's todo field notes: "Weird behaviour if multiple projects use the same action map."

How It Works

1. workOnce() reads the action map name from the input pin and calls pushActionMap(name).
2. Stores the name in self.mapName for later cleanup.
3. The editor displays the pushed map name in the node's middle area.
4. On execution stop, automatically pops the map to prevent input conflicts.

Usage Example

-- Enable custom race controls during a race:
-- [Race Start] → flow → [Push Action Map] name="RaceControls"
-- ...race gameplay... (map auto-pops when flowgraph stops)

-- Or explicitly pop:
-- [Race End] → flow → [Pop Action Map] name="RaceControls"

Key Dependencies

• pushActionMap() - engine function to push an action map onto the stack
• popActionMap() - engine function to remove an action map from the stack

See Also

• Route Distance (Flowgraph Node) - Related reference
• Closest Road (Flowgraph Node) - Related reference
• Custom Lua (Flowgraph Node) - Related reference
• FlowGraph Guide - Guide