Factory Lens
v1.0.0
by pique
Trace a stopped production chain to its first cause, diagnose exact logistics failures, and see buffer shortages before they stop the factory.
- Source code
- No source provided
- Tags
- Quality of Life
Controls
- F8: open or close Factory Lens.
- Left Alt: show or hide the selected map overlay.

See why your factory stopped — without opening every building
Factory Lens is a compact, movable diagnostics HUD for Captain of Industry. It scans production buildings and shows what needs your action, what is working, and what is only waiting normally.
Instead of opening machines one by one, press F8 for the problem list or press Left Alt to toggle the reasons directly above buildings.

Read the factory at a glance
- Orange — action needed: unload a finished product or deliver a missing input.
- Red — critical fault: power, workers, computing, maintenance, or placement needs attention.
- Blue/gray — normal waiting: the building is waiting by design and can usually be ignored.
- Green — working: production is currently healthy.
Features
- Compact problem list with building, cause, affected product, and state duration.
- One-click camera jump that opens the normal building inspector.
- Optional map overlay with product icons, short labels, or both.
- A small history graph and cause counters for spotting persistent bottlenecks.
- Root-cause hints for blocked transport, insufficient upstream capacity, missing supply, and upstream faults.
- Grace periods and buffer-aware checks to avoid warning about normal recipe cycles, exhaust stacks, and brief delivery gaps.
- Movable and pinnable window with adjustable width and opacity.
- Window position and display preferences persist between sessions.
- English and Russian localization.
Controls
- F8: open or close Factory Lens.
- Left Alt: show or hide the selected map overlay.
Both shortcuts and diagnostic thresholds can be changed in the mod settings.
No announcements yet.
Loading forum…
Factory Lens 1.0.0 — Cause Trace & Logistics Lens
Changes since version 0.8.0: - Added Cause Trace. Select a problem to reveal the first diagnosed cause and the product path between affected buildings directly on the map. - Added detailed logistics diagnostics: - no free trucks; - no delivery job created; - unreachable route; - product reserved by another vehicle; - destination buffer full; - import or export disabled; - disconnected or stalled belt or pipe. - Added early warnings before production stops: - estimated time until an output fills; - remaining production cycles before an input runs out; - number of repeated occurrences during the last 10 minutes. - Selecting a problem now hides unrelated map markers and displays only the affected building, diagnosed cause, and production path. - Fixed smoke stacks and similar flow consumers being incorrectly described as having a stalled pipe while normally waiting for material. - Improved save and load safety: - Factory Lens is now explicitly registered as a UI-only mod; - diagnostics start only after the world has completely finished loading; - analysis is suspended while the game captures a save snapshot; - destroyed, invalid, and phantom prototypes from unavailable mods are ignored. - Expanded English and Russian localization. - Added more detailed diagnostic logging to help investigate conflicts with other mods. Factory Lens still adds no buildings, products, recipes, or simulation data and does not change production balance or the save format.
This mod depends on
This mod has no dependencies.
Mods that depend on this
No other mods depend on this mod yet.