Auto-process smelter and reprocessing plant (no recipe selection)

Add tooltip for building blocks in header bar
Add tooltips for building buttons and module selection buttons
2026-07-12 21:35:23 +02:00 · 2026-07-12 21:24:11 +02:00 · 2026-07-12 21:21:14 +02:00 · 2026-07-12 21:17:10 +02:00
22 changed files with 467 additions and 103 deletions
--- a/bin/app/data/config/buildings.toml
+++ b/bin/app/data/config/buildings.toml
@@ -1,5 +1,6 @@
 [[building]]
 id = "belt"
+tooltip = "Transports items one tile at a time in the direction it faces."
 cost = 2
 player_placeable = true
 construction_time_seconds = 0.2
@@ -7,6 +8,7 @@ surface_mask = ["A>"]

 [[building]]
 id = "splitter"
+tooltip = "Splits an incoming item stream between two outputs, with optional per-output filters."
 cost = 3
 player_placeable = true
 construction_time_seconds = 0.5
@@ -14,6 +16,7 @@ surface_mask = ["<A>"]

 [[building]]
 id = "tunnel_entry"
+tooltip = "Sends items underground to a matching tunnel exit, letting belts cross."
 cost = 5
 player_placeable = true
 construction_time_seconds = 0.5
@@ -21,6 +24,7 @@ surface_mask = ["A>"]

 [[building]]
 id = "tunnel_exit"
+tooltip = "Receives items from a matching tunnel entry and pushes them onward."
 cost = 5
 player_placeable = true
 construction_time_seconds = 0.5
@@ -28,6 +32,7 @@ surface_mask = ["A>"]

 [[building]]
 id = "miner"
+tooltip = "Extracts a selected ore from the asteroid; every tile yields any ore."
 cost = 15
 player_placeable = true
 construction_time_seconds = 1
