Instance Actions

Instance actions run from YAML actions arrays after a rule's conditions match. An action table may contain multiple fields; SSS executes those fields in a fixed priority order rather than YAML key order. See action execution order.

Choose a reference

Common rule shape

instances:
  - conditions:
      - record_id: mudcrab
    actions:
      - chance: 0.25
        create:
          mudcrab:
            count: 2
            position:
              x: { min: -100, max: 100 }

chance belongs to an action block, not to a condition. It rolls independently each time that action block is reached. Per-entry or per-pool chance is documented with the relevant action. For rule persistence, once: true saves a successful rule application for the object; once: per_cell tracks it only for the current SSS activation batch; omitted once permits later activations. A failed or no-op action does not generally establish a successful rule application, except where a dependency caveat is called out.