PlanetwideGeneratorSupply

Your power plants never run dry - the whole planet feeds them for you.

Version: 1.0.0 Game: Dyson Sphere Program 0.10.x (built against 0.10.34) Loader: BepInEx 5.4.17+

For anyone tired of belting coal or fuel rods to every thermal plant, fusion reactor, and artificial star. This mod tops them up straight from your logistics network.

What it does

Every fuel-burning power generator on a planet is topped up from that planet's logistics stations (ILS/PLS) - no belts, no manual runs. Fuel is drawn from real station stock, so it isn't free: a station has to actually hold the fuel for it to be used.

Covers thermal power plants, mini fusion power plants, and artificial stars. Solar, wind, geothermal, and ray receivers are untouched.

Features

Auto-refill thermal plants with chemical fuels (coal, plant fuel, etc.).
Auto-refill mini fusion plants with deuterium fuel rods.
Auto-refill artificial stars with antimatter fuel rods.
Consume model - fuel comes from real station stock, not thin air.
Planetwide by default - or set a limited radius to pull only from nearby stations.
Highest-tier fuel preference - empty chambers fill with the best fuel you have in stock (toggleable).
Nearest-station-first sourcing so the closest depot is drained first.
Cheap - a throttled scan (not every tick), so it stays light on UPS.
Config-only - no in-game UI; every setting lives in the BepInEx config file.

Installation

Via r2modman / Thunderstore Mod Manager (recommended):

Install r2modman or the Thunderstore Mod Manager.
Search "Dyson Sphere Program" and set up a profile.
Search "PlanetwideGeneratorSupply" in the Online tab and install.
Launch the game through the mod manager.

Manual install:

Install BepInEx 5 for Dyson Sphere Program.
Download the latest PlanetwideGeneratorSupply-<version>.zip from the Releases page.
Extract the ZIP into your Dyson Sphere Program folder so the plugins\ path lands inside BepInEx\plugins\.
Launch the game once. BepInEx creates BepInEx\config\com.zicarius.PlanetwideGeneratorSupply.cfg with the defaults.
(Optional) Edit that .cfg to taste - with the game closed, then relaunch.

Before you install

This is a BepInEx plugin - it patches the game's code at runtime using Harmony patches.

Only download from sources you trust. Only this mod's Thunderstore page or the GitHub repo - treat re-uploads elsewhere as unsafe.
Game updates can break it. A DSP update may stop this mod from working until a compatibility update is released.
Save-safe by design. This mod stores nothing in your save. It only tops up existing generator fuel from existing station stock while you play. Remove it any time and your save stays vanilla - your plants simply stop auto-refilling.

Configuration

All settings live in the BepInEx config file - there is no in-game settings window. Edit it with the game closed, then relaunch (config is read at launch).

Setting	Default	Description
`General > Enabled`	`true`	Master switch. Off = fully inert.
`General > SupplyThermal`	`true`	Auto-refill thermal power plants.
`General > SupplyFusion`	`true`	Auto-refill mini fusion power plants.
`General > SupplyArtificialStar`	`true`	Auto-refill artificial stars.
`General > PreferHighestFuelTier`	`true`	Fill empty chambers with the highest available fuel tier (`false` = cheapest).
`General > SupplyRadius`	`0`	Max distance (world units) from a generator to a station. `0` = planetwide (recommended).
`General > NearestStationFirst`	`true`	Drain the closest eligible station first.
`General > RefillIntervalTicks`	`60`	Ticks between refill scans (~60 = 1s). Higher = cheaper.
`Advanced > RequireStationSupplyFlag`	`false`	If `true`, only pull from station slots set to Supply.
`Advanced > VerboseScan`	`false`	With `DebugLog` on, logs a periodic scan heartbeat (and nearest-station distance for sizing `SupplyRadius`).
`Advanced > ThermalFuelPriority`	(empty)	Comma-separated item names (English, e.g. `Graphite, Coal, Wood`), tried in order for Thermal Power Plants only. Falls back to the highest available tier when empty or when none of these have stock.
`Advanced > ExcludeProliferatorFuel`	`true`	If `true`, Thermal Power Plants never burn Proliferator Mk.I/II/III, whether via `ThermalFuelPriority` or the fallback search.
`Advanced > SkipInserterFedGenerators`	`true`	If `true`, a generator that already has a sorter/inserter delivering fuel to it is left alone - only generators with no inserter connection at all get auto-refilled.
`Diagnostics > DebugLog`	`false`	Verbose logging to the BepInEx console. Off by default.

(Full reference: the .cfg file BepInEx writes on first run.)

Compatibility

Game version: DSP 0.10.x (built against 0.10.34).
Other mods: Pairs naturally with PlanetwideAmmoSupply (same logistics-pull pattern) and EndlessResources (keeps veins full so fuel production stays easy). No known conflicts.
Multiplayer: built for singleplayer; untested in Nebula multiplayer.

Troubleshooting

Mod doesn't load:

Ensure the file is in BepInEx\plugins\PlanetwideGeneratorSupply\ (not Mods\).
Check BepInEx\LogOutput.log for errors near Loading [PlanetwideGeneratorSupply].

Generators aren't refilling:

The fuel has to exist in a logistics station on the same planet.
If you set SupplyRadius to a small number, widen it or set it to 0 (planetwide).
By design, a generator already fed by a sorter/inserter is left alone (see SkipInserterFedGenerators) - that's not a bug, it's meant as a passive backup for generators with no dedicated fuel line.
Turn on DebugLog and VerboseScan to see the heartbeat, including nearestStation= (how far your closest supplying station actually is).
Config edits only take effect on relaunch - change the .cfg with the game closed.

License

MIT. See LICENSE for the full text.

Support

All my mods are free and always will be. If this one made your playthrough better and you feel like buying me a coffee, that keeps me motivated to maintain these mods and build new ones: https://ko-fi.com/zicarius

KEEP THE LIGHTS ON.