
QuantumConduit
Automatic planetary logistics and mecha slot refills with proliferation preservation, budgeted processing, energy exchanger support, and optional interstellar transfers. By Loki Moon Labs.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.2.0 · 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.
Machines with a built input belt receive their inputs through that belt, including belts feeding through a sorter. Quantum Conduit resumes refilling when the last input belt is disconnected. Output-only belts still allow wireless input, and Quantum Conduit can still collect products from belt-fed machines. Fractionators with an input belt use physical belts for unconverted-fluid recirculation.
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. Local machines can fill available station space while vessels are inbound, with space still reserved for drones. Arriving vessels unload their full cargo, which can temporarily put a slot above its configured limit. 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. Transfers preserve proliferation and respect configured storage capacities.
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, 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.