Random Chance (Meta Action Type)

Rolls once and runs action if the roll succeeds, or fail_action if it fails. It works in every kind of action (entity, bi-entity, block and item), with the same fields in all of them.

Type ID: apoli:random_chance (alias apoli:chance)

Fields

Field	Type	Default	Description
`chance`	Float or Expression	required	The probability of success, from `0.0` to `1.0`. `0.25` is a one-in-four chance.
`action`	Action type	required	Runs when the roll succeeds. It is the same kind of action as the one containing it.
`fail_action`	Action type	optional	Runs when the roll fails.

Examples

A one-in-ten chance to drop something extra when you break a block:

{
  "type": "apoli:action_on_block_break",
  "block_action": {
    "type": "apoli:random_chance",
    "chance": 0.1,
    "action": {
      "type": "apoli:spawn_entity",
      "entity_type": "minecraft:item"
    }
  }
}

Both outcomes written out, which reads better than leaving the failure implicit:

{
  "type": "apoli:random_chance",
  "chance": 0.3,
  "action":      { "type": "apoli:heal", "amount": 4 },
  "fail_action": { "type": "apoli:exhaust", "amount": 1.0 }
}

Because chance takes an expression, the odds can depend on state. Here they are likelier the more of a resource you have:

{
  "type": "apoli:random_chance",
  "chance": "mypack:luck / 10",
  "action": { "type": "apoli:apply_effect", "effect": { "effect": "minecraft:hero_of_the_village", "duration": 200 } }
}

note

The roll happens once each time the action runs. To roll separately for several things, use several apoli:random_chance blocks instead of one wrapping an apoli:and.