Changelog

Version: 0.14.0
Date: 2026-11-10

  Added:
    - Per-colony physical supply-shortage circuit transmitter for seven consumables.
    - Expanded 240-slot Colony Depot and colony logistics research unlock.
    - Configurable per-commodity reserve multipliers in the colony dashboard.
    - Force-wide stored civilian, military and criminal population-pool shortage
      targets and signals for existing housing circuit automation.
    - Bounded consumable-cycle history, next-cycle demand previews and physical
      supply runway estimates for each colony.
    - Colony Logistics Monitor output modes: shortage, stock, surplus and
      next-cycle consumption, with consistent aggregate shortage/surplus signals.
    - Last-cycle inbound/outbound freight diagnostics showing delivered,
      undelivered and rolled-back quantities.

  Fixes:
    - Preserve player-adjusted physical reserve targets in the existing freight
      planner instead of adding a separate cargo executor.
    - Prevent orphaned records from known deleted internal testing surfaces
      from being assigned to legitimate colonies if surface indexes are reused.
    - Remove invalid Logistics Monitor references after surface deletion.

  Compatibility:
    - Existing legacy force-wide economy supply, demand and coin totals remain
      distinct from physical per-colony stock and freight targets.
    - Existing colonies, migration data, freight settings and reserve preferences
      are preserved; schema 9 migration is additive.
    - Requires Factorio 2.1.22+, Forgeworks Core 0.3.8+, Space Exploration
      0.7.62+, Krastorio 2 2.1.3+ and the existing mandatory dependency stack.

Version: 0.13.2
Date: 2026-11-10

  Added:
    - Wired all four legacy housing types (CHU 1/2 and Highrise 1/2) for native
      Factorio 2.1 circuit enable/disable and circuit-controlled recipe selection.
    - Added a craftable Colony Economy Monitor, unlocked with circuit technology.
    - Exposed force-wide colony supply, untaxed supply, demand, coins and population
      pool counts through item signals; added total supply, unmet demand and surplus
      virtual signals for easy depot/inserter automation.

  Compatibility:
    - Preserves 0.13.1 orbital expansion, economy and depot selling behaviour.
    - No migration required: old houses acquire native connectors automatically,
      new monitors are reconstructed on startup or configuration changes.
    - Factorio 2.1.22+ and Forgeworks Core 0.3.8+ remain required.

Version: 0.13.1
Date: 2026-11-05

  Bugfixes:
    - Fixed a startup crash in the Colonial Horizons specialty-material recipe
      integration when Factorio has no data.raw.tool prototype group.
    - Reused Forgeworks Core item discovery instead of indexing optional
      item-prototype tables directly. No recipe balance or unlocks were changed.

  Compatibility:
    - Same dependency versions as 0.13.0; no save migration required.

Version: 0.13.0
Date: 2026-11-03

  Added:
    - Orbital Resource Collector, Materials Refinery, Biosphere and high-capacity Transfer Hub.
    - Debris capture, separation, regolith/metal recovery, alloy fabrication and alternate frames.
    - Hydroponics, medical synthesis and orbital maintenance reclamation.
    - New Orbital Circular Industry research and five closed-loop recipes for construction,
      electronics, environmental, research and consumer supplies.
    - Orbital settlement projects and freight manifests with player-adjustable import targets.

  Changes:
    - Freight checks receiving inventory capacity before removing stock, rejects stale routes,
      respects disabled policies and records non-deliveries, rollback failures and capacity limits.
    - GUI now provides actual freight delivery outcomes, a refresh control and owned-event handling.
    - Preserve existing 0.12.2 Crucible, Foundry, Steel and Pumpjack progression fixes.
    - Legacy cargo targets remain intact; new orbital colony default import manifests are seeded lazily.
    - Newly founded orbital habitats start with 50 crew; existing populations are unchanged.
    - Save-state schema 8 and additive 0.13.0 migration; existing crew counts, projects, and player-set cargo targets are preserved.

  Compatibility:
    - Factorio >= 2.1.22; Space Exploration >= 0.7.62; Forgeworks Core >= 0.3.8.
    - Existing 0.12.2 mandatory dependency stack remains; 248k Redux Overhaul Mode is required.
    - Added an additive migration for existing 0.12.2 colony and freight data.

