🧰 Kayser's Blueprint Designer's Toolkit

Kayser's Blueprint Designer's Toolkit (BDT) is a quality-of-life mod for Captain of Industry blueprint creators.

It is built around one rule: designer-only, consumer-free. Players who download and use your blueprints do not need this mod installed. BDT helps with creating, documenting, updating, inspecting, and cleaning up blueprints, but the output remains normal vanilla-compatible blueprint data.

✨ Feature List

• 🔁 Update blueprint
• 📂 Remembered blueprint folder
• ↩️ Undo place blueprint
• ♻️ Blueprint recycle bin
• 📊 Blueprint operational stats
• 📝 Copy as Markdown
• 🧩 Symmetric entity normalization
• ⚡ Instant build mode
• 🧹 Transport cleanup tool
• 👁️ Height filter
• 📦 Layout box mode
• 📤 Batch placing
• 🏭 Pollution overlay
• ☢ Radiation overlay
• 🚦 Throughput tools
• 🚧 Legacy Belt Configurations
• ⚙️ Mod settings

🔁 Update blueprint

Select a blueprint in your blueprint book and click Update to replace its contents with a fresh area selection.

BDT keeps the blueprint's existing:

• name
• description
• overlap settings
• position in the current folder

This is meant for the usual blueprint-authoring loop: find a small mistake, fix it in-world, update the existing blueprint, and keep the book organized.

📂 Remembered blueprint folder

BDT remembers the last blueprint book folder you opened and restores it the next time the blueprint window is created. The folder path is stored in the vanilla save file. This allows you to store different currently open blueprint book page in different save games.

↩️ Undo place blueprint

BDT adds an in-memory undo stack for blueprint placement, copy-paste, and force-placement actions. The default hotkey is Ctrl+Z. Undo can cancel placed ghosts, deconstruct or sandbox-destroy newly placed structures, restore overwritten pre-existing ghosts or entities, and revert pasted surface designations or decals. Undo history is transient and is not saved into save files.

♻️ Blueprint recycle bin

BDT can copy deleted or updated blueprints/folders into a configurable root-level recycle bin folder before the original action completes. The copy preserves the original parent folder path under the recycle bin and adds numeric suffixes to avoid name collisions. Deletions inside the recycle bin remain permanent and use the normal confirmation popup.

📊 Blueprint operational stats

The blueprint detail panel now also shows Operational cost.

When a selected blueprint contains relevant entities, BDT adds a compact operational summary row showing:

• workers
• electricity
• computing
• maintenance by tier

Only non-zero stats are shown, so small blueprints stay clean and large builds get the extra planning information where it belongs. Operational costs assume 100% utilization on all entities.

📝 Copy as Markdown

BDT adds a Copy as Markdown button to both the blueprint detail panel and the blueprint folder detail panel.

The language used for table headers and product/entity names is controlled by the Markdown table language setting in Mod Settings (see below). The default is English.

Single blueprint - clicking the button copies a Markdown-formatted summary to the clipboard:

• Blueprint heading and description
• Components table - all major entity types and their counts, sorted A-Z
• Construction table - all required products and quantities, sorted A-Z
• Operational table - entities, workers, electricity, computing, and maintenance products per month

Blueprint folder - clicking the button copies a wide Markdown table listing every blueprint in the folder, including blueprints in sub-folders. Each blueprint is a row. Columns include Blueprint name, Folder (relative path within the exported root), Entities, and any workers / electricity / computing / maintenance / construction product columns present across the folder, sorted A-Z. Rows are sorted by folder path, then by blueprint name within each folder.

Example output (folder):

## Kayser's Compact Concrete

Kayser's Compact Concrete
The Compactest Concrete

https://hub.coigame.com/Blueprint/Detail/590

| Blueprint | Folder | Entities | Workers | Electricity | Maintenance I / mo | Concrete slab | Construction Parts | Construction Parts II |
|---|---|---|---|---|---|---|---|---|
| Big Concrete (example) | . | 258 | 282 | 13.0 MW | 312 | 200 | 96 | 882 |
| Concrete Slab Stages (chart) | . | 579 | 504 | 17.4 MW | 549 | 280 | 1,3k | 2,1k |
| 1: Double T1 Mixer (24x) | Concrete Slabs | 33 | 16 | 550 kW | 20 | - | 198 | 136 |

Rendered in markdown as:

Kayser's Compact Concrete

Kayser's Compact Concrete The Compactest Concrete

https://hub.coigame.com/Blueprint/Detail/590

