[BETA] Custom Spawns API (Stable Fork)
This mod is a stabilized fork of Custom Spawns API.
For details about the Custom Spawns API itself, please refer to the original page linked above.
This version fixes several known issues that can cause crashes or disrupt gameplay:
- Unhandled exceptions in event handlers that could crash the game during map ticks
- Null reference errors in spawn, dialogue, and AI systems
- Dialogue priority conflict (reduced from max value to 200)
- Missing null guards in party spawn factories
- Modal error popups appearing for non-critical issues (e.g., reward schema not configured)
All critical code paths are now wrapped with exception safety — if an error occurs, it is logged as an in-game message instead of crashing.
- Compatible with all existing Custom Spawns sub-mods (e.g., Fringes of Chaos, Calradia at War). The XML format is unchanged.
- Do NOT enable both this mod and the original Custom Spawns API at the same time! They share the same namespace and will conflict, causing crashes.
- Supported game version: v1.3.14
Sub-mods that depend on Custom Spawns API list the original module ID in their SubModule.xml. You need to change this to point to this fork instead.
Example using Fringes of Chaos:
- Install this mod and the sub-mod (e.g., Fringes of Chaos).
- Open the sub-mod’s installation folder.
- Open its SubModule.xml in a text editor.
- Find all occurrences of CustomSpawns in both the DependedModules and DependedModuleMetadatas sections, and replace them with CustomSpawnsStable.
- In the launcher, make sure the original Custom Spawns API is disabled, and both this mod and your sub-mod are enabled.
- Load order: Harmony → Native → SandBoxCore → Sandbox → CustomSpawnsStable → Sub-mods (e.g., FringesofChaos)
If you experience crashes or issues caused by this mod, please leave a comment below or start a discussion thread.
This mod is released under the GPL-3.0 license, the same as the original Custom Spawns API.
Source code: GitHub[github.com]