Version: 0.12.2
Date: 2026-10-25

  Added:
    - Added a CH-owned costly Starter Crucible recipe available from Foundry technology,
      using only stone, coal, copper plates and iron plates; it produces the existing
      BZ Carbon crucible and does not bypass later Foundry/steel mechanics.
    - Preserved BZ Carbon's original graphite/magnesia/silica/zirconia crucible
      recipe, now an alternative for later production.

  Bugfixes:
    - Repaired the BZ Carbon / BZ Foundry / Krastorio 2 / 248k Redux first-Foundry Crucible bootstrap loop, removing an early obstacle to Steel and Pumpjacks.
    - Moved the Crucible recipe unlock from Advanced Material Processing 2 to Foundry technology; retained the original materials and production time.
    - Restored normal crafting alongside Foundry production for the initial Crucible, so Foundries no longer need themselves to produce their own construction material.
    - Kept later foundry, steel, casting and alloy chains unchanged.

  Compatibility:
    - Fix is limited to the existing Colonial Horizons BZ Carbon integration; no third-party Mod Portal packages are edited or bundled.
    - Forgeworks Core >= 0.3.8 and existing 0.12.0 freight/save migrations remain unchanged.

Version: 0.12.1
Date: 2026-10-24

  Bugfixes:
    - Resolved the Bismuth/BZ Foundry/BZ Carbon pre-blue PCB-solder progression deadlock.
    - Restored regular solder as the K2/SE Logistic (green) science ingredient
      instead of PCB solder, retaining its previous required amount.
    - Restored assembler/hand crafting as an early option for PCB solder while
      preserving its founding category for later factory-scale production.
    - Removed only the Foundry prerequisite from PCB solder research; Bismuth's
      other prerequisites, recipe materials and science costs remain intact.
    - Chemical (blue) science and advanced electronics retain PCB solder.

  Compatibility:
    - Fix is owned by Colonial Horizons; no third-party Mod Portal files are
      modified or redistributed. Forgeworks Core requirement stays >= 0.3.8.
    - Existing colony/freight save state and schema 7 are unchanged.

Version: 0.12.0
Date: 2026-10-17

  Added:
    - Added per-supply reserve overrides to the Freight Dashboard, allowing individual colony supplies to run above or below the colony-wide reserve multiplier.
    - Added explicit freight-network connection state so disabled colonies and colonies without a Freight Terminal are visible at a glance.
    - Added the Freight Dashboard directly to the existing colony-status GUI: force-network summary, terminal throughput, reserve targets, shortage severity, inbound/outbound routes and unmet demand.
    - Added player freight-policy controls for network enable/disable, import priority, export priority and colony reserve multiplier. Policy changes take effect on the next scheduled freight cycle.
    - Added force-scoped freight summaries so multiplayer players only see their own force's network totals.
    - Freight routes now execute real item transfers between CH Freight Terminal inventories; general colony depots count toward reserves but are not teleported from.
    - Added transactional transfer handling: cargo rejected by a full destination is rolled back to the exact source inventories, with rollback failures exposed in freight diagnostics.
    - Freight planning now caps export availability to cargo actually staged in source Freight Terminals.
    - Supply counts refresh immediately after each freight execution pass.
    - Began the Inter-Colony Freight Network overhaul with a persistent per-colony freight policy and freight-state model.
    - Added import priority, export priority, reserve multipliers and per-item reserve overrides.
    - Freight demand now targets colony reserve levels rather than only the bare supply target.
    - Added shortage escalation levels: watch, low, severe and critical.
    - Freight planning now resolves higher-severity and higher-priority shortages first.
    - Freight terminals now provide finite planning throughput; parent/orbit routes cost less throughput than interplanetary routes.
    - Logistics colonies and completed freight-related projects receive stronger export-hub weighting/capacity.
    - Added deterministic colony-to-colony balancing with force isolation and explicit unmet-demand tracking.
    - Added persistent freight generation/summary state for the later 0.12 freight dashboard.

  Changed:
    - Freight rebuilds now include disconnected colonies with zero throughput so removing a Freight Terminal clears stale route/state data instead of leaving an old network snapshot visible.
    - Replaced the 0.11 surplus/deficit advisory planner with the 0.12 reserve-aware deterministic planning model.
    - This first 0.12 test build changes planning only; it does not yet physically transfer items between colony inventories.

  Migration:
    - Added a 0.12.0 migration for existing 0.11.x colonies and freight state.
    - Storage schema advanced from 6 to 7.

