Static Switching System (SSS) is a declarative world-patching framework for OpenMW. It replaces static meshes or matches active objects and applies object, inventory, actor, world-state, and scripting actions from YAML.
SSS has two module types: static and instance. Pick one. They are separate pipelines and do not compose. Start with Getting Started, then use Concepts for dispatch, ordering, ranges, and persistence.
Documentation map
- Getting Started — install SSS, place modules where the VFS can discover them, and make a first change.
- Concepts — the two pipelines, matching and priority, persistence, edge cases, and diagnostics.
- API Reference — the YAML format, schema, settings, lifecycle, and the advanced
StaticSwitcher_Ginterface. - Recipes — copyable patterns built from the shipped examples, plus lessons from released static modules.
- Experiments and Oddities — executable documentation for combinations that are useful, cursed, or both.
- Compatibility and Troubleshooting — VFS, optional dependencies, save updates, and runtime diagnosis.
The shipped YAML examples are source fixtures. They document real module shapes and are intended to be copied or adapted into the discovered VFS data directory; the examples directory itself is not scanned as a module directory.
Getting Started
Install Static Switching System and author your first YAML module.
Static Switching System Recipes
Copyable YAML patterns for static replacement and instance rules.
Compatibility and Troubleshooting
Keep SSS modules, saves, VFS paths, and optional integrations predictable.
Experiments and Oddities
Executable SSS documentation for useful, strange, and deliberately excessive module combinations.
Concepts
The execution model behind SSS YAML modules.
API Reference
The Static Switching System YAML and advanced OpenMW-Lua integration contract.