SSS's public authoring contract is YAML. These pages explain the execution model:
- Pipelines and Module Boundaries explains why static and instance modules are separate.
- Matching, Priority, and Action Order explains VFS discovery order, priority tiers, conditions, chance, and actions.
- Ranges distinguishes comparison bounds from sampled action ranges.
- Persistence and Once Semantics explains
once,per_cell, replacement chains, and saves. - Behavioral Edge Cases collects dispatch, ordering, target, persistence, and value traps.
- Validation and Debugging explains schema checks, runtime warnings, and the debug log.
For field-by-field syntax, use the Module Format and Schema pages.
Pipelines and Module Boundaries
How SSS dispatches static replacement and instance rule modules.
Matching, Priority, and Action Order
Deterministic SSS module order, condition matching, chance rolls, and action sequencing.
Comparison and Random Ranges
Use min and max correctly in SSS conditions and sampled actions.
Persistence and Once Semantics
Understand what SSS stores and when instance rules are re-applied.
Validation and Debugging
Validate YAML before loading and use SSS's runtime diagnostics without relying on internals.
Behavioral Edge Cases
The SSS behaviors most likely to surprise an otherwise valid module.