Version: 0.11.1
Date: 2026-10-17

  Bugfixes:
    - Fixed Factorio 2.1.22 startup failure when Krastorio 2 / 248k Redux leave legacy FluidBox minimum_temperature or maximum_temperature fields on generator prototypes.
    - Colonial Horizons now invokes Forgeworks Core's shared FluidBox-temperature migration after dependency final-fixes, preserving temperature constraints through the current machine-level input-temperature fields instead of deleting them blindly.

  Compatibility:
    - Raised Forgeworks Core requirement to 0.3.8+, which owns the reusable Factorio 2.1.22 FluidBox compatibility helper.
    - Raised the Factorio base floor to 2.1.22.
    - No Krastorio 2 or 248k Redux files are modified or redistributed.
    - No save migration is required.

Version: 0.11.0
Date: 2026-10-12

  Added:
    - Every surface specialisation now has a committed production identity unlocked by its completed specialist-development project rather than by additional technology clutter.
    - Mining: manganese/titanium specialist Mining Supplies route.
    - Industry: Molybdenum-reinforced Maintenance Kits route.
    - Logistics: zirconium/tinned-cable Consumer Supplies route.
    - Research: gallium/antimony/neodymium precision Research Supplies route.
    - Agriculture: mineral-fortified Colony Food route using colony produce.
    - Molybdenum 0.1.1+ is now the 17th required specialty-material provider.
    - Precision Industrial Works now consumes 25 Molybdenum Steel and 10 Molybdenum Superalloy.
    - Added Molybdenum-reinforced maintenance kits: 2 Molybdenum Steel + 1 Molybdenum Superalloy + 2 Magnesium + 1 Cadmium-Plated Hardware -> 12 Maintenance Kits.
    - Added a targeted Molybdenum provider contract check for the exact 0.1.1 Molybdenum/Rhenium/catalyst/superalloy prototypes and structural-alloy recipes.

  Compatibility:
    - Uses the exact prototype IDs reported by Molybdenum 0.1.1.
    - Colonial Horizons validates but does not modify or redistribute Molybdenum provider recipes.
    - Forgeworks Core remains 0.3.5+; no new generic Core helper was needed.

Version: 0.10.0
Date: 2026-10-10

  Specialist Development:
    - Added one specialist-development project to the surface-colony project chain for Mining, Industry, Logistics, Research and Agriculture specialisations.
    - Specialist projects consume the required 0.9 specialty-material stack instead of adding duplicate provider recipes.
    - A colony can complete only one specialist-development project; changing specialisation later cannot accumulate every specialist project bonus.

  Bonuses:
    - Mining: Deep Resource Directorate further reduces Deep Bore and Advanced Deep Bore workforce requirements.
    - Industry: Precision Industrial Works further reduces workforce requirements across CH industry.
    - Logistics: Intermodal Freight Hub improves freight-export priority and adds a reserve-surplus growth bonus.
    - Research: Advanced Research Campus increases the specialist-workforce share and reduces later colony-project material requirements by 15%.
    - Agriculture: Agricultural Biosphere further improves population growth and food efficiency.

  Existing Saves:
    - Existing 0.9.x colony/project state remains valid; no destructive migration is required.
    - Colonies already specialised will see their specialist project inserted after Frontier Infrastructure if it has not been completed.

