Campaign Tiles Generator

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

Overview

ui_gameplaySelector_tileGenerators_campaignTiles provides campaign tiles and detail panels for the gameplay selector. Campaigns are loaded from campaign_campaignsLoader and marked as legacy/deprecated content.

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

Exports (M)

Internals

Tile Structure

Each campaign item includes:

{
  name = translate(campaign.title),
  system = "Campaigns (deprecated)",
  type = "Campaign (deprecated)",
  level = translate(core_levels.getLevelTitle(campaign.level)),
  sourceIcons = {},          -- beamNG icon if official, bug icon if auxiliary
  order = -tonumber(campaign.date),
  isLegacy = true,
  key = "campaign_<sourceFile>",
  validBackends = {gameplaySelector = true},
}

Detail Panel

The detail panel includes:

• Specifications: difficulty, authors, creation date, multiplayer info, scenario count
• Legacy notice: "Campaign system is outdated"
• Tags: official, auxiliary, mod info
• Button: "Start Campaign" - calls campaign_campaignsLoader.start(campaign) and tracks recent usage

Key Generation

local function getKeyFromDetails(details)
  return string.format("campaign_%s", details.campaignSourceFile)
end

How It Works

1. The gameplay selector fires onGameplaySelectorGetTiles hook
2. This generator iterates all campaigns from campaign_campaignsLoader.getList()
3. Each campaign is converted to a tile with system/type/level metadata
4. When a user selects a campaign, onGameplaySelectorGetDetails loads full data
5. The "Start Campaign" button launches the campaign and tracks recent usage

Additional Exports

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

• M.onGameplaySelectorGetDetails
• M.onGameplaySelectorGetTiles

See Also

• Level Tiles Generator - Related reference
• Mission Tiles Generator - Related reference
• Scenario Tiles Generator - Related reference
• UI System Guide - Guide