Grid Selector

Facade module that routes all grid selector API calls to the appropriate backend (vehicle, gameplay, app, freeroam).

Overview

ui_gridSelector is a thin routing layer that dispatches API calls to the correct backend module based on backendName. It provides a unified interface for the UI to interact with any selector type.

Extension path: lua/ge/extensions/ui/gridSelector.lua

Dependencies: ui_vehicleSelector_general, ui_gameplaySelector_general, ui_appSelector_general, ui_freeroamSelector_general

Exports (M)

Backend Resolution

Delegated API (all take backendName as first arg)

Data Fields

Internals

Backend Mapping

local function getBackendByName(backendName)
  if backendName == "vehicleSelector" then return ui_vehicleSelector_general
  elseif backendName == "gameplaySelector" then return ui_gameplaySelector_general
  elseif backendName == "appSelector" then return ui_appSelector_general
  elseif backendName == "freeroamSelector" then return ui_freeroamSelector_general
  end
end

Direct Implementations

Two functions are implemented directly rather than delegated:

-- Opens the native file explorer
M.exploreFolder = function(_backendName, path)
  Engine.Platform.exploreFolder(path)
end

-- Navigates to mod details page
M.goToMod = function(_backendName, modId)
  guihooks.trigger('ChangeState', {state = 'menu.mods.details', params = {modId = modId}})
end

Call Pattern

All delegated functions follow the same pattern - strip backendName and forward:

M.getTiles = function(backendName, ...) return getBackendByName(backendName).getTiles(...) end
M.toggleFilter = function(backendName, ...) return getBackendByName(backendName).toggleFilter(...) end

How It Works

1. UI calls ui_gridSelector.getTiles("gameplaySelector", path)
2. getBackendByName resolves to ui_gameplaySelector_general
3. The call is forwarded with remaining arguments
4. Backend processes and returns data to the UI
5. This pattern keeps the UI code backend-agnostic

Additional Exports

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

• M.closedFromUI
• M.executeButton
• M.executeDoubleClick
• M.exitCallback
• M.getActiveFilters
• M.getBackendByName
• M.getDetails
• M.getDisplayDataOptions
• M.getFilters
• M.getManagementDetails
• M.getScreenHeaderTitleAndPath
• M.getSearchText
• M.profilerFinish
• M.resetDisplayDataToDefaults
• M.resetRangeFilter
• M.resetSetFilter
• M.setDisplayDataOption
• M.setSearchText
• M.toggleFavourite
• M.updateRangeFilter