Version: 0.9.1
Date: 2026-10-10

  Changes:
    - Corrected release metadata to state that the 16 validated specialty-material providers are required dependencies.
    - Removed obsolete provider-discovery development notes from the 0.9 release changelog.
    - Updated stale internal comments left from the provider-audit development phase.

  Compatibility:
    - No gameplay or balance changes from 0.9.0.
    - Existing 0.9.0 saves remain compatible.
    - Requires Forgeworks Core 0.3.5 or newer.

Version: 0.9.0
Date: 2026-10-10

  Major Features:
    - Added CH-owned specialty-material production routes integrated into orbital construction, colony electronics, environmental supplies, megastructure engineering and stellar control.
    - Added magnesium + neodymium orbital construction frames.
    - Added silicon + gallium + antimony + tin advanced colony electronics.
    - Added cadmium + phosphorus + lead environmental supplies.
    - Added titanium + zirconium + manganese + bismuth + carbon-fibre megastructure segments.
    - Added caesium + gallium + neodymium + tellurium stellar-control cores.

  Dependencies:
    - Made Tellurium, Magnesium, Neodymium, Cadmium, Phosphorus, Caesium, Gallium, Antimony, Manganese, Zirconium, Titanium, Tin, Silicon, Lead, Carbon and Bismuth required dependencies.
    - Pinned the validated minimum Mod Portal versions for all 16 providers.
    - Requires Forgeworks Core 0.3.5 or newer.

  Compatibility:
    - Added targeted Factorio 2.1 compatibility for current Mod Portal BZ/Brevven providers while leaving third-party packages untouched.
    - Corrected AAI Industry + BZ Tin glass compatibility under Krastorio 2 / Space Exploration, including kr-glass main-product handling.
    - Added BZ Silicon 2.0.19 K2 + SE compatibility for the missing silicon-vulcanite data-stage contract and normalised the result to kr-silicon.
    - Added targeted stack-entry type compatibility for BZ Titanium, Lead, Zirconium, Tin, Carbon, Manganese and Bismuth recipes.
    - Migrated generic recipe probability and stack-entry compatibility logic into Forgeworks Core 0.3.5 helpers.

  Existing Saves:
    - Fixed colony population loss during tracked-entity index rebuilds by restoring the complete asset index before recalculating housing capacity.
    - Preserves colony identity, population, specialisation, project state, supplies, freight state and tracked entity references across configuration changes.
    - Existing 0.8.0 saves are supported.


