Orbital Map Uplink


Satellite driven orbital reconnaissance with enemy detection and optional Planetary Pacification (Optional Mod) integration.

Tweaks
9 days ago
2.0
307
Environment

Changelog

Version: 0.9.1
Date: 2026-07-03
Fixes:
* Fixed Radio Station scan power behaviour.
* Fixed scan mode not creating a visible scan-related power demand.
* Fixed Radio Station scan power previously being checked but not consumed.
* Fixed scan power usage appearing constant when orbital scan mode was enabled.
* Fixed misleading scan surge behaviour where available power was checked without applying an actual energy cost.

Changes:
* Orbital scan pulses now consume stored energy from powered Radio Stations.
* Radio Station scan power is now applied as a per-pulse stored-energy drain.
* Added a shared scan surge duration constant to keep scan power checks and scan power consumption aligned.
* Default scan surge duration is now 0.5 seconds per scan pulse.
* Scan pulses now require each powered Radio Station to have sufficient stored scan energy before the pulse is performed.
* Scan pulses now fail safely if Radio Stations do not have enough stored energy.
* Updated the insufficient-power message to clarify that stored Radio Station scan energy is required.
* Power networks should now show temporary recharge demand after orbital scan pulses.

Balancing:
* Default scan pulse energy cost is now 4 MJ per Radio Station.
* Default scan pulse energy cost is calculated from 8 MW × 0.5 seconds.
* Active scan energy cost now scales with the number of powered Radio Stations.
* Active scan energy cost now scales with the configured Radio Station scan power setting.
* Radio Stations still require normal idle power outside scan pulses.
* The scan surge remains intentionally pulse-based rather than continuous.

Compatibility:
* Existing saves remain supported.
* No new entities, recipes, technologies, or graphics were added.
* Planetary Pacification integration is unchanged.
* Space Age remains optional.
* Orbital Map Uplink remains fully standalone.

Notes:
* This is a focused power-behaviour patch for OMU 0.9.0.
* The displayed scan surge value represents the configured scan power requirement across powered Radio Stations.
* The actual energy consumed per pulse is based on the scan power setting multiplied by the scan surge duration.
* With default settings, each powered Radio Station consumes 4 MJ per scan pulse.
Version: 0.9.0
Date: 2026-07-03
Features:
* Added /omu-status command for player-facing orbital network diagnostics.
* Added improved Planetary Pacification intelligence messages.
* Added staged scan-confidence messaging for Planetary Pacification integration.
* Added status/debug output setting for testing and troubleshooting.
* Added optional satellite requirement setting for Planetary Pacification scan contribution.
* Added clearer 0.9.0 remote interface version reporting.
* Added pending satellite scan reporting to network status output.
* Added orbital scan count reporting to network status output.
* Added Planetary Pacification integration status reporting to network status output.

Changes:
* Planetary Pacification scan contribution is now tied to valid satellite-driven orbital scan starts.
* Repeated orbital scan pulses no longer create additional Planetary Pacification scan contributions.
* Satellite launches now create pending scan credits for Planetary Pacification integration.
* Opening map view with a valid powered uplink now consumes one pending scan credit.
* Planetary Pacification scan messages now use intelligence-style wording instead of generic transmission text.
* Updated Planetary Pacification integration payloads to report Orbital Map Uplink interface version 0.9.0.
* Improved player-facing visibility of powered Radio Stations, scan counts, pending scans, and integration availability.
* Kept Orbital Map Uplink fully standalone with no Planetary Pacification dependency declaration.

Fixes:
* Prevented repeated scan pulses from causing duplicate Planetary Pacification scan progress.
* Improved defensive handling around optional Planetary Pacification remote interface calls.
* Improved testing visibility for pending satellite scans, scan counts, and integration callback availability.
* Fixed scan-count accounting so only valid scan-start events advance Planetary Pacification scan progress.
* Fixed interface version reporting for the 0.9.0 integration payloads.

Compatibility:
* Orbital Map Uplink remains fully standalone.
* Planetary Pacification remains optional.
* Space Age remains optional.
* No new buildings, recipes, graphics, or hard dependencies were added.
* Existing saves remain supported.

Notes:
* This release focuses on orbital intelligence polish and integration clarity.
* When Planetary Pacification is installed, OMU satellite scans contribute to Conduit signal analysis without bypassing the ground-search loop.

----------------
Version: 0.8.0
Date: 2026-06-18
----------------