@@ -37,6 +42,7 @@ surface_mask = [

 [[building]]
 id = "smelter"
+tooltip = "Melts ore or scrap into basic materials. No recipe selection needed."
 cost = 20
 player_placeable = true
 construction_time_seconds = 1
@@ -47,6 +53,7 @@ surface_mask = [

 [[building]]
 id = "assembler"
+tooltip = "Crafts a selected recipe from the production tree into intermediate or final parts."
 cost = 35
 player_placeable = true
 construction_time_seconds = 1
@@ -57,6 +64,7 @@ surface_mask = [

 [[building]]
 id = "reprocessing_plant"
+tooltip = "Consumes scrap and yields one random higher-tier product per cycle."
 cost = 40
 player_placeable = true
 construction_time_seconds = 1
@@ -68,6 +76,7 @@ surface_mask = [

 [[building]]
 id = "shipyard"
+tooltip = "Builds autonomous combat ships from a selected schematic and module layout."
 cost = 60
 player_placeable = true
 construction_time_seconds = 1
@@ -78,6 +87,7 @@ surface_mask = [

 [[building]]
 id = "salvage_bay"
+tooltip = "Drop-off point where salvage ships unload collected scrap onto belts."
 cost = 25
 player_placeable = true
 construction_time_seconds = 1
--- a/bin/app/data/config/modules.toml
+++ b/bin/app/data/config/modules.toml
@@ -32,6 +32,7 @@

 [[module]]
 id = "railgun_s"
+tooltip = "Small railgun. Fast-firing, short range, low damage; fits any hull."
 unlock_at_station_level = -1
 surface_mask = ["O"]
 materials = [{item = "railgun_s_module", amount = 1}]
@@ -47,6 +48,7 @@ attack_rate_hz = 2.0

 [[module]]
 id = "railgun_m"
+tooltip = "Medium railgun. Higher damage at longer range; needs a 2x2 slot."
 unlock_at_station_level = 2
 surface_mask = [
    "OO",
@@ -64,6 +66,7 @@ attack_rate_hz = 1.5

 [[module]]
 id = "railgun_l"
+tooltip = "Large railgun. Heavy damage at long range; needs a 3x3 slot."
 unlock_at_station_level = 6
 unlock_requires = ["railgun_m"]
 surface_mask = [
@@ -86,6 +89,7 @@ attack_rate_hz = 0.8

 [[module]]
 id = "salvager"
+tooltip = "Collects scrap from wrecks and stores it in the ship's cargo hold."
 unlock_at_station_level = -1
 surface_mask = ["O"]
 materials = [{item = "salvager_module", amount = 1}]
@@ -101,6 +105,7 @@ collection_rate_hz = 0.5

 [[module]]
 id = "repair_tool"
+tooltip = "Repairs damaged friendly ships and defence stations within range."
 unlock_at_station_level = 0
 surface_mask = ["O"]
 materials = [{item = "repair_tool_module", amount = 1}]
@@ -119,6 +124,7 @@ repair_range_m = 80

 [[module]]
 id = "afterburner"
+tooltip = "Greatly boosts top speed and forward acceleration."
 unlock_at_station_level = 2
 surface_mask = ["OOO"]
 materials = [{item = "afterburner_module", amount = 1}]
@@ -133,6 +139,7 @@ added_main_acceleration_mpss = 60

 [[module]]
 id = "maneuvering_thrusters"
+tooltip = "Improves top speed and lateral/braking acceleration."
 unlock_at_station_level = 1
 surface_mask = ["OO"]
 materials = [{item = "maneuvering_thrusters_module", amount = 1}]
@@ -150,6 +157,7 @@ added_maneuvering_acceleration_mpss = 10

 [[module]]
 id = "armor_plates"
+tooltip = "Adds a large flat bonus to the ship's hit points."
 unlock_at_station_level = 0
 surface_mask = ["OO"]
 materials = [{item = "armor_plates_module", amount = 1}]
@@ -163,6 +171,7 @@ added_hp = 1200

 [[module]]
 id = "sensor_booster"
+tooltip = "Extends the ship's sensor range."
 unlock_at_station_level = 1
 surface_mask = ["OO"]
 materials = [{item = "sensor_booster_module", amount = 1}]
@@ -179,6 +188,7 @@ added_sensor_range_m = 50

 [[module]]
 id = "weapon_upgrade"
+tooltip = "Increases the damage of all weapons on the ship."
 unlock_at_station_level = 4
 surface_mask = [
    "OO",
@@ -195,6 +205,7 @@ multiplied_damage = 1.2

 [[module]]
 id = "weapon_primer"
+tooltip = "Increases the fire rate of all weapons on the ship."
 unlock_at_station_level = 4
 surface_mask = [
    "OO",
@@ -211,6 +222,7 @@ multiplied_attack_rate_hz = 1.2

 [[module]]
 id = "weapon_stabilizer"
+tooltip = "Extends weapon range at the cost of some fire rate."
 unlock_at_station_level = 3
 surface_mask = [
    "OO",
@@ -234,6 +246,7 @@ multiplied_attack_rate_hz = 0.8

 [[module]]
 id = "drone_bay"
+tooltip = "Drone launch bay (capability not yet implemented)."
 unlock_at_station_level = 5
 surface_mask = [
    "OO",
@@ -246,6 +259,7 @@ glyph = "Db"

 [[module]]
 id = "drone_hangar"
+tooltip = "Large drone hangar (capability not yet implemented)."
 unlock_at_station_level = 9
 surface_mask = [
    "OOOOOO",
--- a/bin/app/data/config/world.toml
+++ b/bin/app/data/config/world.toml
@@ -10,6 +10,7 @@ tunnel_max_distance_tiles = 10
 departure_interval_seconds = 20
 orbit_factor = 0.8
 rally_orbit_radius_tiles = 5.0
+building_blocks_tooltip = "Building blocks are the currency for construction. Spend them to place buildings and to expand the asteroid. Produce building blocks in your factory and deliver them to the HQ on a belt to grow your stock."

 [regions]
 asteroid_width_tiles = 60
--- a/bin/test/data/config/buildings.toml
+++ b/bin/test/data/config/buildings.toml
@@ -84,6 +84,7 @@ cost = 25
 player_placeable = true
 construction_time_seconds = 15
 output_buffer_capacity = 20
+tooltip = "Drop-off point for salvage ships."
 surface_mask = [
  "SAA",
  "SAA>",
--- a/bin/test/data/config/modules.toml
+++ b/bin/test/data/config/modules.toml
@@ -1,5 +1,6 @@
 [[module]]
 id = "armor_plate"
+tooltip = "Adds a large flat bonus to hit points."
 unlock_at_station_level = -1
 surface_mask = ["OO"]
 materials = [{item = "iron_ingot", amount = 2}]
--- a/bin/test/data/config/world.toml
+++ b/bin/test/data/config/world.toml
@@ -10,6 +10,7 @@ tunnel_max_distance_tiles = 10
 departure_interval_seconds = 20
 orbit_factor = 0.8
 rally_orbit_radius_tiles = 5.0
+building_blocks_tooltip = "Spend building blocks to build; deliver them to the HQ to gain more."

 [regions]
 asteroid_width_tiles = 40
--- a/docs/requirements.md
+++ b/docs/requirements.md
@@ -4,11 +4,11 @@

 Config files use the TOML format. The following config files drive game parameters:

- **world.toml** — world dimensions, region widths, expansion amounts, building refund percentage, wave timing, boss wave timing, belt speed, starting building blocks, departure interval, ship orbit factor, rally orbit radius, scrap-per-threat conversion, combat target-selection parameters (target score formula, overclaim penalty formula, target hysteresis), artifact chance formula, artifact win count, and view pan speeds (slow and fast horizontal pan speed and pan ramp band width).
- **buildings.toml** — building block cost and construction time per building type.
+- **world.toml** — world dimensions, region widths, expansion amounts, building refund percentage, wave timing, boss wave timing, belt speed, starting building blocks, departure interval, ship orbit factor, rally orbit radius, scrap-per-threat conversion, combat target-selection parameters (target score formula, overclaim penalty formula, target hysteresis), artifact chance formula, artifact win count, view pan speeds (slow and fast horizontal pan speed and pan ramp band width), and an optional building blocks tooltip string (shown as the header bar's building blocks stock hover tooltip, REQ-UI-BLOCKS-TOOLTIP; omitted when unset).
+- **buildings.toml** — building block cost and construction time per building type, plus an optional tooltip description string per building type (shown as the build button's hover tooltip, REQ-UI-BUILD-TOOLTIP; omitted when unset).
 - **recipes.toml** — crafting recipes: inputs, outputs, quantities, durations, and reprocessing plant probabilities. Assembler recipe entries may optionally define `unlock_at_station_level` (integer): -1 means the recipe is explicitly unlocked at game start; a value ≥ 0 means the recipe starts locked and a schematic for it can be awarded via defence station destruction (see REQ-LOCK-EXPLICIT, REQ-DEF-SCHEMATIC-DROP). An assembler recipe schematic entry may also define an optional `unlock_requires` list of prerequisite schematic ids (REQ-LOCK-PREREQ).
 - **ships.toml** — per schematic: a human-readable display name (used in the UI), hull stats (HP, max linear speed, sensor range, main acceleration, maneuvering acceleration, angular acceleration, max rotation speed) as plain values, required build materials, the station level at which the schematic becomes available for unlock (`unlock_at_station_level`; -1 means the player starts with the schematic already unlocked), an optional `unlock_requires` prerequisite list (REQ-LOCK-PREREQ), a layout grid defining the ship's module slots, and a `default_modules` list used for enemy wave ships (see REQ-WAV-DEFAULT-MODULES).
- **modules.toml** — per module type: id, surface mask, materials list, production time, fill color, glyph, the station level at which the schematic becomes available for unlock (`unlock_at_station_level`; -1 means the player starts with the module schematic already unlocked), an optional `unlock_requires` prerequisite list (REQ-LOCK-PREREQ), and an optional capability section and/or stat modifier formulas. A module with a capability section (`[module.weapon]`, `[module.salvage]`, or `[module.repair]`) containing base stat formulas is a **capability module** that grants the ship a weapon, salvage bay, or repair tool per instance (see REQ-MOD-CONFIG for the full list of formulas per capability type). A module with only `added_*`/`multiplied_*` formulas is a **passive module** that modifies stats on the ship or on capability module instances (see REQ-MOD-STAT-CALC).
+- **modules.toml** — per module type: id, surface mask, materials list, production time, fill color, glyph, an optional tooltip description string (shown as the module selection button's hover tooltip, REQ-MOD-UI-MODULE-TOOLTIP; omitted when unset), the station level at which the schematic becomes available for unlock (`unlock_at_station_level`; -1 means the player starts with the module schematic already unlocked), an optional `unlock_requires` prerequisite list (REQ-LOCK-PREREQ), and an optional capability section and/or stat modifier formulas. A module with a capability section (`[module.weapon]`, `[module.salvage]`, or `[module.repair]`) containing base stat formulas is a **capability module** that grants the ship a weapon, salvage bay, or repair tool per instance (see REQ-MOD-CONFIG for the full list of formulas per capability type). A module with only `added_*`/`multiplied_*` formulas is a **passive module** that modifies stats on the ship or on capability module instances (see REQ-MOD-STAT-CALC).
 - **stations.toml** — HP, damage, range, fire rate, and scrap drop for player and enemy defence stations, defined as formulas of station level.
 - **visuals.toml** — rendering-only config (not game parameters): fill and outline colors and glyphs for every building type, item type, ship schematic, and station type; a distinct beam color per tool type (weapon, repair, salvage) and beam width; overlay and toast colors. Loaded by the UI at startup; the simulation does not read it.
 - **ship_layouts.toml** — named layout blueprints per ship type; written and read by the application to persist the layout blueprint panel (REQ-MOD-UI-BLUEPRINT-PANEL through REQ-MOD-UI-BLUEPRINT-FILE-LOAD). Not a game parameter file; the simulation does not read it.
@@ -269,6 +269,8 @@ Modules in `modules.toml` define a `surface_mask` — a list of strings that des
  - **Right** (below the grid): The layout blueprint panel (see REQ-MOD-UI-BLUEPRINT-PANEL through REQ-MOD-UI-BLUEPRINT-FILE-LOAD).
  - **Bottom**: A "Confirm" button and a "Cancel" button. Cancel discards all changes made in this dialog session and closes the dialog. Confirm applies the changes: the shipyard's configured layout is updated, the required materials and cycle time displayed in the selected building panel are recalculated, and the ship layout preview is refreshed.

+- REQ-MOD-UI-MODULE-TOOLTIP: Each module selection button in the layout configuration dialog (REQ-MOD-UI-DIALOG) shows a hover tooltip with the descriptive text defined for that module type in `modules.toml` (the optional per-module tooltip field). If a module type defines no tooltip text, its button shows no tooltip. The "Remove" button is not a module type and has no config-defined tooltip.
+
 - REQ-MOD-UI-STATS-PANEL: The **ship stats panel** in the layout configuration dialog shows the stats of the currently configured ship layout as they would be computed, incorporating all passive module modifiers per REQ-MOD-STAT-CALC. The panel updates in real time whenever modules are placed or removed in the layout grid.

  The panel always shows all hull stats as final computed values:
@@ -401,6 +403,7 @@ The screen is divided into two columns: a main column (75% width) containing the
 ```

 - REQ-UI-HEADER: The header bar spans the width of the game world column (75% of the screen width) and always shows the elapsed survival time, the current global building blocks stock, and the artifact count (REQ-WIN-ARTIFACT-COUNT) displayed as `Artifacts: x/y` (where `x` is the current artifact count and `y` is `world.toml [world].artifact_win_count`) on the left, the boss wave counter and boss countdown (REQ-UI-BOSS-STATUS) and an asteroid expansion button (REQ-UI-EXPAND-BUTTON) to the left of the speed buttons, and game speed controls on the right.
+- REQ-UI-BLOCKS-TOOLTIP: The header bar's building blocks stock display (REQ-UI-HEADER) shows a hover tooltip with the descriptive text defined in `world.toml [world].building_blocks_tooltip` — intended to tell the player what building blocks are used for and how to obtain them. If the field is unset, the stock display shows no tooltip. This tooltip is distinct from the build/module button tooltips (REQ-UI-BUILD-TOOLTIP, REQ-MOD-UI-MODULE-TOOLTIP).
 - REQ-UI-BOSS-STATUS: The header bar displays, to the left of the speed buttons, the current boss wave counter (REQ-WAV-BOSS-COUNTER) and the time remaining on the boss countdown (REQ-WAV-BOSS-COUNTDOWN). The boss wave counter is shown as `Boss Wave #<x>` and the countdown as `Next boss: <M:SS>`, where `<M:SS>` is the remaining seconds formatted as whole minutes and two-digit seconds. Both values update continuously as the simulation runs.
 - REQ-UI-SPEED: The game speed controls in the header bar are buttons for 0×, 0.5×, 1×, 2×, and 4× speed. The currently active speed is shown as selected. All game simulation (production, movement, threat accumulation, wave timing) scales with the selected speed. 0× pauses the game.
 - REQ-UI-EXPAND-BUTTON: The header bar shows an asteroid expansion button captioned `Expand: <x> Blocks`, where `<x>` is the current expansion cost computed from `world.toml [expansion].cost_building_blocks_formula` at the current number of purchased expansions (REQ-EXP-COST). Clicking the button unlocks the next asteroid expansion (REQ-EXP-UNLOCK, REQ-GW-ASTEROID-EXPAND), spending that many building blocks from the global stock. The button is disabled when the player cannot currently afford the cost (consistent with REQ-UI-BUILD-DISABLED). The caption updates as the cost changes with each purchased expansion.
@@ -473,6 +476,7 @@ The screen is divided into two columns: a main column (75% width) containing the

 - REQ-UI-BUILD-GRID: All placeable building types are shown as a flat grid of buttons with no grouping.
 - REQ-UI-BUILD-COST: Each button caption shows the building name and its building block cost, e.g. "Belt: 2 Blocks".
+- REQ-UI-BUILD-TOOLTIP: Each building-type button shows a hover tooltip with the descriptive text defined for that building type in `buildings.toml` (the optional per-building tooltip field). This tooltip is distinct from the recipe/schematic selection tooltip (REQ-UI-SELECT-TOOLTIP). If a building type defines no tooltip text, its button shows no tooltip. The Demolish button (REQ-UI-DEMOLISH-BUTTON) is not a building type and has no config-defined tooltip.
 - REQ-UI-BUILD-DISABLED: Buttons for buildings the player cannot currently afford are shown as disabled.
 - REQ-UI-DEMOLISH-BUTTON: A dedicated **Demolish** button is shown in the build button grid. Clicking it toggles demolish mode on and off, equivalent to the Q demolish toggle (REQ-UI-HOTKEYS). The button is shown in a visually active/pressed state while demolish mode is active.

--- a/src/lib/config/BuildingsConfig.h
+++ b/src/lib/config/BuildingsConfig.h
@@ -23,6 +23,9 @@ struct BuildingDef
    // Output-buffer holding size for buildings without a recipe-driven buffer.
    // Only the Salvage Bay sets this (REQ-BLD-SALVAGE-BAY).
    std::optional<int> outputBufferCapacity;
+
+    // Optional hover-tooltip text for the build button (REQ-UI-BUILD-TOOLTIP).
+    std::optional<std::string> tooltip;
 };

 struct BuildingsConfig
--- a/src/lib/config/ConfigLoader.cpp
+++ b/src/lib/config/ConfigLoader.cpp
@@ -273,6 +273,12 @@ WorldConfig ConfigLoader::loadWorld(const std::string& path)
    cfg.orbitFactor                = requireDouble(tbl["world"]["orbit_factor"], file, "world.orbit_factor");
    cfg.rallyOrbitRadius_tiles     = requireDouble(tbl["world"]["rally_orbit_radius_tiles"], file, "world.rally_orbit_radius_tiles");

+    if (const std::optional<std::string> tip =
+            tbl["world"]["building_blocks_tooltip"].value<std::string>())
+    {
+        cfg.buildingBlocksTooltip = *tip;
+    }
+
    cfg.regions.asteroidWidth_tiles     = static_cast<int>(requireInt(tbl["regions"]["asteroid_width_tiles"],      file, "regions.asteroid_width_tiles"));
    cfg.regions.playerBufferWidth_tiles = static_cast<int>(requireInt(tbl["regions"]["player_buffer_width_tiles"], file, "regions.player_buffer_width_tiles"));
    cfg.regions.contestZoneWidth_tiles  = static_cast<int>(requireInt(tbl["regions"]["contest_zone_width_tiles"],  file, "regions.contest_zone_width_tiles"));
@@ -343,6 +349,11 @@ BuildingsConfig ConfigLoader::loadBuildings(const std::string& path)
                requireInt(mt["output_buffer_capacity"], file, elemPath + ".output_buffer_capacity"));
        }

+        if (mt.contains("tooltip"))
+        {
+            def.tooltip = requireString(mt["tooltip"], file, elemPath + ".tooltip");
+        }
+
        const std::optional<BuildingType> parsedType = parseBuildingType(def.id);
        if (!parsedType)
        {
@@ -603,6 +614,11 @@ ModulesConfig ConfigLoader::loadModules(const std::string& path)
        def.fillColor             = requireString(mt["fill_color"], file, elemPath + ".fill_color");
        def.glyph                 = requireString(mt["glyph"], file, elemPath + ".glyph");

+        if (mt.contains("tooltip"))
+        {
+            def.tooltip = requireString(mt["tooltip"], file, elemPath + ".tooltip");
+        }
+
        // Materials
        {
            const toml::array& materials = requireArray(mt["materials"], file, elemPath + ".materials");
--- a/src/lib/config/ModulesConfig.h
+++ b/src/lib/config/ModulesConfig.h
@@ -54,6 +54,10 @@ struct ModuleDef
    std::optional<ModuleWeaponCapability>  weaponCapability;
    std::optional<ModuleSalvageCapability> salvageCapability;
    std::optional<ModuleRepairCapability>  repairCapability;
+
+    // Optional hover-tooltip text for the module selection button
+    // (REQ-MOD-UI-MODULE-TOOLTIP).
+    std::optional<std::string> tooltip;
 };

 struct ModulesConfig
--- a/src/lib/config/WorldConfig.h
+++ b/src/lib/config/WorldConfig.h
@@ -1,5 +1,8 @@
 #pragma once

+#include <optional>
+#include <string>
+
 #include "Formula.h"

 // Region widths are in tiles (REQ-GW-REGIONS).
@@ -75,6 +78,10 @@ struct WorldConfig
    double orbitFactor;                 // REQ-SHP-ORBIT (multiplies tool range for orbit radius)
    double rallyOrbitRadius_tiles;      // REQ-SHP-ORBIT (fixed orbit radius around the rally point)

+    // Optional hover-tooltip for the header building blocks stock display
+    // (REQ-UI-BLOCKS-TOOLTIP). Presentation-only; the simulation ignores it.
+    std::optional<std::string> buildingBlocksTooltip;
+
    WorldRegions regions;
    WorldExpansion expansion;
    WorldPush push;
--- a/src/lib/sim/BuildingSystem.cpp
+++ b/src/lib/sim/BuildingSystem.cpp
@@ -1,5 +1,6 @@
 #include "BuildingSystem.h"

+#include <algorithm>
 #include <cassert>
 #include <limits>
 #include <random>
@@ -9,6 +10,18 @@
 #include "SurfaceMask.h"
 #include "tracing.h"

+namespace
+{
+// Smelter and Reprocessing Plant have no player-selected recipe
+// (REQ-BLD-SMELTER, REQ-BLD-REPROCESSING). They auto-process whatever inputs
+// they receive, matching against every recipe of their building type.
+bool isAutoRecipeBuildingType(BuildingType type)
+{
+    return type == BuildingType::Smelter
+        || type == BuildingType::ReprocessingPlant;
+}
+}  // namespace
+
 BuildingSystem::BuildingSystem(const GameConfig& config,
                               BeltSystem& belts,
                               std::function<BuildingId()> allocateBuildingId,
@@ -118,6 +131,56 @@ void BuildingSystem::initBuffers(Building& b, const RecipeDef& recipe) const
    }
 }

+void BuildingSystem::initAutoBuffers(Building& b) const
+{
+    b.inputBuffer.counts.clear();
+    b.inputBuffer.caps.clear();
+
+    // Union the inputs of every recipe of this building type; the cap for each
+    // item is twice the largest per-cycle requirement across those recipes.
+    // Output capacity follows the same rules as initBuffers: the Reprocessing
+    // Plant holds one cycle's max output (REQ-MAT-OUTPUT-BUFFER-REPROCESSING),
+    // other auto buildings hold twice the largest per-cycle output.
+    int outputCapacity = 0;
+    for (const RecipeDef& recipe : m_config.recipes.recipes)
+    {
+        if (recipe.building != b.type)
+        {
+            continue;
+        }
+
+        for (const RecipeIngredient& ing : recipe.inputs)
+        {
+            const ItemType type{ing.item};
+            b.inputBuffer.counts[type] = 0;
+            b.inputBuffer.caps[type] =
+                std::max(b.inputBuffer.caps[type], 2 * ing.amount);
+        }
+
+        if (b.type == BuildingType::ReprocessingPlant)
+        {
+            int maxAmount = 0;
+            for (const RecipeOutput& out : recipe.outputs)
+            {
+                maxAmount = std::max(maxAmount, out.amount);
+            }
+            outputCapacity = std::max(outputCapacity, maxAmount);
+        }
+        else
+        {
+            int totalAmount = 0;
+            for (const RecipeOutput& out : recipe.outputs)
+            {
+                totalAmount += out.amount;
+            }
+            outputCapacity = std::max(outputCapacity, 2 * totalAmount);
+        }
+    }
+
+    b.outputBuffer.items.clear();
+    b.outputBuffer.capacity = outputCapacity;
+}
+
 void BuildingSystem::initShipyardBuffers(Building& b) const
 {
    b.inputBuffer.counts.clear();
@@ -419,6 +482,12 @@ void BuildingSystem::setRecipe(BuildingId id, const std::string& recipeId)
    {
        if (site.id == id)
        {
+            // Auto-recipe buildings have no player-selected recipe
+            // (REQ-BLD-SMELTER, REQ-BLD-REPROCESSING); ignore any attempt to set one.
+            if (isAutoRecipeBuildingType(site.type))
+            {
+                return;
+            }
            // No-op if the recipe is unchanged, so a redundant selection does
            // not wipe an already-configured ship layout.
            if (site.recipeId == recipeId)
@@ -436,6 +505,12 @@ void BuildingSystem::setRecipe(BuildingId id, const std::string& recipeId)
    {
        if (building.id == id)
        {
+            // Auto-recipe buildings have no player-selected recipe
+            // (REQ-BLD-SMELTER, REQ-BLD-REPROCESSING); ignore any attempt to set one.
+            if (isAutoRecipeBuildingType(building.type))
+            {
+                return;
+            }
            // No-op if the recipe is unchanged, so a redundant selection does
            // not wipe an already-configured ship layout or reset buffers.
            if (building.recipeId == recipeId)
@@ -603,6 +678,12 @@ void BuildingSystem::tickConstruction(Tick currentTick)
    {
        initSalvageBayBuffer(building);
    }
+    else if (isAutoRecipeBuildingType(building.type))
+    {
+        // Smelter/Reprocessing Plant need no recipe selection; buffers are set
+        // up from all recipes of the type (REQ-BLD-SMELTER, REQ-BLD-REPROCESSING).
+        initAutoBuffers(building);
+    }
    else if (!building.recipeId.empty())
    {
        if (building.type == BuildingType::Shipyard)
@@ -684,18 +765,24 @@ void BuildingSystem::tickBeltPull()
            continue;
        }

-        if (building.recipeId.empty())
+        // Auto-recipe buildings (Smelter, Reprocessing Plant) accept any item
+        // that is an input to one of their recipes; their caps already span the
+        // union of those inputs (initAutoBuffers), so no recipe lookup is needed.
+        if (!isAutoRecipeBuildingType(building.type))
        {
-            continue;
-        }
-
-        if (building.type != BuildingType::Shipyard)
-        {
-            const RecipeDef* recipe = findRecipe(building.recipeId, building.type);
-            if (!recipe || recipe->inputs.empty())
+            if (building.recipeId.empty())
            {
                continue;
            }
+
+            if (building.type != BuildingType::Shipyard)
+            {
+                const RecipeDef* recipe = findRecipe(building.recipeId, building.type);
+                if (!recipe || recipe->inputs.empty())
+                {
+                    continue;
+                }
+            }
        }

        for (const Port& port : building.inputPorts)
@@ -752,18 +839,15 @@ void BuildingSystem::tickProduction(Tick currentTick)
            continue;
        }

-        if (building.recipeId.empty())
+        const bool autoRecipe = isAutoRecipeBuildingType(building.type);
+        if (!autoRecipe && building.recipeId.empty())
        {
            continue;
        }

-        const RecipeDef* recipe = findRecipe(building.recipeId, building.type);
-        if (!recipe)
-        {
-            continue;
-        }
-
-        // If a production cycle is active, check for completion.
+        // If a production cycle is active, check for completion. Completion only
+        // needs the already-decided outputs, so it does not depend on which
+        // recipe is selected or auto-chosen.
        if (building.production)
        {
            if (currentTick >= building.production->completesAt)
@@ -779,66 +863,93 @@ void BuildingSystem::tickProduction(Tick currentTick)
            continue;
        }

-        // Idle: check if a new cycle can start.
-
-        // 1. All required inputs present?
-        bool inputsOk = true;
-        for (const RecipeIngredient& ing : recipe->inputs)
+        // Idle: gather the candidate recipes to try. Auto-recipe buildings
+        // (Smelter, Reprocessing Plant) have no selected recipe and try every
+        // recipe of their type in config order, running the first whose inputs
+        // are satisfied (REQ-BLD-SMELTER, REQ-BLD-REPROCESSING). Other buildings
+        // try only their selected recipe.
+        std::vector<const RecipeDef*> candidates;
+        if (autoRecipe)
        {
-            const ItemType type{ing.item};
-            const std::map<ItemType, int>::const_iterator it =
-                building.inputBuffer.counts.find(type);
-            const int have = (it != building.inputBuffer.counts.end()) ? it->second : 0;
-            if (have < ing.amount)
+            for (const RecipeDef& r : m_config.recipes.recipes)
            {
-                inputsOk = false;
-                break;
-            }
-        }
-        if (!inputsOk)
-        {
-            continue;
-        }
-
-        // 2. Determine chosen outputs (roll for reprocessing).
-        std::vector<Item> chosen;
-        if (building.type == BuildingType::ReprocessingPlant)
-        {
-            chosen = rollReprocessingOutput(*recipe);
-            if (chosen.empty()) { continue; }
-        }
-        else
-        {
-            for (const RecipeOutput& out : recipe->outputs)
-            {
-                Item item;
-                item.type.id = out.item;
-                for (int i = 0; i < out.amount; ++i)
+                if (r.building == building.type && !r.inputs.empty())
                {
-                    chosen.push_back(item);
+                    candidates.push_back(&r);
                }
            }
        }
-
-        // 3. Output buffer has space for chosen outputs?
-        const int newSize = static_cast<int>(building.outputBuffer.items.size())
-                          + static_cast<int>(chosen.size());
-        if (newSize > building.outputBuffer.capacity)
+        else
        {
-            continue;
+            const RecipeDef* recipe = findRecipe(building.recipeId, building.type);
+            if (recipe)
+            {
+                candidates.push_back(recipe);
+            }
        }

-        // 4. Consume inputs and start cycle.
-        for (const RecipeIngredient& ing : recipe->inputs)
+        for (const RecipeDef* recipe : candidates)
        {
-            building.inputBuffer.counts[ItemType{ing.item}] -= ing.amount;
-        }
+            // 1. All required inputs present?
+            bool inputsOk = true;
+            for (const RecipeIngredient& ing : recipe->inputs)
+            {
+                const ItemType type{ing.item};
+                const std::map<ItemType, int>::const_iterator it =
+                    building.inputBuffer.counts.find(type);
+                const int have = (it != building.inputBuffer.counts.end()) ? it->second : 0;
+                if (have < ing.amount)
+                {
+                    inputsOk = false;
+                    break;
+                }
+            }
+            if (!inputsOk)
+            {
+                continue;
+            }

-        Production prod;
-        prod.recipeId     = building.recipeId;
-        prod.completesAt  = currentTick + secondsToTicks(recipe->durationSeconds);
-        prod.chosenOutputs = std::move(chosen);
-        building.production = std::move(prod);
+            // 2. Determine chosen outputs (roll for reprocessing).
+            std::vector<Item> chosen;
+            if (building.type == BuildingType::ReprocessingPlant)
+            {
+                chosen = rollReprocessingOutput(*recipe);
+                if (chosen.empty()) { continue; }
+            }
+            else
+            {
+                for (const RecipeOutput& out : recipe->outputs)
+                {
+                    Item item;
+                    item.type.id = out.item;
+                    for (int i = 0; i < out.amount; ++i)
+                    {
+                        chosen.push_back(item);
+                    }
+                }
+            }
+
+            // 3. Output buffer has space for chosen outputs?
+            const int newSize = static_cast<int>(building.outputBuffer.items.size())
+                              + static_cast<int>(chosen.size());
+            if (newSize > building.outputBuffer.capacity)
+            {
+                continue;
+            }
+
+            // 4. Consume inputs and start cycle.
+            for (const RecipeIngredient& ing : recipe->inputs)
+            {
+                building.inputBuffer.counts[ItemType{ing.item}] -= ing.amount;
+            }
+
+            Production prod;
+            prod.recipeId      = recipe->id;
+            prod.completesAt   = currentTick + secondsToTicks(recipe->durationSeconds);
+            prod.chosenOutputs = std::move(chosen);
+            building.production = std::move(prod);
+            break;  // At most one cycle starts per tick.
+        }
    }
 }

--- a/src/lib/sim/BuildingSystem.h
+++ b/src/lib/sim/BuildingSystem.h
@@ -169,6 +169,10 @@ private:
    const ShipDef*      findShipDef(const std::string& id) const;
    const ModuleDef*    findModuleDef(const std::string& id) const;
    void                initBuffers(Building& b, const RecipeDef& recipe) const;
+    // Buffers for an auto-recipe building (Smelter, Reprocessing Plant): input
+    // caps span the union of every recipe of the building's type; no player
+    // recipe is selected (REQ-BLD-SMELTER, REQ-BLD-REPROCESSING).
+    void                initAutoBuffers(Building& b) const;
    void                initShipyardBuffers(Building& b) const;
    void                initSalvageBayBuffer(Building& b) const;
    std::vector<Port>   computeInputPorts(const Building& b) const;
--- a/src/test/BuildingTest.cpp
+++ b/src/test/BuildingTest.cpp
@@ -474,7 +474,8 @@ TEST_CASE("BuildingSystem: productionBuildingCount excludes construction sites",
    runTicks(bs, belts, static_cast<int>(secondsToTicks(15.0)), tick);
    REQUIRE(bs.productionBuildingCount() == 2);

-    // Neither has a recipe selected, so neither has an active cycle.
+    // Neither is producing yet: the miner has no recipe selected, and the
+    // smelter (auto-recipe, REQ-BLD-SMELTER) has no input feeding it.
    REQUIRE(bs.activeProductionBuildingCount() == 0);

    bs.setRecipe(minerId, "mine_iron_ore");
@@ -542,7 +543,8 @@ TEST_CASE("BuildingSystem: smelter input buffer fills from adjacent west-flowing
    // Smelter mask ["AA ","AA>"] → body (0,0),(1,0),(0,1),(1,1).
    // Output port (2,1) East.  Input port example: (2,0) West.
    const BuildingId sid = bs.place(BuildingType::Smelter, QPoint(0, 0), Rotation::East, 0);
-    bs.setRecipe(sid, "iron_ingot");
+    // Smelters have no recipe selection (REQ-BLD-SMELTER); they auto-accept any
+    // ore/scrap that is an input to a smelter recipe.

    // Complete construction (15s → tick 450+1 = 451 ticks).
    Tick tick = 0;
@@ -563,6 +565,105 @@ TEST_CASE("BuildingSystem: smelter input buffer fills from adjacent west-flowing
    REQUIRE(it->second >= 1);
 }

+// A smelter auto-selects the matching recipe for whatever it is fed, with no
+// player recipe selection (REQ-BLD-SMELTER).
+TEST_CASE("BuildingSystem: smelter auto-smelts ore without a recipe selection",
+          "[building]")
+{
+    const GameConfig cfg = loadConfig();
+    BeltSystem belts(static_cast<double>(kTickRateHz));
+    int stock = 0;
+    std::mt19937 rng(0);
+    BuildingId nextBuildingId = 1;
+    BuildingSystem bs(cfg, belts,
+                      [&nextBuildingId]() { return nextBuildingId++; },
+                      [&stock](int n) { stock += n; },
+                      [](const std::string&, QVector2D, const std::optional<ShipLayoutConfig>&) {},
+                      [](const std::string&) -> bool { return true; },
+                      rng);
+
+    const BuildingId sid = bs.place(BuildingType::Smelter, QPoint(0, 0), Rotation::East, 0);
+
+    Tick tick = 0;
+    runTicks(bs, belts, static_cast<int>(secondsToTicks(15.0)) + 1, tick);
+
+    // Feed 2 iron_ore (the test-config iron_ingot recipe needs 2) via a
+    // west-flowing belt at input port (2,0).
+    belts.placeBelt(QPoint(2, 0), Rotation::West);
+    for (int i = 0; i < 2; ++i)
+    {
+        belts.tryPutItem(QPoint(2, 0), makeItem("iron_ore"));
+        belts.tick();
+        bs.tickBeltPull();
+    }
+
+    // iron_ingot recipe cycle is 2s; run to completion.
+    runTicks(bs, belts, static_cast<int>(secondsToTicks(2.0)) + 2, tick);
+
+    const Building* b = bs.findBuilding(sid);
+    REQUIRE(b != nullptr);
+    bool hasIronIngot = false;
+    for (const Item& item : b->outputBuffer.items)
+    {
+        if (item.type.id == "iron_ingot") { hasIronIngot = true; }
+    }
+    REQUIRE(hasIronIngot);
+}
+
+// With mixed inputs, the smelter runs whichever recipe is currently satisfiable
+// and leaves an incomplete batch of another input waiting (see the union-of-
+// inputs caps in initAutoBuffers).
+TEST_CASE("BuildingSystem: smelter runs a satisfiable recipe while an incomplete batch waits",
+          "[building]")
+{
+    const GameConfig cfg = loadConfig();
+    BeltSystem belts(static_cast<double>(kTickRateHz));
+    int stock = 0;
+    std::mt19937 rng(0);
+    BuildingId nextBuildingId = 1;
+    BuildingSystem bs(cfg, belts,
+                      [&nextBuildingId]() { return nextBuildingId++; },
+                      [&stock](int n) { stock += n; },
+                      [](const std::string&, QVector2D, const std::optional<ShipLayoutConfig>&) {},
+                      [](const std::string&) -> bool { return true; },
+                      rng);
+
+    const BuildingId sid = bs.place(BuildingType::Smelter, QPoint(0, 0), Rotation::East, 0);
+
+    Tick tick = 0;
+    runTicks(bs, belts, static_cast<int>(secondsToTicks(15.0)) + 1, tick);
+
+    // Feed 1 iron_ore (iron_ingot needs 2 — incomplete) then 2 copper_ore
+    // (copper_ingot needs 2 — satisfiable) via the west-flowing input belt.
+    belts.placeBelt(QPoint(2, 0), Rotation::West);
+    const char* fed[] = { "iron_ore", "copper_ore", "copper_ore" };
+    for (const char* id : fed)
+    {
+        belts.tryPutItem(QPoint(2, 0), makeItem(id));
+        belts.tick();
+        bs.tickBeltPull();
+    }
+
+    // copper_ingot cycle is 2.5s; run to completion.
+    runTicks(bs, belts, static_cast<int>(secondsToTicks(2.5)) + 2, tick);
+
+    const Building* b = bs.findBuilding(sid);
+    REQUIRE(b != nullptr);
+
+    // Copper was smelted; the lone iron_ore still waits for a second unit.
+    bool hasCopperIngot = false;
+    for (const Item& item : b->outputBuffer.items)
+    {
+        if (item.type.id == "copper_ingot") { hasCopperIngot = true; }
+    }
+    REQUIRE(hasCopperIngot);
+
+    const std::map<ItemType, int>::const_iterator ironIt =
+        b->inputBuffer.counts.find(ItemType{"iron_ore"});
+    REQUIRE(ironIt != b->inputBuffer.counts.end());
+    REQUIRE(ironIt->second == 1);
+}
+
 // ---------------------------------------------------------------------------
 // Belt push → belt tile
 // ---------------------------------------------------------------------------
@@ -664,7 +765,8 @@ TEST_CASE("BuildingSystem: reprocessing plant output buffer capacity equals max

    const BuildingId id = bs.place(BuildingType::ReprocessingPlant,
                                  QPoint(0, 0), Rotation::East, 0);
-    bs.setRecipe(id, "reprocessing_cycle");
+    // Reprocessing plants have no recipe selection (REQ-BLD-REPROCESSING); the
+    // single reprocessing recipe is applied automatically on completion.

    // Complete construction (25s).
    Tick tick = 0;
@@ -695,7 +797,8 @@ TEST_CASE("BuildingSystem: reprocessing plant produces one cycle output then sta

    const BuildingId id = bs.place(BuildingType::ReprocessingPlant,
                                  QPoint(0, 0), Rotation::East, 0);
-    bs.setRecipe(id, "reprocessing_cycle");
+    // Reprocessing plants have no recipe selection (REQ-BLD-REPROCESSING); the
+    // single reprocessing recipe is applied automatically on completion.

    // Complete construction (25s).
    Tick tick = 0;
--- a/src/test/ConfigLoaderTest.cpp
+++ b/src/test/ConfigLoaderTest.cpp
@@ -83,6 +83,11 @@ TEST_CASE("ConfigLoader loads the committed bin/config/ configs end-to-end", "[c
    REQUIRE(cfg.world.rallyOrbitRadius_tiles == Approx(5.0));
    REQUIRE(cfg.world.scrapPerThreat == Approx(1.0));

+    // Optional header building blocks tooltip (REQ-UI-BLOCKS-TOOLTIP).
+    REQUIRE(cfg.world.buildingBlocksTooltip.has_value());
+    REQUIRE(*cfg.world.buildingBlocksTooltip ==
+            "Spend building blocks to build; deliver them to the HQ to gain more.");
+
    // Spot-check that a config-derived formula computes as expected.
    // threat_rate_formula = "x": evaluates to the input value.
    REQUIRE(cfg.world.waves.threatRateFormula.evaluate(1.0) == Approx(1.0));
@@ -113,6 +118,12 @@ TEST_CASE("ConfigLoader loads the committed bin/config/ configs end-to-end", "[c
    REQUIRE(salvageBayIt->outputBufferCapacity.has_value());
    REQUIRE(*salvageBayIt->outputBufferCapacity == 20);

+    // Optional per-building tooltip (REQ-UI-BUILD-TOOLTIP): the Salvage Bay
+    // defines one; the Miner leaves it unset.
+    REQUIRE(salvageBayIt->tooltip.has_value());
+    REQUIRE(*salvageBayIt->tooltip == "Drop-off point for salvage ships.");
+    REQUIRE_FALSE(minerIt->tooltip.has_value());
+
    // recipes.toml — reprocessing cycle has three weighted outputs.
    const auto reproIt = std::find_if(
        cfg.recipes.recipes.begin(), cfg.recipes.recipes.end(),
@@ -144,6 +155,21 @@ TEST_CASE("ConfigLoader loads the committed bin/config/ configs end-to-end", "[c
    REQUIRE(salvageShipIt != cfg.ships.ships.end());
    REQUIRE(salvageShipIt->defaultModules.empty());

+    // modules.toml — optional per-module tooltip (REQ-MOD-UI-MODULE-TOOLTIP):
+    // armor_plate defines one; salvager leaves it unset.
+    const auto armorPlateIt = std::find_if(
+        cfg.modules.modules.begin(), cfg.modules.modules.end(),
+        [](const ModuleDef& m) { return m.id == "armor_plate"; });
+    REQUIRE(armorPlateIt != cfg.modules.modules.end());
+    REQUIRE(armorPlateIt->tooltip.has_value());
+    REQUIRE(*armorPlateIt->tooltip == "Adds a large flat bonus to hit points.");
+
+    const auto salvagerModuleIt = std::find_if(
+        cfg.modules.modules.begin(), cfg.modules.modules.end(),
+        [](const ModuleDef& m) { return m.id == "salvager"; });
+    REQUIRE(salvagerModuleIt != cfg.modules.modules.end());
+    REQUIRE_FALSE(salvagerModuleIt->tooltip.has_value());
+
    // stations.toml
    REQUIRE(cfg.stations.playerStation.level == 5);
    REQUIRE(cfg.stations.playerStation.hpFormula.evaluate(5.0) == Approx(500.0));  // 300 + 40*5
--- a/src/ui/BlueprintPanel.cpp
+++ b/src/ui/BlueprintPanel.cpp
@@ -239,7 +239,7 @@ void BlueprintPanel::rebuildButtons()
    {
        const Blueprint& bp   = m_blueprints[static_cast<std::size_t>(i)];
        const int        cost = computeBlueprintCost(bp);
-        const QString label   = bp.name + "\n" + tr("%1 Blocks").arg(cost);
+        const QString label   = bp.name + "\n" + tr("%1 Building Blocks").arg(cost);

        QWidget*     row       = new QWidget(m_buttonsContainer);
        QHBoxLayout* rowLayout = new QHBoxLayout(row);
--- a/src/ui/BuildButtonGrid.cpp
+++ b/src/ui/BuildButtonGrid.cpp
@@ -38,10 +38,14 @@ BuildButtonGrid::BuildButtonGrid(const GameConfig* config, QWidget* parent)
        m_costs[def.type] = def.cost;

        const QString label = QString::fromStdString(toDisplayName(def.id))
-            + "\n" + tr("%1 Blocks").arg(def.cost);
+            + "\n" + tr("%1 Building Blocks").arg(def.cost);
        QPushButton* btn = new QPushButton(label, this);
        btn->setCheckable(true);
        btn->setFixedHeight(48);
+        if (def.tooltip)
+        {
+            btn->setToolTip(QString::fromStdString(*def.tooltip));
+        }
        layout->addWidget(btn, row, col);

        const int idx = static_cast<int>(m_buttons.size());
--- a/src/ui/HeaderBar.cpp
+++ b/src/ui/HeaderBar.cpp
@@ -17,7 +17,7 @@
 const double HeaderBar::kSpeeds[]   = { 0.0, 0.5, 1.0, 2.0, 10.0 };
 const int    HeaderBar::kSpeedCount = 5;

-HeaderBar::HeaderBar(QWidget* parent)
+HeaderBar::HeaderBar(const GameConfig* config, QWidget* parent)
    : QWidget(parent)
 {
    QHBoxLayout* layout = new QHBoxLayout(this);
@@ -25,7 +25,12 @@ HeaderBar::HeaderBar(QWidget* parent)
    layout->setSpacing(8);

    m_timeLabel      = new QLabel("00:00", this);
-    m_blocksLabel    = new QLabel(tr("Blocks: 0"), this);
+    m_blocksLabel    = new QLabel(tr("Building Blocks: 0"), this);
+    if (config->world.buildingBlocksTooltip)
+    {
+        m_blocksLabel->setToolTip(
+            QString::fromStdString(*config->world.buildingBlocksTooltip));
+    }
    m_artifactsLabel = new QLabel(tr("Artifacts: 0/?"), this);
    m_bossLabel      = new QLabel(tr("Boss Wave #1  Next boss: 5:00"), this);
    layout->addWidget(m_timeLabel);
@@ -81,7 +86,7 @@ void HeaderBar::handleEvent(std::shared_ptr<const TickAdvancedEvent> event)
 void HeaderBar::handleEvent(std::shared_ptr<const BuildingBlocksChangedEvent> event)
 {
    m_blocks = event->blocks;
-    m_blocksLabel->setText(tr("Blocks: %1").arg(event->blocks));
+    m_blocksLabel->setText(tr("Building Blocks: %1").arg(event->blocks));
    updateExpandButton();
 }

@@ -93,7 +98,7 @@ void HeaderBar::handleEvent(std::shared_ptr<const ExpansionCostChangedEvent> eve

 void HeaderBar::updateExpandButton()
 {
-    m_expandButton->setText(tr("Expand: %1 Blocks").arg(m_expansionCost));
+    m_expandButton->setText(tr("Expand: %1 Building Blocks").arg(m_expansionCost));
    m_expandButton->setEnabled(m_blocks >= m_expansionCost);
 }

--- a/src/ui/HeaderBar.h
+++ b/src/ui/HeaderBar.h
@@ -9,6 +9,7 @@
 #include "BuildingBlocksChangedEvent.h"
 #include "EventHandler.h"
 #include "ExpansionCostChangedEvent.h"
+#include "GameConfig.h"
 #include "GameSpeedChangedEvent.h"
 #include "Tick.h"
 #include "TickAdvancedEvent.h"
@@ -27,7 +28,7 @@ class HeaderBar : public QWidget,
    Q_OBJECT

 public:
-    explicit HeaderBar(QWidget* parent = nullptr);
+    explicit HeaderBar(const GameConfig* config, QWidget* parent = nullptr);
    ~HeaderBar() override;

 private slots:
--- a/src/ui/MainWindow.cpp
+++ b/src/ui/MainWindow.cpp
@@ -42,7 +42,7 @@ MainWindow::MainWindow(Simulation* sim, const std::string& configDir,
    setWindowTitle(tr("Dota Factory"));
    resize(1280, 768);

-    m_headerBar = new HeaderBar(this);
+    m_headerBar = new HeaderBar(&sim->config(), this);

    m_gameWorldView = new GameWorldView(sim, &sim->config(), &m_visuals, m_configDir,
                                        m_replay.get(), this);
--- a/src/ui/SelectedBuildingPanel.cpp
+++ b/src/ui/SelectedBuildingPanel.cpp
@@ -78,6 +78,25 @@ bool isProductionBuilding(BuildingType type)
        || type == BuildingType::Shipyard;
 }

+// Buildings that expose a player recipe/schematic selection control
+// (REQ-UI-SELECT-BUTTON): Miner ore type, Assembler recipe, Shipyard schematic.
+// The Smelter and Reprocessing Plant auto-process and offer no selection
+// (REQ-BLD-SMELTER, REQ-BLD-REPROCESSING).
+bool hasRecipeSelection(BuildingType type)
+{
+    return type == BuildingType::Miner
+        || type == BuildingType::Assembler
+        || type == BuildingType::Shipyard;
+}
+
+// Auto-recipe buildings have no selected recipe; their production is driven by
+// whatever inputs they receive.
+bool isAutoRecipeBuilding(BuildingType type)
+{
+    return type == BuildingType::Smelter
+        || type == BuildingType::ReprocessingPlant;
+}
+
 bool isBeltLike(BuildingType type)
 {
    return type == BuildingType::Belt || type == BuildingType::Splitter
@@ -265,7 +284,7 @@ void SelectedBuildingPanel::buildSingle(BuildingId id)
    m_titleLabel->show();
    m_buffersLabel->show();

-    if (isProductionBuilding(type))
+    if (hasRecipeSelection(type))
    {
        const std::vector<RecipeSelectionOption> options =
            buildRecipeSelectionOptions(type, *m_sim, *m_config);
@@ -383,6 +402,21 @@ void SelectedBuildingPanel::refreshBuffers(const Building* b)
                                ? findShipDef(b->recipeId)
                                : nullptr;

+    // Auto-recipe buildings (Smelter, Reprocessing Plant) have no selected
+    // recipe; while a cycle runs, resolve the recipe actually in production so
+    // the cycle time and progress can be shown (REQ-UI-PRODUCTION-PROGRESS).
+    if (!recipe && isAutoRecipeBuilding(b->type) && b->production.has_value())
+    {
+        for (const RecipeDef& r : m_config->recipes.recipes)
+        {
+            if (r.id == b->production->recipeId && r.building == b->type)
+            {
+                recipe = &r;
+                break;
+            }
+        }
+    }
+
    QString bufText;

    if (!b->inputBuffer.counts.empty())
@@ -469,41 +503,51 @@ void SelectedBuildingPanel::refreshBuffers(const Building* b)
        }
    }

-    if (isProductionBuilding(b->type) && (recipe || shipDef))
+    if (isProductionBuilding(b->type)
+        && (recipe || shipDef || isAutoRecipeBuilding(b->type)))
    {
-        double durationSeconds = recipe
-            ? recipe->durationSeconds
-            : shipDef->schematic.productionTimeSeconds;
-
-        if (shipDef && b->shipLayout.has_value())
+        if (recipe || shipDef)
        {
-            for (const PlacedModule& pm : b->shipLayout->placedModules)
+            double durationSeconds = recipe
+                ? recipe->durationSeconds
+                : shipDef->schematic.productionTimeSeconds;
+
+            if (shipDef && b->shipLayout.has_value())
            {
-                for (const ModuleDef& modDef : m_config->modules.modules)
+                for (const PlacedModule& pm : b->shipLayout->placedModules)
                {
-                    if (modDef.id == pm.moduleId)
+                    for (const ModuleDef& modDef : m_config->modules.modules)
                    {
-                        durationSeconds += modDef.productionTimeSeconds;
-                        break;
+                        if (modDef.id == pm.moduleId)
+                        {
+                            durationSeconds += modDef.productionTimeSeconds;
+                            break;
+                        }
                    }
                }
            }
-        }

-        bufText += tr("Cycle: %1 s\n").arg(durationSeconds, 0, 'f', 1);
+            bufText += tr("Cycle: %1 s\n").arg(durationSeconds, 0, 'f', 1);

-        if (b->production.has_value())
-        {
-            const Tick cycleTicks  = secondsToTicks(durationSeconds);
-            const Tick completesAt = b->production->completesAt;
-            const Tick currentTick = m_sim->currentTick();
-            const Tick elapsed     = currentTick - (completesAt - cycleTicks);
-            const int  pct         = static_cast<int>(
-                std::max(Tick(0), std::min(cycleTicks, elapsed)) * 100 / cycleTicks);
-            bufText += tr("Progress: %1%\n").arg(pct);
+            if (b->production.has_value())
+            {
+                const Tick cycleTicks  = secondsToTicks(durationSeconds);
+                const Tick completesAt = b->production->completesAt;
+                const Tick currentTick = m_sim->currentTick();
+                const Tick elapsed     = currentTick - (completesAt - cycleTicks);
+                const int  pct         = static_cast<int>(
+                    std::max(Tick(0), std::min(cycleTicks, elapsed)) * 100 / cycleTicks);
+                bufText += tr("Progress: %1%\n").arg(pct);
+            }
+            else
+            {
+                bufText += tr("Progress: idle\n");
+            }
        }
        else
        {
+            // Auto-recipe building with no active cycle: no single recipe to
+            // show a cycle time for.
            bufText += tr("Progress: idle\n");
        }
    }
--- a/src/ui/ShipLayoutDialog.cpp
+++ b/src/ui/ShipLayoutDialog.cpp
@@ -461,6 +461,10 @@ ShipLayoutDialog::ShipLayoutDialog(const GameConfig* config,
        QPushButton* btn = new QPushButton(label, this);
        btn->setCheckable(true);
        btn->setFixedHeight(48);
+        if (def.tooltip)
+        {
+            btn->setToolTip(QString::fromStdString(*def.tooltip));
+        }
        buttonGrid->addWidget(btn, row, col);
        m_moduleButtons.push_back(btn);
Author	SHA1	Message	Date
mlangkabel	dd7c997816	Auto-process smelter and reprocessing plant (no recipe selection)	2026-07-12 21:35:23 +02:00
mlangkabel	ad3e73fdd8	Add tooltip for building blocks in header bar	2026-07-12 21:24:11 +02:00
mlangkabel	177809fe1a	Add tooltips for building buttons and module selection buttons	2026-07-12 21:21:14 +02:00
mlangkabel	69f655d179	Rename UI "Blocks" labels to "Building Blocks"	2026-07-12 21:17:10 +02:00