Version: 0.8.0
Date: 2026-10-10

  Major Features:
    - Added a force-wide colony selector to the Colony Overview.
    - Formalised independent multi-surface colony state for planetary and orbital settlements.
    - Added population-scaled supply demand, reserve bonuses and distinct orbital supply profiles.
    - Added dedicated surface and orbital infrastructure-project progressions.
    - Expanded specialisations so mining, industry, logistics, research and agriculture have distinct operational effects.
    - Expanded freight planning with orbital-route awareness and unmet-demand reporting.

  Changes:
    - Colony Overview can switch directly between every colony owned by the player's force.
    - Surface and orbital colonies keep independent population, housing, supplies, projects, deficits, freight plans and specialisations.
    - Orbital colonies require Environmental Supplies and additional maintenance/research reserves.
    - Strong supply reserves provide a modest population-growth and stability bonus.
    - Orbital Habitats can provide colony governance for orbital specialisation.
    - Agriculture specialisation remains limited to solid worlds.
    - Orbital projects stage materials through Freight Terminals instead of planetary Project Offices.
    - Freight recommendations identify orbital vs interplanetary routes and report demand that no colony can currently satisfy.
    - Planetary Freight Network, Orbital Logistics Link and specialisations influence freight recommendation priority.
    - Migrated CH GUI event validation to Forgeworks Core's shared safe GUI event helper.

  Migration:
    - Added 0.8.0 storage migration for independent demand profiles, freight unmet-demand state and supply reserve bonuses.
    - Existing 0.7.0 population, supplies, projects and specialisations are preserved.

  Bugfixes:
    - Existing-save colony rebuilds now preserve population by restoring the full tracked asset index before recalculating housing capacity.
    - Fixed existing-save colony population loss during entity-index rebuilds. Rebuilds now restore all tracked asset references before recalculating colony capacity, instead of recalculating against a partially rebuilt housing index.
    - Normal newly-built entity registration still applies the intended initial population defaults and immediate recalculation.
    - Strengthened the release/test locale audit to detect duplicate section headers as well as duplicate keys.
    - Uses Factorio 2.x `helpers.write_file` with per-player output for multiplayer-safe test reporting.
    - Prevented Space Exploration from swapping CH orbital machines into hidden -spaced variants by removing inherited productivity support.
    - Fixed Space Exploration orbit placement compatibility for Colonial Horizons orbital machines.
    - Marked all Colonial Horizons orbital assembling-machine derivatives as Space Exploration space-compatible so they are physically placeable on orbital platform tiles.

  Compatibility:
    - Factorio 2.1.
    - Requires Forgeworks Core 0.3.4 or newer.
    - Requires Space Exploration 0.7.62 or newer.
    - Requires Krastorio 2 2.1.3 or newer.

Version: 0.7.0
Date: 2026-10-08

  Major Features:
    - Added supply-driven colony population growth, decline, stability and growth-state simulation.
    - Added colony tier gates for infrastructure projects, making population growth part of progression.
    - Expanded the colony overview with stability, growth, next-tier progress, supply reserves and asset summaries.
    - Integrated embedded ICB colony depots into Colonial Horizons supply storage.

  Changes:
    - Population growth now scales with population, habitability, stability, agriculture specialisation and infrastructure investment.
    - Environmental Supplies are required for severe-hazard colonies rather than mild frontier worlds.
    - Orbital Habitats provide artificial-environment habitability so orbit colonies can develop without planetary terraforming machinery.
    - Severe food or medical shortages can cause population decline; consumer/environmental shortages suppress growth and stability.
    - Colony Administration contributes to settlement stability once an outpost exists.
    - Frontier Infrastructure now requires Outpost tier; district/network/environmental projects require Settlement; orbital and megastructure projects require Colony; Stellar Engineering requires Metropolis.
    - Added explicit population-cycle state for save-safe GUI/status reporting.
    - Raised the Forgeworks Core requirement to 0.3.4 for LocalisedString-safe GUI frame helpers.

  Migration:
    - Added a 0.7.0 migration for stability, growth-state, population-delta and supply-coverage state.
    - Existing colony entity indexes and 0.6.x population/project state are preserved.

  Bugfixes:
    - Fixed embedded ICB GUI click handling so destroyed GUI elements are ignored safely.
    - Migrated remaining embedded ICB/crafter inventory access to the Factorio 2.1 crafter_input/crafter_output API and hardened nil-inventory paths.

  Compatibility:
    - Factorio 2.1.
    - Requires Forgeworks Core 0.3.4 or newer.
    - Requires Space Exploration 0.7.62 or newer.
    - Requires Krastorio 2 2.1.3 or newer.