Features:
* Added the Orbital Map Uplink side of the optional Planetary Pacification integration bridge.
* Added safe integration handling for Planetary Pacification remote callbacks.
* Added uplink activation notification support for Planetary Pacification.
* Added satellite-gated orbital scan completion notification support for Planetary Pacification.
* Added successful orbital scan count tracking by force and surface.
* Added pending satellite scan tracking by force and surface.
* Added remote interface access to orbital scan counts.
* Added Planetary Pacification integration status reporting through the Orbital Map Uplink remote interface.
* Added configurable Planetary Pacification integration enable/disable setting.
* Added optional scan result messaging setting for successful Planetary Pacification transmissions.

Changes:
* Satellite launches now create pending orbital scan credits after a valid Radar Center uplink activation.
* Pending satellite scan credits are consumed only when a player opens map view with an active uplink, powered Radio Station coverage, and sufficient scan surge power.
* Successful satellite-based scan events are now counted when a pending satellite scan is consumed by a valid powered map-view scan.
* Repeated scan pulses during the same map-view session no longer advance external Planetary Pacification scan progress.
* Orbital scan pulses continue to refresh map coverage and enemy detection data without creating additional Planetary Pacification scan events.
* Orbital scan completion can now prepare and transmit clean scan data to Planetary Pacification when the receiving interface is available.
* Scan completion payloads include force name, surface name, scan count, pending satellite scan count, powered Radio Station count, full chart refresh status, enemy detection status, and detected enemy cluster data.
* Satellite uplink activation can now safely notify Planetary Pacification when the receiving interface is available.
* Orbital Map Uplink now exposes additional integration status and scan count information through its remote interface.
* Orbital Map Uplink remains fully standalone and does not declare Planetary Pacification as a dependency.

Settings:
* Added Planetary Pacification integration setting.
* Added Planetary Pacification scan result messages setting.
* Scan result messages are disabled by default to avoid message spam.

Compatibility:
* Planetary Pacification integration is optional.
* No hard dependency on Planetary Pacification was added.
* If Planetary Pacification is not installed, Orbital Map Uplink continues to function normally.
* If Planetary Pacification is installed but does not expose the expected receiver interface, integration calls are skipped safely.
* Existing Radar Center, satellite uplink, Radio Station, orbital scan, full chart refresh, enemy detection, marker, shortcut, setting, and low-power behaviour remain unchanged.
* Existing saves remain supported.

Remote Interface:
* Updated Orbital Map Uplink interface version to 0.8.0.
* Added remote access to successful orbital scan counts.
* Added remote access to Planetary Pacification integration status.
* Retained existing remote access to uplink status, powered Radio Station count, full chart refresh availability, enemy detection availability, detected enemy clusters, and network status.

Fixes:
* Avoided circular dependency issues by keeping Planetary Pacification out of Orbital Map Uplink’s dependency list.
* Added safe remote-call checks so missing Planetary Pacification callbacks do not cause crashes.
* Added protected remote calls so integration errors are logged rather than breaking Orbital Map Uplink gameplay.
* Fixed Planetary Pacification scan progression over-counting by ensuring scan completion events are satellite-gated rather than pulse-gated.

Notes:
* This release adds the Orbital Map Uplink provider side of the Planetary Pacification integration.
* No new buildings, recipes, graphics, or direct pacification mechanics were added.
* Planetary Pacification remains optional.
* Orbital Map Uplink now acts as a standalone reconnaissance provider that can support other mods through its remote interface.

----------------
Version: 0.7.0 (unreleased)
Date: 2026-06-18
----------------

Features:
* Added remote interface for optional mod integration.
* Added integration hooks for querying orbital uplink status.
* Added integration hooks for querying powered Radio Station network strength.
* Added integration hooks for querying full chart refresh availability.
* Added integration hooks for querying local and extended enemy detection availability.
* Added integration hooks for retrieving last detected enemy structure clusters.
* Added network status summary for external mods.

Changes:
* Enemy detection clusters are now stored as clean runtime data for integration use.
* Enemy detection cluster data is cleared alongside old detection markers.
* Orbital Map Uplink can now act as a reconnaissance data provider for other mods.
* No hard dependency on any other mod was added.

Compatibility:
* Orbital Map Uplink remains fully standalone.
* The new remote interface is intended for optional integrations such as Planetary Pacification.
* Existing Radar Center, satellite uplink, Radio Station, scan, enemy detection, marker, shortcut, and settings behaviour remain unchanged.

Notes:
* This update adds integration groundwork only.
* No new buildings, recipes, graphics, or player-facing gameplay systems were added.

