CritterSpawn Congestion Fix

Overview

This is a light weight rewrite of the CritterSpawn script and its fishing equivalent, ccBGSSSE001_CritterSpawn.

Its primary objective is to maintain the simple distributed implementation of the vanilla critter spawning system for maximum compatibility while minimising the time spawner scripts spend lingering in the engine.

It prioritises fast frequent light calls, minimal state and a preference for graceful safe exits.

It also introduces dynamic critter respawns that do not require cell reloads, these respawns are capped and throttled dynamically in time responding to player behaviour.

Technical Implementation

The script replaces continuous wait() loops triggered on cell attach with evaluated RegisterForSingleUpdate calls.

The evaluation checks for distance, player direction, time, weather in an order prioritising the lightest and most likely to fail condition for a lighter triage.

Updates are registered with randomised jitter delay to spread out the load upon cell attachment; distant cells without loaded 3D receive an additional delay rather than shutting down. Caching is used to reduce redundant lookups and fetches.

The script only runs while a marker is loaded, it doesn't keep a persistent state or run in remote cells, and it prefers immediate safe termination when unloaded, after being suspended, or if it detects any spawner record anomaly.

Aggressive internal safeguards are implemented to prevent runaway spawner loops caused by lingering vanilla instances when installed mid game.

Dynamic Respawns

The vanilla implementation doesn't allow spawners to reset except after a cell reload. I always found this can leave a landscape barren when my character was camping in the wilds.

The respawn feature in this mod responds to critters dying or being caught, slowly replenishing over time with increasing delay responding to player behaviour.

Respawns have Hard and Soft caps:

[]The hard cap: Determined on load based on the 10x maximum concurrent critters specified by the level designer (e.g., A marker set to 5 concurrent spawns will deplete and cease functioning after 50 total spawns). Spawners reset entirely upon cell reload.[/]

[]The soft cap: Based on increasing delays, Following a critter death, the respawn schedule is postponed by an incrementing delay relative to the total number of critters caught. Respawn Batches only produce a single spawn per cooldown: Catching 10 bugs or 6 fish increases each subsequent respawn delay by 1 minute.[/]