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
### Thunderstore 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