----------------
Version: 0.6.1
Date: 2026-06-17
----------------

Features:
* Added enemy detection markers to the Radio Station network.
* Added enemy structure detection during orbital scan pulses.
* Added local enemy detection within powered Radio Station coverage areas.
* Added extended enemy detection unlocked by a configurable powered Radio Station threshold.
* Added configurable enemy detection enable/disable setting.
* Added configurable enemy detection Radio Station threshold.
* Added configurable extended enemy detection range.
* Added configurable enemy detection marker limit.
* Added a custom enemy detection virtual signal using the base-game big worm icon.
* Added map markers for detected enemy structure clusters.

Changes:
* Enemy detection now detects enemy spawners and worms only.
* Enemy units, biters, spitters, and moving attack groups are intentionally ignored.
* Enemy markers now use a big worm icon instead of the radar icon.
* Enemy marker text has been shortened to “Detected (x)” to reduce map clutter.
* Enemy detections are grouped into clusters rather than placing one marker per enemy structure.
* Old enemy detection markers are cleared and refreshed on each detection pass.
* Detection remains tied to the active orbital scan system and powered Radio Station network.
* Extended enemy detection is separate from the full chart refresh threshold and defaults to 12 powered Radio Stations.

Balancing:
* Enemy detection is enabled by default.
* Extended enemy detection requires 12 powered Radio Stations by default.
* Extended enemy detection scans around player-built infrastructure within a default range of 1000 tiles.
* Enemy detection markers are limited to 50 per detection pass by default.
* Detection does not reveal unexplored black map areas.
* Detection does not force-generate new chunks.
* Detection does not track or mark moving enemy units.

Settings:
* Added Enemy detection enabled setting.
* Added Enemy detection Radio Station threshold setting.
* Added Extended enemy detection range setting.
* Added Enemy detection marker limit setting.

Graphics:
* Added a custom virtual signal for enemy detection markers.
* Enemy detection markers now use the base-game big worm icon.
* Replaced the previous temporary radar-icon marker presentation.

Fixes:
* Fixed enemy detection marker clutter by shortening marker text.
* Fixed marker spam risk by clustering detected enemy structures.
* Fixed stale marker behaviour by clearing old orbital enemy markers before placing refreshed detections.
* Fixed detection scope so moving enemy units are not marked.
* Fixed runtime function ordering issues in the enemy detection implementation.

Compatibility:
* Builds directly on the 0.6.0 Radio Station network.
* No new buildings, recipes, or items were added.
* Existing Radar Center, satellite uplink, Radio Station, scan coverage, full chart refresh, shortcut, and low-power scan behaviour remain unchanged.

Notes:
* Enemy detection is an intelligence layer, not a full map reveal.
* Detection is limited to enemy spawners and worms.
* Local detection uses powered Radio Station coverage.
* Extended detection uses player-built infrastructure areas once the configured Radio Station threshold is met.
* Future updates may expand marker behaviour, alerts, or threat summaries, but 0.6.1 intentionally keeps the system focused and lightweight.

----------------
Version: 0.6.0 (Unreleased)
Date: 2026-06-17
----------------

Features:
* Added the Radio Station as a new powered network structure.
* Added Radio Station item, recipe, entity, icon, graphics, animation, and locale entries.
* Added Radio Station-based orbital scan coverage.
* Added configurable Radio Station scan area.
* Added configurable full chart refresh threshold.
* Added configurable Radio Station scan power surge requirement.
* Added low-power scan failure handling.
* Added runtime handling for orbital scan setting changes.
* Added full chart refresh unlock when enough powered Radio Stations are active.

Changes:
* Orbital scanning is now driven by the powered Radio Station network.
* Satellite launch now activates the uplink only and no longer immediately performs a full chart refresh.
* Powered Radio Stations now determine local orbital scan coverage.
* Ten powered Radio Stations unlock full chart refresh by default.
* Radio Station coverage scans chart available/generated terrain around each powered Radio Station.
* Full chart refresh applies to already available/generated territory and does not intentionally force-generate unexplored chunks.
* Updated scan messaging to distinguish between local coverage scans and full chart refresh.
* Updated shortcut and uplink messaging to reference the Radio Station network.
* Runtime setting changes now reset active scan sessions so changes apply cleanly after reopening map view.

