QuantumConduit
Automatic planetary logistics and mecha slot refills with proliferation preservation, budgeted processing, energy exchanger support, and optional interstellar transfers. By Loki Moon Labs.
| Date uploaded | a week ago |
| Version | 1.1.8 |
| Download link | LokiMoonLabs-QuantumConduit-1.1.8.zip |
| Downloads | 19 |
| Dependency string | LokiMoonLabs-QuantumConduit-1.1.8 |
This mod requires the following mods to function
CommonAPI-DSPModSave
Library that allows to store mod save data separately from vanilla saves
Preferred version: 1.2.2README
Quantum Conduit
Bug reports and support
Report a bug or browse existing reports in the shared Loki Moon Labs DSP support tracker. Select the affected mod and include its version, the game version, and steps to reproduce the problem.
Loki Moon Labs · 1.1.8 · Single-player
Automatic planetary logistics with proliferation preservation and a configurable processing budget. Built against Dyson Sphere Program 0.10.35.29151.
Quantum Conduit connects production and consumption directly. It serves machines from available production first, covers shortages from storage, and places remaining production into compatible storage. Items and their spray points move together between real game inventories.
Supported buildings and inventories
- Assemblers, smelters, chemical plants, refineries, and other buildings using the assembler component.
- Matrix production and research labs, including the game's internal research-point units.
- Miners and pumps using the miner component.
- Thermal and fusion fuel inventories, ray-receiver catalysts, and whole photon output. Native fuel heat and fractional photon progress are preserved.
- Energy exchangers, with accumulator count and proliferation preserved in both charging and discharging modes.
- Fractionator input, circulating fluid output, and product output. Empty fractionators can start without a belt from available, unlocked fractionation recipes and restart after the game clears an empty input. An existing remembered product is preserved; other buffered items block recipe initialization.
- EM rail ejectors, rocket silos, and configured turret ammunition.
- Item-assigned or filtered storage grids, configured storage tanks, and assigned PLS/ILS slots. Surplus hydrogen can also establish an item type in empty unfiltered box slots and empty input-enabled tanks.
- Dedicated station warpers after the required technology is unlocked.
- Recoverable trash associated with that planet. Space trash without an associated planet is left alone.
- Assigned Icarus logistics slots, with optional refill-only delivery from the current planet's production and storage.
Surplus hydrogen can automatically fill empty, unfiltered storage-box slots and empty storage tanks with input enabled. Other items still require an assigned item, filter or existing stock. PLS/ILS slots must be assigned explicitly, including hydrogen slots; their local/remote modes remain unchanged. Box bans, filters and tank input/output switches are respected.
Planetary transfers work with local slots set to Storage, Supply, or Demand. Quantum Conduit does not change these settings, station capacities, vessel counts, recipes, power rates, or stacking settings. Native drone/vessel reservations are protected. Idle storage inventories are not shuffled between stations.
Surplus hydrogen storage
Hydrogen production from any recipe, including multi-output byproduct recipes, first serves eligible machine demand. Remaining output is transferred to compatible storage on that planet: hydrogen-assigned station slots, existing hydrogen storage, empty unfiltered box slots and empty input-enabled tanks. Tank liquid ID is established only when a real delivery commits. No belt priming is required for an empty tank.
Storage assigned to another item/liquid, incompatible filters, banned slots and disabled tank inputs are not overwritten. To reserve an empty box for another item, set its filter before leaving it available to the network. Hydrogen tanks with output disabled remain storage destinations rather than competing machine consumers. Proliferation, slot reservations and actual capacities are preserved.
With SmartTank (OverflowTank) installed and its hydrogen overflow enabled, you can set EnableSmartTankHydrogenOverflow = true under [Compatibility] in Quantum Conduit's config. After machine demand and available storage are checked, an input-enabled full hydrogen tank on the same planet lets Quantum Conduit discard surplus hydrogen directly from multi-output recipes such as Antimatter and alternate Graphene. The tank's contents and the other recipe outputs stay intact. This option defaults to off.
Fractionators' unconverted hydrogen remains reserved for their own return loops. Full storage leaves extra hydrogen in production; Quantum Conduit does not delete it or invoke SmartTank's belt-overflow disposal. Idle storage is not shuffled between stations or tanks.
Fractionator circulation
Unconverted fractionator input returns directly to its own machine, preserving its item count and proliferation. Quantum Conduit services these loops incrementally, even when AutomaticSpraying is off. Before fresh input is delivered, any waiting return is recycled first; unconverted fluid is excluded from global storage and mecha-supply routes. Native physical belts retain their normal behavior.
Fractionator products get priority over competing ordinary production when destination consumers or storage have room. Machines take fresh input to replace converted material and maintain their working buffers. This supports the game's eligible fractionation recipes without changing conversion probability, native processing, energy costs or production statistics.
Empty machines can start without belts from available unlocked recipe inputs. A remembered product is retained when the game clears an empty input ID. Conversion continues only while power, input and output space are available. Hydrogen becomes deuterium rather than disappearing; provide consumption or storage for the deuterium. Full output storage still stops production normally. No overflow deletion is added.
Proliferation
Existing proliferation is preserved even when automatic spraying is disabled or no proliferator is available. Mixed stacks use the game's own remainder-allocation rule.
Automatic spraying uses available Proliferator Mk.I, Mk.II and Mk.III from production or storage on that planet, preferring Mk.III, then Mk.II, then Mk.I. Each tier supplies its own coating strength and retains separate unused credit; lower-tier credit cannot produce higher-tier coating. Existing coating is never removed to apply a weaker tier. Already fully sprayed incoming items do not pay again. Partial remaining credit cannot become negative. The current item ability and Cargo effect tables are used, including boosted proliferator effects. Proliferator consumption is recorded in production statistics without replacing the statistics tick.
Proliferator items transferred directly into machines or other receiving inventories can be coated by a higher tier: Mk.III coats Mk.I/Mk.II, and Mk.II coats Mk.I. They are coated during the transfer, without waiting for the station-stock pass. These transfers do not spend the input's own tier or a weaker tier; existing coating still travels with the items.
With AutomaticSpraying = true, PLS and ILS cargo slots are also gradually topped up in place. This covers unsprayed arrivals from native drones, vessels, belts and other mods, plus existing partially sprayed stock. Local and remote slot modes are preserved. All three proliferator types can themselves be coated using real supplies, with its count reread after payment. Orbital collectors, advanced mining machines and dedicated warper reserves are excluded from this station pass.
Station checks share the existing processing budget, visit one slot at a time and add at most 4,096 spray points per visit. Large stations or low budgets may take time to reach full coating; immediate full spray on every arrival is not guaranteed. No supply or saved credit means no additional spray. Already fully coated stock is not charged again. Leave DistributeSpray disabled when using this feature to avoid duplicate spraying systems.
Unused spray credit for each tier is saved through DSPModSave, separately from normal item inventories. Version 1.1.0 reads older version-1 companion data and preserves its unused credit as Mk.III credit. New companion data uses format 2 and cannot be read by older Quantum Conduit builds; back up your game save and companion data before testing or downgrading. Keep that companion save data when moving or backing up saves. Dedicated warper inventories have no proliferation field in DSP; moving warpers into them discards their spray points, as vanilla warper use does. Quantum Conduit does not spend additional proliferator on that inventory.
Mecha logistics refills
AutoFillMechaLogistics is enabled by default. Assigned, unlocked, enabled Icarus logistics slots refill up to their requested quantity or modified slot capacity, whichever is lower. Items already reserved for incoming drone deliveries count toward that limit.
Refills use available production first, then eligible storage on Icarus's current planet. They preserve proliferation and use the existing shared processing budget. No direct off-planet refill occurs, and refills stop in space. Switching planets or replacing the logistics package invalidates prior routes. Incoming item notifications are coalesced and delivered after transfers commit.
This feature does not withdraw from mecha slots, change recycle thresholds, or directly alter normal inventory. Normal vanilla inventory behavior still applies. Logistics slots used only for recycling, with no requested quantity, are not refilled. Disable the option to retain only planetary machine transfers.
Performance
- One factory-frame-end hook, after the normal frame-end event handlers.
- Work is spread across ticks and factories, with operation and elapsed-time limits.
- Item routes use cached, reusable lists. An incremental second discovery plan refreshes routes while the previous plan keeps working.
- One incremental trash index is shared across planets.
- Transfers run synchronously at the factory-frame boundary. There are no mod worker threads, waits, or detached item buffers.
- Storage notifications are deduplicated and deferred until after both sides of a transfer are committed.
The default 0.75 ms time budget is a soft limit checked periodically. Individual operations, startup allocations, garbage collection, or other mods' callbacks can overrun it. Lower budgets favor frame times; higher budgets improve responsiveness in very large factories. New buildings and recipe changes appear after an incremental discovery pass; old cached addresses are validated before every use.
Configuration
The file LokiMoonLabs.QuantumConduit.cfg is generated when the plugin loads.
| Setting | Default | Purpose |
|---|---|---|
Enabled |
true |
Enable planetary transfers. |
AutomaticSpraying |
true |
Use the strongest available local proliferator tier to coat transfers and gradually top up station cargo. |
EnableInterstellar |
false |
Connect ILS remote Supply to remote Demand on different planets. Local slot settings remain independent. |
AutoFillMechaLogistics |
true |
Refill assigned Icarus logistics slots from the current planet without changing normal inventory or recycling. |
OperationsPerTick |
2048 |
Maximum discovery/route probes per factory tick. |
TimeBudgetMilliseconds |
0.75 |
Soft CPU budget per factory tick. |
FractionatorStackSize |
4 |
Items per virtual fractionator cargo; 4 matches PlanetWormhole's behavior. |
Fractionator stack size is independent of station/sorter stacking. Adjust it only if your fractionator setup calls for a different virtual cargo size.
Installing and testing
Requirements: BepInEx and CommonAPI-DSPModSave 1.2.2 or a compatible later version.
- Close Dyson Sphere Program.
- Disable PlanetWormhole in the mod manager. Quantum Conduit declares an incompatibility and will not load alongside it.
- Import the Quantum Conduit ZIP as a local mod in r2modman, then launch the modded game.
- Check a sprayed station-to-assembler transfer, thermal/fusion fuel, an energy exchanger, and the FPS/UPS of your usual factory.
- Save, reload, and confirm transfers continue. If testing a second save in the same game session, confirm it uses only its own inventories and spray credit.
Version 1.1.4 adds automatic surplus-hydrogen storage in empty tanks and unfiltered boxes, and passed 105,629 automated assertions. Full-scheduler cases cover three multi-output recipes, all storage types, machines before overflow storage, tank initialization, proliferation preservation, filters, bans, direction switches, backpressure and fractionator-loop isolation. In-game confirmation of this update is pending.
Version 1.1.3 adds dedicated return circulation and fractionator-product priority, and passed 105,506 automated assertions. A 600-tick simulation executes native fractionation alongside Quantum Conduit, checking item and proliferation conservation, matching native statistics, output collection and the shared operation budget every tick. Tests also cover multiple loops, return-before-fresh-input ordering, provider exclusion and competing product sources. Loki Moon Labs tested the complete fractionator update in game and confirmed it working before release.
Version 1.1.2 fixes startup and restart of empty fractionators and passed 103,100 automated assertions. Tests reproduce the missing input-ID issue through the full scheduler, execute native recipe setup and fractionator processing without belts, check product collection, and cover unlocks, multiple recipes, remembered products, stale addresses and invalid sign storage. This startup/restart fix is included in the user-confirmed 1.1.3 fractionator update.
Version 1.1.1 fixes higher-tier coating of lower-tier proliferator inputs and passed 103,084 automated assertions. Regression tests cover all three stronger-to-weaker combinations entering assembler/lab inputs and storage, exact physical supply payment, separate credit, existing coating and AutomaticSpraying off. Loki Moon Labs tested this fix in game and confirmed it working before release.
Version 1.1.0 adds all three proliferator tiers and passed 103,040 automated assertions, covering individual tiers, preference and fallback, live prototype values, native/expanded station slots, self-spraying, correct item statistics, separate credit balances and version-1 save migration. A synthetic 20,000-assembler workload retained the shared processing budget and allocated zero managed bytes during its measured loop; this is not an in-game FPS measurement. Loki Moon Labs tested the three-tier update in game and confirmed it working before release.
Version 1.0.0 adds budgeted station-stock spraying and passed 102,965 automated assertions, including repeated unsprayed arrivals, expanded slots, all slot modes, real supply consumption, self-spraying Mk.III, overflow bounds and disabled/no-supply behavior. Loki Moon Labs tested this addition in game and confirmed it working before release.
Version 0.1.1 adds mecha refills and the standard Loki Moon Labs icon, and was confirmed working in-game by the author. Its automated fixtures include a 20,000-assembler workload with ongoing mecha refills. Compatibility with every mod combination and FPS improvement over PlanetWormhole are not guaranteed. Nebula multiplayer is unsupported; transfers are disabled if the multiplayer plugin is loaded. Having only the Nebula API installed does not trigger that restriction.
AIO Assembler integration
Quantum Conduit fills AIO Assembler's dedicated ingredient buffers and routes surplus stored materials to recipes on the same planet. AIO reserves ingredients for its own recipes first. Configured AIO outputs remain eligible sources while their storage is empty, and a refill can draw from multiple output grids. With Automatic Spraying enabled, Quantum Conduit also coats stored stacks using available proliferator, even when the stacks have no destination.
Difference from PlanetWormhole
Quantum Conduit is a separate implementation with its own identity, configuration, and save record. It does not import PlanetWormhole's temporary item buffers. Surplus remains in real output or storage inventories; if no destination has room, a machine can eventually block on output, as it does with physical logistics. Provide enough storage for byproducts.
Real item inventories remain part of the normal game save when Quantum Conduit is disabled. Only unused automatic-spray credit belongs to this mod's companion save record.
Building and checking
On Windows, run Build.ps1 or Test.ps1. Both accept -GameDirectory and -ProfileDirectory. They use the local game assemblies, the profile's BepInEx/Harmony/DSPModSave libraries, and the Windows .NET Framework compiler. No game or dependency DLLs are redistributed in the package.
Known mod compatibility
Single-player profile snapshot. Only the mods listed as integrations or checked have mod-specific compatibility evidence.
Supported integrations
- AIO Assembler
- Honey I Shrunk the Factory
- SmartTank
Other enabled mods in the profile
- AdvancedPump, Assembler UI Speed Info, AutoPilotPlus, BepInEx, Better Sphere, BiggerBuildRange, BigTower, BottleneckUI, BUG_UIFix
- Build Back Better, BuildBarTool, BuildToolOpt, Bulldozer, BulletTime, CameraMemory, CatAPI, CatUIPanel, CheatEnabler
- Chinese to English Mod Translator, CloseError, CloserStations, CollectorDeployer, CommonAPI, CompressSave, ControlPanelPlus, CopyPasteStations, CruiseAssistPlus
- DeliverySlotsTweaks, DSP Tech Tree UX Overhaul, DSPAfterburner, DSPAutoSorter, DSPBigMechaStorage, DSPCalculator, DSPCalculatorPlus, DSPCompass, DSPDarkFogIndustry
- DSPModSave, DSPReplicatorPlus, DSPSmartQueue, DSPSphereBuilder, EnableAchievementsFix, EnergyExchangerTweaks, ErrorAnalyzer, Extended Tech Queue, FarZoom
- Fast N Furious, Galactic Scale 2, GasAcceleratorMod, Hand Crafted Trinkets, Icarus Boost, LaserClearing, LDBTool, Logistics Architect, Logistics Capacities
- LogisticsBotsTweaks, LongSorter, LossyCompression, MaxLVLIncrease, MegaRayReceiver, ModFixerOne, MoreMegaStructure, Nebula Multiplayer Mod API, Planetary Resource Architect
- PlanetwideMining, PlanetwidePlanetaryShieldGenerator, PoolTrim, ProliferatorMultiplier, Quantum Conduit, RebindBuildBar, SaveTheWindows, SortByStorage, SphereEditorTools
- SplitterOverBelt, StackingPlus, StacksizeMultiplier, Star System Explorer, Star System Production, StationAssistant, StatsUITweaks, TechHashReduce, UXAssist
- WaterElectrolysis, WorldWidePower
AI Development Disclosure
This mod was developed using AI tools for coding, debugging, tests, and documentation. Loki Moon Labs directs development and is responsible for testing and maintaining the released mod.
CHANGELOG
Changelog
1.2.0
- Pause wireless machine refills when a built input belt feeds the machine directly or through a sorter. Output-only belts still permit wireless refills.
- Honor Honey 0.3.3 doubled 1x input buffers for wireless deliveries.
1.1.9
- Let local machines use available station capacity while vessels are inbound. Incoming drones still reserve space.
1.1.8
- Keep configured AIO outputs eligible as sources while their buffers are empty.
- Refill AIO ingredients from multiple output grids in a routing pass within the work budget.
1.1.7
- Add optional AIO Assembler integration. Fill dedicated ingredient buffers and route stored surplus to other recipes, with local ingredients reserved first.
- Coat AIO storage stack by stack with Automatic Spraying, including same-tier coating of stored proliferator where available.
- Exclude AIO storage from generic hydrogen overflow.
1.1.6
- Add opt-in SmartTank compatibility for beltless hydrogen overflow from multi-output recipes after local demand and storage. Requires SmartTank hydrogen overflow and a full input-enabled hydrogen tank.
1.1.5
- Restore automatic Graviton Lens delivery to empty ray receivers using the game's accepted catalyst list and ion-layer unlock. Preserve lens proliferation on delivery.
1.1.4
- Let surplus hydrogen from production/byproduct recipes fill empty unfiltered box slots and empty input-enabled tanks without belt priming, plus existing compatible storage and hydrogen-assigned stations.
- Initialize a tank's liquid ID only on actual delivery; preserve proliferation, capacities, filters, bans, input/output switches and native station reservations.
- Keep hydrogen storage behind machine demand, including input-only tanks. Preserve interstellar roles and fractionator return-loop isolation.
- Leave surplus in production if every eligible destination is full; do not delete or overfill items.
- Pass 105,629 assertions. In-game confirmation pending.
1.1.3
- Add budgeted direct return of unconverted fractionator input to its own machine, including with AutomaticSpraying disabled.
- Recycle waiting output before taking fresh feed, preserving item counts, spray points and virtual cargo units.
- Reserve unconverted fluid for its originating loop and prioritize fractionator products over competing ordinary production.
- Retain belt-free startup/restart, native conversion rules and output-capacity limits. Do not delete excess hydrogen or deuterium.
- Pass 105,506 assertions, including 600 native-processing/scheduler ticks with conservation and budget checks. Included in the user-confirmed 1.1.3 fractionator update.
1.1.2
- Fix fractionators being skipped while their native input ID is unset, including new unbelted buildings and machines whose buffers emptied.
- Discover eligible unlocked fractionation inputs incrementally and initialize the native recipe only when committing an actual delivery.
- Preserve a remembered product, buffered inventories, native recipe probability/signs, proliferation and configured cargo stacking. Validate cached candidates before use.
- Pass 103,100 assertions, including full-scheduler startup/restart and actual native processing and product collection without belts. Included in the user-confirmed 1.1.3 fractionator update.
1.1.1
- Fix the transfer-time proliferator exclusion: Mk.III can coat Mk.I/Mk.II inputs and Mk.II can coat Mk.I before delivery into machines or storage.
- Restrict proliferator-input payment to higher tiers, avoiding same-stack payment and recursive self-spraying during transfer.
- Preserve existing coating, physical counts, correct consumption statistics and separate tier credit. Station-stock spraying and companion save format remain unchanged.
- Pass 103,084 assertions, including regression cases that failed before the fix. Loki Moon Labs confirmed the fix working in game before release.
1.1.0
- Support Proliferator Mk.I, Mk.II and Mk.III for automatic transfer and station-stock spraying, preferring Mk.III then Mk.II then Mk.I.
- Keep separate per-planet credit for each tier; preserve stronger existing coating, native item-prototype abilities, charge counts and sprayed-proliferator bonuses.
- Record consumption against the actual proliferator item and support self-spraying of all three types.
- Read older companion saves without losing their Mk.III credit. New companion format 2 preserves all three accounts.
- Keep source probing and coating within the existing shared work budget.
- Pass 103,040 automated assertions. Loki Moon Labs confirmed the three-tier update working in game before release.
1.0.0
- Extend AutomaticSpraying to gradually top up PLS/ILS cargo, including stock received by native logistics and existing partially coated items.
- Consume real same-planet Mk.III supplies and saved spray credit; preserve item counts, slot settings and above-target spray points.
- Support coating Mk.III itself without restoring proliferator consumed for payment.
- Share the existing work budget, visit station slots incrementally and cap each visit at 4,096 added spray points.
- Pass 102,965 automated assertions. Loki Moon Labs confirmed the station-spraying update working in game before release.
0.1.1
- Added optional refill-only Icarus logistics slots from current-planet production and storage, enabled by default.
- Respect requested quantities, modified slot capacities, locked/disabled slots, and incoming drone reservations.
- Preserve proliferation and native delivery notifications without directly changing normal inventory or recycling settings.
- Keep mecha work inside the existing processing budget and reset routes on planet/package changes.
- Use the standard Loki Moon Labs artwork for the package icon and include it in source packages.
- Confirmed working in-game by the author before publication.
0.1.0
- Initial independent Quantum Conduit implementation by Loki Moon Labs.
- Direct transfers for production, research, fuel, energy exchangers, fractionators, weapons, storage, logistics stations, warpers, and planet-associated trash.
- Preserve native mixed-stack proliferation and protect integer capacities and logistics reservations.
- Optional Mk.III spraying with saved per-planet credit and current proliferator-effect tables.
- Optional remote Supply-to-Demand interstellar station transfers.
- Incremental discovery, reusable route plans, shared trash indexing, bounded scheduling, and deferred inventory notifications.
- Reset cached routes and spray accounts on save changes; keep physical inventory in the game.
- Prevent simultaneous loading with PlanetWormhole.
- Initial public release; operation confirmed in-game by the author.