Scenario Tiles Generator

Tile generator for legacy scenario entries in the gameplay selector grid.

Overview

ui_gameplaySelector_tileGenerators_scenarioTiles provides tiles and detail panels for the deprecated scenario system. Scenarios are loaded from scenario_scenariosLoader and displayed in the "Scenarios (deprecated)" system group.

Extension path: lua/ge/extensions/ui/gameplaySelector/tileGenerators/scenarioTiles.lua

Exports (M)

Internals

Tile Structure

{
  name = translate(scenario.name),
  system = "Scenarios (deprecated)",
  type = "Scenario (deprecated)",
  level = translate(core_levels.getLevelTitle(scenario.levelName)),
  isLegacy = true,
  key = "scenario_<sourceFile>",
  order = -tonumber(scenario.date),
  validBackends = {gameplaySelector = true},
}

Detail Panel Specifications

Includes: difficulty, authors, creation date, map, multiplayer info, goals list, and a legacy notice ("Scenario system is outdated").

Tags

• Official (beamNG icon), Auxiliary (bug icon), Mod info (puzzle icon)

Start Button

buttonInstance.addButton(function()
  backend.trackRecent(itemDetails.key)
  scenario_scenariosLoader.start(scenario)
end, {
  label = "Start Scenario",
  primary = true,
  isDoubleClickAction = true,
  waitForLoadingScreen = true,
})

How It Works

1. Hook collects scenarios from scenario_scenariosLoader.getList(nil, false, true)
2. Each scenario produces a tile with level/system metadata
3. Scenarios are clustered by level in automatic mode
4. Detail panel loads full scenario data and displays specs
5. "Start Scenario" button launches the scenario and tracks recent usage

Additional Exports

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

• M.onGameplaySelectorGetDetails
• M.onGameplaySelectorGetTiles