Balancing:
* Each Radio Station consumes 2 MW while powered.
* The Radar Center consumes 5 MW as the ground-side uplink controller.
* Each powered Radio Station provides a default 512 x 512 tile charting area.
* Ten powered Radio Stations are required by default to unlock full chart refresh.
* Each powered Radio Station requires an 8 MW scan surge by default.
* Scan surge checks require each powered Radio Station to have sufficient stored energy at scan start.
* Radio Station stack size is 1.
* Radio Station unlocks with rocket silo technology.

Settings:
* Added Radio Station scan area setting.
* Added full chart refresh Radio Station threshold setting.
* Added Radio Station scan power surge setting.
* Existing scan duration and scan pulse interval settings remain supported.
* Runtime-global settings apply after active scan sessions reset and map view is reopened.

Graphics:
* Added custom Radio Station entity graphics (Graphics credit: Hurricane).
* Added custom Radio Station icon (Graphics credit: Hurricane).
* Added animated Radio Station visuals using a pre-composited animation sheet.
* Preserved existing Radar Center visuals.

Fixes:
* Fixed scan behaviour so satellite launch no longer bypasses the Radio Station network.
* Fixed scan logic so unpowered Radio Stations do not contribute to orbital scan coverage.
* Fixed scan logic so full chart refresh is only available at or above the configured powered Radio Station threshold.
* Fixed low-power scan handling so insufficient Radio Station network power blocks scan start.
* Fixed runtime setting behaviour by clearing active scan sessions when relevant settings change.

Compatibility:
* Space Age remains an optional dependency.
* Radio Station recipe unlocks through rocket silo technology.
* Existing Radar Center and satellite uplink behaviour remains compatible with the 0.5.x system after uplink reactivation.

Notes:
* The Radio Station network is now the core scan-extension mechanic.
* Local coverage scans chart generated/available terrain around powered Radio Stations.
* Full chart refresh does not intentionally reveal all unexplored black map areas.
* Enemy detection is not included in this release and is reserved for a future update.

----------------
Version: 0.5.2 (Unreleased)
Date: 2026-06-17
----------------

Changes:
* Moved the Radar Center item and recipe to the Space tab when Space Age is active.
* Added a safe item-subgroup fallback so the Radar Center remains available when Space Age is not active.
* Changed Radar Center stack size from 10 to 1.

Compatibility:
* Space Age remains an optional dependency.
* If the Space Age space-related subgroup is unavailable, the Radar Center falls back to the Production tab.

Notes:
* This release contains item placement, compatibility, and inventory stack-size adjustments only.
* No changes were made to satellite launch logic, uplink activation, orbital scan behaviour, graphics, migration handling, or   shortcut behaviour.

----------------
Version: 0.5.1 (Unreleased)
Date: 2026-06-17
----------------

Migration:
* Added save migration handling for existing saves from earlier versions.
* Existing orbital uplinks from earlier versions are reset when updating to 0.5.1.
* Players updating from 0.4.0 or 0.5.0 must build a Radar Center and launch a satellite to reactivate orbital scanning.
* Existing saves should continue to load normally.

Notes:
* This release contains migration and compatibility handling only.
* No gameplay balance, graphics, recipe, shortcut, or scan behaviour changes were made.

----------------
Version: 0.5.0 (Unreleased)
Date: 2026-06-16
----------------

Features:
* Added the Radar Center as a new placeable structure.
* Added Radar Center item, recipe, entity, icon, graphics, and player-facing locale.
* Replaced the previous standard radar requirement with the new Radar Center requirement.
* Added animated Radar Center visuals using a static base with a pulsing orange uplink glow.

Changes:
* Changed the Radar Center entity implementation from a radar-based prototype to a powered electric-energy-interface.
* Updated satellite uplink activation logic to check for a placed Radar Center instead of a standard radar.
* Updated satellite launch failure messages to reference the Radar Center requirement.
* Updated shortcut inactive messaging to explain that both a Radar Center and satellite launch are required.
* Preserved the satellite as the launched orbital payload.
* Kept the satellite using the original base-game satellite icon.
* Kept the internal prototype name as orbital-map-uplink-research-center while displaying the structure to players as Radar Center.

Balancing:
* Radar Center recipe requires:
	- 50 radars
	- 100 processing units
	- 100 low-density structures
	- 50 accumulators
	- 20 solar panels
	- 1 satellite
* Radar Center unlocks with rocket silo technology.
* Radar Center consumes power as a ground-side uplink facility.
* Ordinary radars remain part of the Radar Center recipe but are no longer directly required for satellite uplink activation.
* Radar Center does not reveal map sectors by itself.

