Tile Grouping

Assigns vehicle configs to display groups (Type, Brand, Country, Value, Years, etc.).

Overview

ui_vehicleSelector_tileGrouping determines which visual group(s) a vehicle config belongs to in the selector grid. Supports categorical groups (Type, Brand, Country, etc.) and range-based groups (Years, Value). Also inserts configs into special Favourites/Recent groups.

Extension path: lua/ge/extensions/ui/vehicleSelector/tileGrouping.lua

Exports (M)

Data Fields

Internals

Type Ordering

Car           → "Cars and Trucks"    (10)
Truck         → "Cars and Trucks"    (20)
Heavy Machinery → "Heavy Machinery"  (30)
Trailer       → "Trailers"           (80)
Prop          → "Props"              (90)

Group Mode Functions

Range Groups

Special Groups

If favourites/recent display is enabled, configs are also added to Favourites (order -1) and Recent (order -2) groups.

How It Works

1. getGroupsForConfig reads the relevant property from the config (or model fallback).
2. For categorical modes, calls the group function to get a {groupName, groupOrder}.
3. For range modes, calls the range function to get one or more bucket groups.
4. Appends Favourites/Recent groups if the config qualifies and display settings allow it.

Lua Examples

local tileGrouping = require('/lua/ge/extensions/ui/vehicleSelector/tileGrouping')

-- Get groups for a config
local groups = tileGrouping.getGroupsForConfig(config, "Type", displayData)
-- → {{groupName = "Cars and Trucks", groupOrder = 10}}

-- Check if a mode is range-based
local isRange = tileGrouping.isRangeGroupMode("Value")  -- true

Additional Exports

The following exports are available but not yet documented in detail:

• M.getConfigOrModelPropValue
• M.getGroupModeFunction
• M.getGroupsForConfig
• M.getRangeGroupingFunction
• M.isRange
• M.isRangeGroupMode

See Also

• Vehicle Selector – Details Interaction - Related reference
• Vehicle Selector – General - Related reference
• Vehicle Selector – Tile Clustering - Related reference
• UI System Guide - Guide