The output is ready to paste directly into a Hub post or wiki page.

🧩 Symmetric entity normalization

Mitigation/Fix for: https://discord.com/channels/803508556325584926/1405800905646805093/1405800905646805093

BDT normalizes rotationally-symmetric entities in captured blueprints, such as balancers/zippers and mini-zippers/connectors.

Captain of Industry can treat a functionally identical connector at e.g. rotation 0° and rotation 90° as different, which can block paste-over updates. BDT fixes that at blueprint capture time by resetting symmetric entities' rotation and flip-state to a canonical orientation.

The normalization pass focuses on the known paste-over problem cases:

• resets supported symmetric entities to a consistent stored orientation
• keeps their blueprint position unchanged
• preserves balancer priority settings
• skips entities that do not match the supported symmetric layouts

The result is still normal blueprint data with all (normalized) entities at rotation 0° and non-flipped. This does not patch blueprint placement and does not require blueprint users to install BDT.

This is a passive feature that allows you to freely place connectors, balancers, and lifts in multi-tier blueprints without worrying about their orientation.

⚡ Instant build mode

BDT includes an Instant Build mode (configurable in Mod Settings) that automatically and instantly completes construction, deconstruction, upgrades, and downgrades without consuming materials, workers, or unity. The benefit over the vanilla insta-build toggle is that you don't need to unpause the game and risk having products end up in the wrong places when your build is being modified.

Enabling this feature turns off the game's built-in insta-build toggle.

Migrated from Moriarty's Utilities++, with permission. (Thanks @Mori!)

🧹 Transport cleanup tool

BDT adds a transport cleanup tool with a default hotkey of Alt+Del. This tool allows you to detect and demolish useless belts and pipes via an area selection drag, before capturing your blueprint. To avoid capturing input and output transports, terminate them properly with a source or sink.

The hotkey can be changed in BDT's mod settings under TRANSPORT CLEANUP.

Migrated from Moriarty's Utilities++, with permission. (Thanks @Mori!)

👁️ Height filter

BDT features a Height Filter rendering system that allows players to filter the visibility of transports, transport pillars, and layout entities (such as sorters, zippers, mini-zippers, and lifts) in the world.

Adjusting the visible height levels makes it significantly easier to inspect and manage multi-tier pipe stacks, layered belt paths, or dense underground logistics without visual clutter. Transports that span multiple levels are hidden/shown based on the majority of their nodes.

• PageUp: increases the maximum visible level (up to level 6, which shows all heights).
• PageDown: decreases the maximum visible level (down to level 0, which shows underground entities only).

These hotkeys can be customized in BDT's mod settings under HEIGHT FILTER. Hidden entities are protected from selection to prevent accidental demolition or interaction.

Freely adopted from Moriarty's Utilities++ mod, with permission. (Thanks @Mori!)

📦 Layout box mode

Layout Box Mode renders 3D building footprint and clearance boxes so designers can see where elevated pipes, belts, and other transports can pass over existing structures. The default toggle hotkey is Alt+B.

📤 Batch placing

BDT introduces a Place all button inside the blueprint folder detail panel. Clicking this spawns ghosts of all direct child blueprints side-by-side in a single cursor placement.

• Blueprints are organized in a grid layout.
• If the total width of a row exceeds 512 tiles, BDT automatically wraps placements to a new row.
• If the total height exceeds 512 tiles, BDT automatically crops remaining blueprints to stay safely within the game's placement limits.
• Supports configurable spacing (from 0 to 12 tiles) between blueprint instances, adjustable in Mod Settings.

🏭 Pollution overlay

BDT features a real-time Pollution Overlay and Heat Map system to monitor and visualize island exhaust rates.

• Pollution Labels: Displays daily-averaged emission rates (items/min) as floating world-space labels above factories, waste outfalls, vehicles, locomotives, and ships.
• Heat Map Glow: Renders screen-space and 3D white glow outlines indicating relative emission rates. Low emitters receive tiny, whisper-thin backing glows, while major polluters project wide, prominent white halos.
• Common Comparison Pool: Emissions are scaled linearly against a shared global pool of all currently active layers, allowing players to compare different pollution types (like wastewater outfalls against diesel exhausts). Hiding specific layers in settings dynamically re-calculates the comparison pool.
• Dynamic Camera-Zoom Scaling: Opacity and glow radius scale up dynamically as the camera zooms out, ensuring indicators remain bold and readable from high altitudes.
• Filters & Configurable Averaging: Customize average calculations (default 360 days) and toggle Air, Ground/Water, Vehicle, or Ship overlays independently.