Graphics:
* Added custom Radar Center item and recipe icon (Graphics credit "Research Center": Hurricane).
* Added custom animated Radar Center entity graphics (Graphics credit "Research Center": Hurricane).
* Added a static Radar Center base with a pulsing orange uplink glow.

Notes:
* The Radar Center acts as the required ground-side uplink structure.
* The satellite remains the item that must be launched to activate the orbital uplink.
* The Orbital Scan shortcut continues to control automatic map refreshing when opening map view.
* Radio Station network-extension features are reserved for a future update.

----------------
Version: 0.4.0
Date: 2026-06-15
----------------

Features:
* Added a toggleable shortcut bar button for automatic orbital scanning.
* Added player control for enabling or disabling automatic satellite scans when opening map view.
* Added shortcut feedback before satellite uplink activation.
* Added per-player scan toggle state.

Changes:
* Orbital scanning is now controlled per player rather than being forced globally.
* Opening map view only starts an orbital scan when the player’s shortcut toggle is enabled.
* Disabling the shortcut stops any active orbital scan for that player.
* Enabling the shortcut while already in map view starts an orbital scan immediately.
* The shortcut remains visible from game start and explains the satellite uplink requirement when used before activation.

Interface:
* Added shortcut name and description locale entries.
* Added a satellite-icon shortcut using the base satellite icon.
* Improved player control over when orbital scans occur.

Notes:
* The satellite launch requirement remains unchanged.
* Existing scan duration and pulse interval settings remain supported.

----------------
Version: 0.3.0
Date: 2026-06-13
----------------

Features:
* Added configurable orbital scan duration after opening map view.
* Added configurable scan pulse interval while an orbital scan is active.
* Added temporary orbital scan windows triggered by opening map view.
* Added repeated map refresh pulses during active scan windows.

Changes:
* Replaced continuous background map refreshing with a controlled map-view scan system.
* Orbital scanning now stops automatically when the player closes map view.
* Orbital scanning now stops automatically when the configured scan duration expires.
* Reduced unnecessary map refresh activity to improve performance on larger maps.

Balancing:
* Default orbital scan duration set to 3 minutes.
* Default scan pulse interval set to 10 seconds.
* Players can increase scan duration for larger maps.
* Players can increase scan pulse interval for better performance on larger saves.

Locale:
* Added English locale entries for orbital scan duration.
* Added English locale entries for orbital scan pulse interval.

Notes:
* The mod does not intentionally reveal unexplored black map areas.
* The satellite uplink remains dependent on a successful satellite launch and a valid ground-side uplink requirement.

----------------
Version: 0.2.0
Date: 2026-06-11
----------------

Features:
* Added satellite-based orbital map uplink functionality.
* Added successful satellite launch detection.
* Added persistent uplink activation after a successful satellite launch.
* Added map refresh behaviour for already-charted territory.
* Added support for Space Age rocket cargo/orbit launch behaviour.

Compatibility:
* Restored the satellite item and recipe when Space Age is enabled and the satellite is otherwise unavailable.
* Preserved base-game satellite behaviour when Space Age is not enabled.
* Added optional Space Age dependency support.

Graphics:
* Restored the original satellite icon instead of using the temporary radar icon.

Balancing:
* Set the satellite to a valid rocket payload weight so it can be launched successfully.
* Kept the satellite stack size at 1 so each launch feels like a deliberate orbital payload.

Scripting:
* Added detection for satellite launches through cargo pod launch events.
* Added detection for base-game satellite launches through launched item statistics.
* Added ground-side uplink validation before activating the satellite uplink.
* Added failure and success messages for satellite uplink attempts.

Locale:
* Added English locale entries for the satellite item.
* Added English locale entries for the satellite recipe.
* Added English locale entries for satellite descriptions.

----------------
Version: 0.1.0
Date: 2026-06-11
----------------

Features:
* Initial working prototype.
* Added Orbital Map Uplink as a satellite-based reconnaissance mod.
* Added basic mod structure.
* Added satellite launch detection.
* Added initial ground radar requirement.
* Added map refresh effect for previously explored territory.

Developer Features:
* Added initial runtime scripting through control.lua.
* Added initial prototype handling through data-final-fixes.lua.
* Added basic locale support.
* Added initial Space Age compatibility testing.

Notes:
* The mod does not reveal newly unexplored terrain.
* The mod is intended to give the satellite a meaningful late-game reconnaissance purpose.
* Initial radar requirement was later replaced by the Radar Center in version 0.5.0.