Version: 0.6.1
Date: 2026-10-07

  Locale:
    - Completed a full English locale audit across Colonial Horizons and embedded content.
    - Added names and descriptions for Colonial Horizons settings.
    - Added item group, subgroup and recipe-category labels.
    - Added explicit names for the complete Colonial Horizons recipe set.
    - Added missing embedded colony research-service descriptions.
    - Added the missing shared Economic Growth item description.
    - Updated Orbital Colonisation wording to reflect orbit-only infrastructure rules.
    - Verified English and Spanish locale files contain no duplicate keys, malformed entries or empty values.

  Compatibility:
    - Factorio 2.1.
    - Requires Forgeworks Core 0.3.3 or newer.
    - Requires Space Exploration 0.7.62 or newer.
    - Requires Krastorio 2 2.1.3 or newer.


  Locale:
    - Added explicit recipe names for imported recipes whose product substitutions can break implicit locale fallback.
    - Added missing imported technology, entity, recipe-category, and item-subgroup labels.
    - Fixed the unresolved recipe-name.gold-wire key seen with the 248k integration.

Version: 0.6.0
Date: 2026-10-07

  Major Features:
    - Added Frontier Agriculture as a required colony progression step.
    - Integrated colony-produce and colony-consumer-essentials into the Colonial Horizons supply economy.
    - Expanded Salvage & Archaeology into a meaningful progression branch.
    - Added Recovered Maintenance Kits from salvage fragments.
    - Integrated Artifact Data directly into Research Supplies.
    - Refined Space Exploration surface roles for planetary and orbital colony infrastructure.

  Changes:
    - Added ch-colony-food-from-produce.
    - Added ch-medical-supplies-from-produce.
    - Added ch-consumer-supplies-from-essentials.
    - Settlement Administration now requires Frontier Agriculture.
    - Ancient debris generation is restricted to solid Space Exploration zones.
    - Orbital Habitat, Orbital Fabricator, Megaproject Yard, and Stellar Engineering Array are restricted to true orbit zones.
    - Planetary Colonial Horizons structures are restricted to solid Space Exploration zones.
    - Colony Depot and Freight Terminal remain intentionally usable across solid and orbital surfaces.
    - Added colony entity-index rebuild on init and configuration change while preserving colony gameplay state.

  Bugfixes:
    - Fixed the final Medical Supplies recipe so colony-produce is preserved alongside sulfur.
    - Corrected salvage recipe/unlock ownership and internal progression links.
    - Prevented orbital-only structures from being placed on asteroid fields, spaceships, or other generic space surfaces.
    - Ensured scripted/cloned placement obeys the same surface rules without creating free refunds.
    - Improved save compatibility by rebuilding tracked colony entity references from the actual world state.
    - Preserved existing structures during migration even where stricter 0.6.0 placement rules apply to new construction.

  Compatibility:
    - Factorio 2.1.
    - Requires Forgeworks Core 0.3.3 or newer.
    - Requires Space Exploration 0.7.62 or newer.
    - Requires Krastorio 2 2.1.3 or newer.

Version: 0.5.0
Date: 2026-10-07

  Major Features:
    - First public Colonial Horizons release.
    - Added colony-focused frontier progression.
    - Added agriculture, greenhouse and hydroponics progression.
    - Added salvage and archaeology systems.
    - Added orbital colony infrastructure.
    - Added VTOL atmospheric and orbital transport.

  Changes:
    - Integrated imported colony content with Space Exploration and Krastorio 2 progression.
    - Converted imported recipe unlock ownership to Forgeworks Core handling.
    - Updated legacy Factorio graphics and tile definitions for Factorio 2.1.

  Bugfixes:
    - Fixed legacy recipe result mutations and recipe compaction.
    - Fixed Gunpowder output handling.
    - Fixed Hydroponics to use kr-fertilizer.
    - Fixed invalid orbital building placement and refunds.
    - Fixed quality preservation during placement refunds.
    - Fixed colony building clone registration.
    - Fixed VTOL takeoff initialization.
    - Fixed VTOL atmospheric takeoff, orbital ascent, descent and landing.
    - Prevented VTOL landing on orbital surfaces.
    - Fixed VTOL equipment-grid transfer handling.

  Compatibility:
    - Factorio 2.1.
    - Requires Forgeworks Core 0.3.3 or newer.
    - Requires Space Exploration 0.7.62 or newer.
    - Requires Krastorio 2 2.1.3 or newer.