Groups Reference

Module defined in lua/common/jbeam/groups.lua. Processes group arrays on JBeam rows, converting group name lists into indexed lookup tables and assigning group IDs.

---

Exports

Functions

M.process(vehicle)

Walks all sections/rows of the vehicle data. For each row with a group field (table of group name strings), assigns unique integer IDs to each group name and converts the group array into a map of {[groupId] = groupName}. Sets row.firstGroup to the first group's ID. Populates vehicle.groups with the global {groupName → groupId} map.

• Parameters:
  • vehicle - table - The assembled vehicle data table
• Returns: self (module table, for chaining)

Internal Notes

• Group IDs are assigned incrementally starting from 0.
• Empty string group names ("") are skipped.
• The vehicle.groups table maps group name → integer ID (shared across all sections).
• Must run after processWheels and processRotators since those add rows with group data.
• row.firstGroup stores the ID of the first non-empty group for quick access.

---

See Also

• ExpressionParser Reference - Related reference
• Interaction Reference - Related reference
• IO Reference - Related reference
• Common Libraries Overview - Guide