SeedRecoveryFix
Automatically recovers stuck seed generation loads without kicking players to menu.
About this mod Author’s original text
README.md
\# SeedRecoveryFix
Automatically recovers stuck seed generation loads without kicking players to the main menu.
SeedRecoveryFix is a lightweight safety mod designed for large modpacks that sometimes get stuck during moon generation.
The mod only activates when needed and stays completely inactive during normal gameplay.
---
\## ✨ Features
\### Smart Watchdog (Only Active When Needed)
\- Arms ONLY when the game logs:
Waiting for all players to load!
\- Automatically disarms when:
- Dungeon generation finishes
- Ship lands
- Menu / ship / company scenes load
- Network session ends
This means \\zero background overhead\\ during normal play.
---
\### Automatic Recovery System
If loading becomes stuck:
1\. Starts a timer
2\. Attempts seed recovery (abort + restart)
3\. If retries fail → safely sends lobby back to orbit
✔ Keeps players in the same lobby
✔ No main menu kick
✔ Host-only logic (safe for multiplayer)
---
\### Minimal Chat Status
Only simple messages appear in chat:
\- Timer started (watching load)
\- Retrying seed generation
\- Going to orbit (recovery fallback)
All detailed info goes to:
BepInEx/LogOutput.log
---
\## 📦 Installation
\### Mod Manager
Just install normally.
\### Manual Installation
BepInEx/
└── plugins/
└── SeedRecoveryFix/
├── SeedRecoveryFix.dll
├── manifest.json
├── icon.png
└── README.md
---
\## ⚙ Configuration
Config is generated after first launch:
BepInEx/config/daltoncurtis.seedrecoveryfix.cfg
\### Main Settings
| Setting | Description |
|---|---|
| WaitForPlayersTimeoutSeconds | Seconds before recovery starts |
| RetryCountBeforeOrbit | Number of retries before orbit fallback |
| OnlyHost | Only host runs recovery logic |
| DisarmScenesCsv | Scenes where watchdog auto-disables |
---
\## 🧠 How It Works
Load starts
↓
Waiting for all players to load!
↓
Watchdog ARMED
↓
Generation finishes → DISARM
OR
Timeout → Recovery attempt
---
\## 🔧 Compatibility
\- Built for heavy modpacks
\- Works with LethalLevelLoader
\- Safe with custom moons \& interiors
\- Does not modify gameplay mechanics
---
\## 🐞 Troubleshooting
Open:
BepInEx/LogOutput.log
Search for:
SeedRecoveryFix
---
\## 📜 Version
Current version: \\1.4.0\\
---
\## 👤 Author
BloodDraco
Install & use Install: BepInEx plugin
- The archive from playbuff is the mod itself — usually a BepInEx plugin (a .dll or a plugin folder once unzipped).
- Recommended: use a community mod manager (such as r2modman) — pick this game, import the mod, and the manager sets up BepInEx and its dependencies for you.
- Manual route: install the BepInEx loader in the game folder, then drop the unzipped .dll or plugin folder into BepInEx/plugins/.
- Launch the game — the BepInEx console logs every plugin it loads; seeing this mod in the log means it is installed.
Mods with listed dependencies need those installed too, or they will not load. Options are usually changed in-game or in the plugin's config file.
Install these first, or the mod will not work: