DSP Custom Fast Start

DSP_CustomFastStart is a Dyson Sphere Program plugin that applies your configured fast-start rewards exactly once when a new game starts.

What It Does

• Unlock configured technologies at game start.
• Grant configured items at game start.
• Supports separate configs for combat and non-combat mode.
• Can clear the starter package before granting items.
• Forced safety behavior: does not run when loading existing saves.

Important Behavior

• Trigger timing: very early game frames after entering a new save.
• Run count: once per game start session.
• Save-load rule: loading an old save will skip fast start.

Config

Config file is generated by BepInEx after first launch.

• General.EnableFastStart
• General.ClearPackageBeforeGrantItems
• Combat.TechIds / NonCombat.TechIds
• Combat.Items / NonCombat.Items

Format Rules

• Tech list format: techId1;techId2;techId3
• Item list format: itemId(:count);itemId2(:count2)
• count is optional. Default is 1.
• Invalid IDs or malformed segments are skipped with log warnings.

Example

[Combat]
TechIds = 1001;1002;1124
Items = 2003:300;2318:50;1131:1000

[NonCombat]
TechIds = 1001;1002
Items = 2003:200;2301:40;2901:20

Default Config Values (Current)

The plugin ships with the following default values from code:

• General.EnableFastStart = true
• General.ClearPackageBeforeGrantItems = true
• Combat.TechIds = "" (empty, no tech unlock by default)
• NonCombat.TechIds = "" (empty, no tech unlock by default)

Default Combat Items

Combat.Items = 2003:300;2318:50;2316:30;2319:50;2210:20;2902:20;2202:100;2201:100;2212:30;1210:100;1131:1000;2014:200;2020:50;1804:50;2307:20;2308:20;2317:30;2310:20;2103:10;2104:10;2105:10;3008:20;3007:20;3009:20;3002:50

Default Non-Combat Items

NonCombat.Items = 2003:300;2318:50;2316:30;2319:50;2210:20;2902:20;2202:100;2201:100;2212:30;1210:100;1131:1000;2014:200;2020:50;1804:50;2307:20;2308:20;2317:30;2310:20;2103:10;2104:10;2105:10

Installation

Mod Manager

• Install with Thunderstore App / r2modman.
• Launch game once to generate config.
• Edit config and start a new save.

Manual

1. Install xiaoye97-BepInEx (5.4.17+).
2. Copy DSP_CustomFastStart.dll to Dyson Sphere Program/BepInEx/plugins/.
3. Launch game once, edit generated config, then start a new save.

Compatibility

• Game target: DSP 0.10.34.x (net472 build).
• Framework: BepInEx 5.
• Should be compatible with most content mods unless they heavily rewrite early game init.

ID References

• Item IDs: Item-Ids.md
• Tech IDs: Tech-Ids.md

Troubleshooting

• No effect after editing config:
  • Ensure General.EnableFastStart = true.
  • Ensure you started a new game, not loaded an old save.
  • Check BepInEx log for parse warnings.
• Only part of config worked:
  • Some IDs may be invalid for your game/mod setup.
  • Keep strict separators: ; between entries, : between itemId and count.

References

• Generated with Codex vibe coding.
• Fast-start logic reference: https://thunderstore.io/c/dyson-sphere-program/p/ckcz123/TheyComeFromVoid/
• Project structure and coding style reference: https://thunderstore.io/c/dyson-sphere-program/p/Shad0wlife/AssemblerUI/
• Plugin documentation style reference: https://thunderstore.io/c/dyson-sphere-program/p/jinxOAO/MoreMegaStructure/