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