"This was created with care, but not by me alone. I wanted to solve annoyances I personally had while enjoying my current favorite game. This code was generated by Gemini. I have not screened it. I am no developer. Please enjoy it with a grain of salt."

Stellogistics

Stop hunting through dozens of individual ILS towers to figure out why your factory stalled.

Stellogistics is a quality-of-life mod for Dyson Sphere Program (BepInEx 5) that adds an interactive, customizable Interstellar Logistics Overview Panel directly onto the Starmap. Instead of inspecting Interplanetary Logistics Stations (ILS) one by one, Stellogistics aggregates every remote supply and demand slot across an entire Planet or Star System into a single, combined Exports and Imports dashboard.

• Source Code: https://github.com/BaCheetah/Stellogistics

Why Stellogistics? (The Problem It Solves)

In mid-to-late game Dyson Sphere Program, a single star system can easily host 20–60+ Interplanetary Logistics Stations and dozens of Orbital Collectors across multiple planets. When a production chain slows down across the cluster:

• You don't want to click through 50 individual towers just to find out whether a planet is exporting or importing an item.
• You need to know immediately if a mining/smelting outpost has run dry (EMPTY 0%) or if a factory world is starved for inputs (STARVED 0%).
• You want to filter out noisy items (like ubiquitous building malls or warpers) on specific worlds while keeping them visible on others.

Stellogistics gives you that macro-level visibility right from the Starmap—whether you're hovering over distant stars or inspecting a specific planet.

Key Features

1. Combined Planet & Star System Logistics

• One Row Per Item: Combines all Remote Supply (Exports) and Remote Demand (Imports) slots for the same item across the selected Planet or Star System.
• Complete Capacity & Hatched +In-Transit Breakdown: Shows Stored / Max capacity, fill percentage, a diagonal hatched bar extension for inbound vessel cargo (+In-Transit), number of planets involved, and total station slots (ILS + Gas Giant Orbital Collectors OC).
• Fleet & Warper Readiness: Header displays total ILS & Orbital Collector counts, idle vs. total Logistics Vessels, and available Space Warpers.

2. Galaxy Item & Bottleneck Finder (Finder)

• Cluster-Wide Search & Bottleneck Scanner: Locate every planet exporting or importing checked items across the entire star cluster, or use the Exclude >40% (Healthy) filter in Filter ▾ to scan all checked items for shortages (EMPTY, STARVED, LOW).
• Click-to-Focus & Starmap Pin: Click any planet row in the Finder to automatically focus that planet on the Starmap and set your yellow navigation indicator line. Click any item row to drill down to that item, and use ← All to return to your Finder overview.
• Inline Item Dismiss (✕) & Planet Ignore Filter: Hover any row in the Planet/Star overview or Finder to reveal the slide-in ✕ button and uncheck that item in the Picker, or exclude entire planets/star systems via the Planets tab in the Picker or Filter ▾.

3. Instant Bottleneck, Throughput & Hub Detection

• Color-Coded Health Bars & Badges:
  • Red (EMPTY / STARVED / LOW, ≤15%): Critical bottleneck—an export source has run out of stock to ship, or an import destination is starved.
  • Orange (LOW, ≤40%): Stock is depleting and approaching a shortage.
  • Green (>40%): Healthy buffer.
• Logistics / Vessel Throughput Bottleneck Indicator (⚡+ILS):
  • Automatically flags importing planets (⚡+ILS) whose storage + inbound vessels (+In-Transit hatched bar) do not fill capacity while healthy/unclaimed export stock is sitting ready on another planet in the cluster—telling you immediately when you need another importing ILS tower or more vessels rather than more production.
• Planet & System Hub Detection (⇄ Hub):
  • Automatically detects planets that both import and export the same item and displays a ⇄ Hub (Imp ...) / ⇄ Hub (Exp ...) badge with the counterpart capacity right on the row.
• Section Header Alert Counters: Even when the Exports or Imports sections are collapsed, the header displays instant alert tallies (e.g., 2 EMPTY • 1 LOW).
• One-Click Sorting (Sort: Alert / Sort: ID / Sort: Pct ↓): Sort ascending by fill percentage (Alert), by item ID, or descending by fill percentage (Pct ↓).

4. Smart Star System Trade Modes

When viewing a whole Star System, cycle between three aggregation modes:

