Samox-Planetary_P2P_Pairing icon

Planetary P2P Pairing

Adds same-planet PLS/ILS point-to-point priority pairing with fallback and dispatch diagnostics.

Last updated 12 hours ago
Total downloads 26
Total rating 1 
Categories Logistics Quality of Life
Dependency string Samox-Planetary_P2P_Pairing-0.3.3
Dependants 0 other packages depend on this package

This mod requires the following mods to function

xiaoye97-BepInEx-5.4.17 icon
xiaoye97-BepInEx

BepInEx5.4.17 mod plugin framework, Mod框架

Preferred version: 5.4.17
CommonAPI-DSPModSave-1.2.2 icon
CommonAPI-DSPModSave

Library that allows to store mod save data separately from vanilla saves

Preferred version: 1.2.2

README

Planetary P2P Pairing

What problem does this mod solve?

Dyson Sphere Program's ordinary local logistics treats every eligible supplier on a planet as an equivalent source. This can cause consumers to import material from general-purpose stations while a nearby byproduct station remains full.

A common example is hydrogen. A fire-ice production line can stall because its byproduct hydrogen storage is full, while a fractionator or deuterium production line simultaneously draws hydrogen from an interstellar import buffer.

Planetary P2P Pairing lets you tell the local drone network which station should be used first. The preferred station is drained before ordinary local suppliers are allowed to provide the remaining deficit.

What does this mod do?

The mod extends the existing Priority Settings > Point-to-Point interface to same-planet logistics.

  • Pair any same-planet PLS or ILS with another PLS or ILS.
  • Prefer the paired station for every item with matching Local Supply and Local Demand settings.
  • Fall back to ordinary local logistics when the paired station cannot provide a valid shipment.
  • Apply the priority regardless of whether the supplier's or demander's drones initiate the trip.
  • Preserve vanilla interplanetary ILS point-to-point, route, and group behavior.
  • Save local pairings through DSPModSave.

Pairings are bidirectional for priority purposes and station-wide rather than per-item. A pair affects only items for which one endpoint is explicitly configured as Local Supply and the other as Local Demand. Remote Supply, Remote Demand, and Storage settings are not treated as local supply or demand.

Configuring a local pair

  1. Give both stations names.
  2. Open either station and select Priority Settings.
  3. Under Point-to-Point, select Configure.
  4. Search for the other station by name and select Add.

A PLS search contains only named PLS and ILS stations on the current planet. An ILS search also retains vanilla remote ILS candidates. Local pairing rows display the paired station's building icon to distinguish PLS and ILS endpoints.

Dispatch Log

Every PLS and ILS window includes a Dispatch Log button beside the Control Panel button. The side panel records recent departures involving the selected station and shows:

  • In-game dispatch time
  • Drone or vessel
  • Source and destination
  • Item and scheduled amount
  • Scheduler reason: local, local P2P, remote P2P, planet route, star route, group, or remote fallback

The log is intended for diagnostics. It uses a bounded 512-entry in-memory history, shows the newest matching entries first, and is cleared when a save is loaded or changed. It is not written to the save file.

Is it compatible with Nebula Multiplayer?

No. Planetary P2P Pairing is currently single-player only.

Its custom pair data and local dispatch filtering are not synchronized between Nebula peers. The mod also does not currently detect Nebula or disable itself automatically. Do not enable it in a Nebula multiplayer profile; doing so may cause logistics behavior to diverge between host and clients.

Installation

Required dependencies:

  • BepInEx 5 for Dyson Sphere Program
  • CommonAPI-DSPModSave

When installing manually, place PlanetaryP2PPairing.dll in:

BepInEx/plugins/PlanetaryP2PPairing/

Launch the game through the mod manager's Start modded option. BepInEx should report Planetary P2P Pairing 0.3.3 during startup.

Compatibility and tested version

  • Mod version: 0.3.3
  • Tested DSP version: 0.10.34.28529
  • Existing vanilla remote ILS P2P routes, interplanetary routes, and groups remain available.
  • Removing the mod does not make the vanilla save unloadable; saved local pairs simply stop affecting logistics.

Back up important saves before testing any mod release.

Current limitations

  • Local point-to-point priority only; no local groups or local routes.
  • Pairing is station-wide, not per-item.
  • No exclusive mode: ordinary local logistics is used as fallback.
  • Both endpoints must be named to locate them through the pairing search.
  • The Dispatch Log covers departures recorded during the current loaded session only.

Troubleshooting

Check BepInEx/LogOutput.log and confirm that the expected version loaded. Search for:

Planetary P2P Pairing
samox.dsp.local-priority-pairing

When validating priority behavior, allow previously dispatched drones to finish first. Orders created before a pairing was added or changed remain in flight.