Chance

saturn:chance

Decides whether the action fires based on a given chance.

The context contains an actor (the initiator) and a target. The same ID may have different fields in the entity action and bi-entity action registries; the two kinds are not interchangeable.

JSON fields

Field	Type	Required	Default	Description
type	Resource ID	yes	—	saturn:chance
action	Bi-entity action	yes	—	The sub-action to run; its kind must match what this field expects.
chance	Number	yes	—	Hit chance; 0 never fires, 1 always fires. Codec range: 0.0F, 1.0F.
fail_action	Bi-entity action	no	{"type":"saturn:no_op"}	Action to run when the chance check fails.

JSON example

{
  "type": "saturn:chance",
  "action": {
    "type": "saturn:no_op"
  },
  "chance": 1
}

This is a value to embed in the corresponding field, not a standalone loadable data pack file. The example: references in the examples must be replaced with defined entries.

Java entry point

com.iafenvoy.saturn.data.action.builtin.bientity.meta.ChanceAction. This page is based on the Codec in the current 26.1.2 source.