Get Map Objects IDs by DynField (Flowgraph Node)

Overview

• Node Name: Get Map Objects IDs by DynField
• Category: repeat_instant
• File: extensions/flowgraph/nodes/util/getMapObjectsDynField.lua

Searches all map objects and returns a list of IDs for objects that contain a specific dynamic field.

Pin Schema

Input Pins

Output Pins

Internals

Key Methods

How It Works

1. Iterates all entries in map.objects to get object IDs.
2. For each object ID, calls getObjectByID(objId) to get the object reference.
3. Calls object:getDynamicFields() and checks each field name against the search term.
4. Matching object IDs are collected into a table and output.

Note: This runs every frame (repeat_instant) and iterates all map objects, which can be expensive. Consider connecting a flow gate if performance is a concern.

Usage Example

-- Find all objects with a custom "checkpoint" dynamic field:
-- [Get Map Objects IDs by DynField] dynamicFieldName="checkpoint"
--   → objects → [For Each] → [Get Object] → [Process Checkpoint]

-- Find vehicles with a specific marker:
-- [Get Map Objects IDs by DynField] dynamicFieldName="isRaceParticipant"
--   → objects → [Get First Element] → [Focus Camera]

Key Dependencies

• map.objects - map object registry
• getObjectByID() - engine function to resolve object references
• object:getDynamicFields() - returns list of dynamic field names on an object

See Also

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