☢ Radiation overlay

BDT also includes a Radiation Overlay for locating unsafe radioactive inventory during design testing. It samples at the same daily boundary as vanilla radiation accounting and displays local amounts using translationless #N.D# labels.

• Local source coverage: Inspects supported machines, storage buffers, connectors, lifts, flat conveyors, and trucks. Reactor and radioactive-waste-storage buffers are excluded as vanilla-safe storage.
• Green entity glow: Optionally highlights the source entity or vehicle itself, with intensity scaled against the strongest currently visible source and a fixed zero baseline.
• Configurable averaging: Uses a sliding window of 0 to 360 game days, defaulting to 30 days. Setting it to 0 disables data collection.
• Hotkey: Toggle the overlay with Alt+R.

🚦 Throughput tools

BDT adds a unified Throughput inspector panel for transport entities: belts, pipes, channels, sources, sinks, lifts, balancers, sorters, and connectors. It combines live monitoring with the existing sandbox-only limiter controls, so you can see what a design is actually moving and, in sandbox mode, test how it behaves under custom capacity limits, or measure its output precisely.

The throughput monitor can display averaged flow rates in the world as either:

• absolute throughput in items/min
• percent of the entity's maximum capacity

You can choose how many days each entity should average over, making it easier to smooth out short production bursts or inspect a design's recent behavior.

The in-world overlay can also turn the selected entities themselves into a glowing Throughput coloring (heat map). Instead of only tinting the numbers, BDT lights up the belts, pipes, ports, and layout entities underneath them, so busy lanes and starving lines are visible at a glance even in a dense blueprint test rig.

• Capacity mode colors the entity glow by the entity's maximum transport capacity.
• Relative mode colors the entity glow by how heavily the entity is being used.
• A colorblind-friendly blue/yellow/red palette is available in Mod Settings.
• Near-saturated entities get a stronger pulsing bottleneck glow, making cramped parts of a design easier to spot.

For larger designs, the new Throughput Area Tool lets you drag-select a region and configure throughput display settings in bulk. The default hotkey is Shift+Alt+T.

The area window groups selected entities by type, lets you toggle display visibility per group, and can apply a shared averaging period without closing the window. This is useful when you want to light up a full bus, production block, or testing rig without clicking every belt and pipe one by one.

Throughput limiting remains available in sandbox mode. Limits are saved per entity but are not preserved in blueprints.

This allows you to test your designs thoroughly before capturing the blueprint.

🚧 Legacy Belt Configurations

The Mod Settings menu now features an option to enable Update 1 style transport construction. Turning on "Allow curvy incline belts" permits transports to turn and incline/decline on the exact same tile, restoring the ability to build tight, curvy vertical belts.

Before, U1-style belts were only possible to integrate in modern designs through tedious copy-pasting from an older blueprint or save file.

⚙️ Mod settings

BDT adds a Mod Settings panel, accessible from the top-right M button in the mod menu or with the keyboard shortcut Alt+M.

Markdown table language controls which language is used for table headers and product/entity names when copying Markdown:

Markdown number format controls decimal and thousands separators in copied Markdown:

Settings are stored per save file. The markdown_table_language and markdown_number_format keys in config.json set the initial values for saves that have no stored settings yet.

The Throughput settings control the global overlay, overlay hotkey, heat-map mode, colorblind-friendly colors, percent display, and the Throughput Area Tool hotkey.

📌 Notes

• Compatible with vanilla saves.
• Can be added to or removed from existing saves.
• Requires Captain of Industry 0.8.2 or newer.
• Blueprint consumers do not need this mod installed.
• UI translations included for English, German, Spanish, Italian, Portuguese, Russian, Swedish, and Chinese.

📦 Installation

• Download the latest version of the mod from the Captain of Industry Hub.
• Extract the mod folder into your Captain of Industry mods directory (%AppData%\Captain of Industry\Mods).
• Enable the mod when loading or starting a new game.

📜 License

MIT. See LICENSE.

⚖️ Attribution and trademarks

Designer Toolkit is an unofficial, community-made mod for Captain of Industry.

Captain of Industry, MaFi Games, and related names, trademarks, game code, and assets are the property of MaFi Games. This mod is not affiliated with, endorsed by, or sponsored by MaFi Games.

This repository is intended to contain only original mod code and configuration, licensed under the MIT License. It does not intentionally include Captain of Industry game code, game assets, or other MaFi Games intellectual property.