• Ext Only (Interstellar Smart): Automatically hides purely local intra-system shuttling (e.g. Planet A mining ore for Planet B's smelters inside the same system, or stations limited to < 1 LY range) so you only see true interstellar imports and exports.
• Netted (Net Intra-System): Nets internal star system supply against internal demand.
• All Slots: Displays every remote supply and demand slot across all planets in the system.

5. Unified Item, Building & Planet Picker (Filter ▾ → Custom Picker)

• 6 Quick Category Checkboxes & Threshold Filter: Quickly toggle item categories or hide full/tapped/healthy storages (≥90% / 100% / >40%) across both normal Starmap views and the Galaxy Finder.
• Unified 14 × 8 Picker (Items, Buildings, Planets):
  • One identical, spoiler-free picker window across both Starmap filtering and the Galaxy Finder, with ✓ Check All and ✕ Uncheck All controls and clear visual contrast between active and dimmed items.

6. Flexible Window Management & Options ▾

• Dedicated Options ▾ Menu: Toggle the hatched +In-Transit bar, Gas Giant Orbital Collectors (OC), Starmap hover behavior, choose a Task Manager-style Refresh Rate (Fast, Medium, Slow, Paused), or reset UI position and size.
• Freely Draggable & Resizable (◢):
  • Supports custom heights (including intentional empty space without snapping back), responsive two-row header button stacking at narrow widths, and multi-stage drag collapsing into a compact Stellogistics taskbar tab.

Configuration

A configuration file is generated at BepInEx/config/com.stellogistics.dsp.cfg after first launch, storing your custom panel layout, thresholds, and saved per-star/per-planet filters.

Source Code & How to Compile Yourself

The full source code is openly available at: https://github.com/BaCheetah/Stellogistics

If you prefer to inspect the code and compile the .dll yourself rather than using a prebuilt binary, you don't even need Dyson Sphere Program installed on the build machine—all game and BepInEx reference assemblies are fetched automatically via NuGet.

Prerequisites

1. Install the .NET SDK (any modern version such as .NET 6, 8, or newer).

Step-by-Step Build Instructions

1. Clone or download the repository:

   git clone https://github.com/BaCheetah/Stellogistics.git
   cd Stellogistics
   

   (Or click Code → Download ZIP on https://github.com/BaCheetah/Stellogistics and extract it to a folder.)

2. Build the project in Release mode:

   dotnet build -c Release
   

   This restores the required NuGet reference packages (from nuget.org and nuget.bepinex.dev), compiles Stellogistics.dll, and packages everything automatically.

3. Locate the compiled output:

   • Compiled Plugin DLL: bin/Release/net472/Stellogistics.dll
   • Thunderstore-Ready Folder: dist/package/
   • Thunderstore Mod Manager ZIP: dist/Stellogistics-2.1.3.zip

4. Install manually:

   • Copy Stellogistics.dll into your BepInEx/plugins/Stellogistics/ folder (or import dist/Stellogistics-2.1.3.zip as a local mod in Thunderstore Mod Manager / r2modman).

Changelog

2.1.4

• Disable auto-save per resize frame, make Finder single-item focus transient, add EExcludeMode & TTL caches, remove dead code, and split UIStarmapLogisticsPanel into partial classes.

2.1.3

• Hover-Animated ✕ Item-Hide Button:
  • Clicking ✕ on any row (both in the Galaxy Finder and in the Planet / Star System overview) now unchecks that specific item in the Picker instead of ignoring the entire planet.
  • The ✕ button stays completely hidden at rest and smoothly slides in from the right (while shifting the amount text left) only when the corresponding row is hovered.
• Improved Readability on Hatched +In-Transit Bars:
  • Subdued the brightness and opacity of the diagonal hatched +In-Transit bar, lightened critical/warning/healthy status text colors for higher luminance contrast, and added a subtle 1px dark drop shadow to row texts so fully saturated in-transit bars remain crisp and readable.
• Fixed Starmap Hover Mode & Defaulted to Disabled:
  • Fixed Show Panel on Starmap Hover (Options ▾) so hovering over planets or stars in the Starmap takes precedence over an already-focused planet/star while enabled, and changed its default setting to false (disabled).
• Streamlined Finder & Auto-Closing Dropdowns:
  • Entering Finder no longer auto-opens the Item Picker window, and removed the redundant Pick Item header button in Finder (access the Picker uniformly via Filter ▾ → Custom Picker).
  • Filter ▾ and Options ▾ dropdown menus now automatically collapse whenever you click anywhere else in the UI or Starmap.

2.1.2

• Unified Picker & Improved Deselected Item Visibility:
  • Increased the brightness and opacity of deselected (hidden) item icons in the Picker so dimmed icons remain clearly recognizable while keeping a strong visual contrast against selected (shown) items.
  • Removed the redundant ! ≤40% Only button from the Picker so the Picker toolbar is 100% identical in all modes and the Exclude threshold setting in Filter ▾ (≥90% / 100% / >40%) governs both normal Starmap views and the Galaxy Finder uniformly.

2.1.1

• Task Manager-Style Refresh Rate Control (Options ▾):
  • Added a 4-mode Refresh Rate selector in Options ▾: Fast (0.10s), Medium (0.25s, Default), Slow (1.00s), and Paused (⏸ Paused, freezing periodic updates so rows stay still while inspecting).

2.1.0

• Planet & Star System Hub Detection (⇄ Hub):
  • Automatically detects when a planet (or star system) both exports and imports the same item, displaying a cyan ⇄ Hub (Imp ...) / ⇄ Hub (Exp ...) badge with the counterpart capacity on both rows (even if one side is hidden by filters).
• Logistics / Throughput Bottleneck Indicator (⚡+ILS):
  • Automatically flags importing entries with ⚡+ILS when their storage is STARVED or LOW and current stock plus inbound vessels (+In-Transit hatched bar) does not fill capacity (< 85%) while another non-ignored planet in the galaxy has healthy/unclaimed export stock ready for pickup.
• UI, Header & Scrollbar Polish:
  • Enforced the vertical scrollbar as the true right boundary of the list and anchored fill/transit bars via normalized RectTransform anchors so rows never bleed behind or to the right of the scrollbar during resizing.
  • Made the inline Finder [✕] planet-ignore button subtle and unobtrusive at rest, lighting up only when hovered.
  • Improved header button row spacing, responsive stacking thresholds, and top-left collapse button margins.

2.0.1

• Fixed Taskbar Tab Drag-to-Collapse Flicker: Prevented ApplyHeaderLayout from transiently applying the expanded/stacked header height while dragging the resize grip in or above the collapsed Taskbar Tab state.

2.0.0

• Galaxy Item & Bottleneck Finder (Finder):
  • Locate every planet across the entire star cluster that exports or imports any selected item(s), or scan for all active bottlenecks (! ≤40% Only) in one view.
  • Click-to-Focus & Navigation Pin: Clicking any planet row in the Finder centers and focuses that planet on the Starmap and pins the player's navigation guidance line (indicatorAstroId) to it.
  • One-Click Drill-Down & ← All Return: Click any item row in normal or Finder view to isolate that single item across the galaxy, and click ← All to jump right back to your previous Finder overview.
• Planet & Star System Ignore Filter:
  • Mute abandoned or starter planets/systems in the Finder using the inline [✕] button on Finder rows, the Ignore Planet/Star System in Finder toggle in Filter ▾, or the dedicated Planets tab inside the Picker (✓ Show All Planets to clear).
• Unified Item, Building & Planet Picker:
  • Merged the Finder and Filter item pickers into a single unified window (Items, Buildings, and Planets tabs) with ✓ Check All, ✕ Uncheck All, and ! ≤40% Only controls.
• Hatched +In-Transit Capacity Bar & Options ▾ Menu:
  • Added a diagonal hatched bar extension showing inbound vessel cargo (+In-Transit) relative to station capacity.
  • Added a dedicated Options ▾ menu (Show +In-Transit Bar, Include Orbital Collectors, Show Panel on Starmap Hover, and Reset UI Position & Size).
• UI & Resizer Polish:
  • Responsive two-row stacked header buttons when the panel is resized narrow (< 385px).
  • Resizing the panel now preserves custom panel height ("dead space") without snapping back when few rows are displayed, and aligns the lower-right resize grip (◢) flush with the panel corner.

1.1.0

• Global Starmap Filters: Changed category and custom item filters to persist globally across the entire Starmap instead of resetting per planet/star system, making it easy to search for specific items (e.g., Photon Combiners) across all stars and planets.
• Exclude Full / Freshly-Tapped Storages Filter: Added a toggleable filter in Filter ▾ to hide full or freshly-tapped storages, with a cyclable threshold button (≥90% Tapped, 100% Full, or >40% Healthy).
• Improved Percentage Sorting & Display:
  • Sort: Alert now sorts strictly ascending by fill percentage (0% → 100%).
  • Sort: Pct ↓ sorts strictly descending by fill percentage (100% → 0%).
  • Non-full storages (StoredCount < MaxCount) no longer round up to 100% (clamped to 99% until completely full).

1.0.0

• Official v1.0.0 release of Stellogistics!
• Added combined Starmap logistics panel for Planet and Star System imports and exports.
• Added shortage color coding (Critical/Empty, Warning/Low, Healthy) and automatic shortage-first sorting.
• Added smart interstellar filtering for Star System views (Ext Only, Netted, All Slots).
• Added Gas Giant Orbital Collector (OC) aggregation support.
• Added freely draggable, resizable, and collapsible UI with a compact Stellogistics taskbar tab mode and multi-stage drag-to-collapse/expand behavior.
• Added per-Star System and per-Planet saved item filters, including 6 broad Category Checkboxes and a spoiler-free 14 × 8 Custom Item & Building Picker with Check All and Uncheck All controls.
• Automatically blocks Starmap camera zoom while scrolling or interacting with the Stellogistics UI.