Script (Block Action Type)

Runs a script against a block position. event.pos is the position and event.level is the world, and there is no entity.

Type ID: apoli:script

Fields

Field	Type	Default	Description
`script`	Identifier	required	The script to run. Either an ID registered from KubeJS with `ApoliEvents`, or the path of a `.js` file shipped in a data pack at `data/<namespace>/apoli/scripts/<path>.js`, in which case the `.js` is part of the ID.
`params`	NBT	optional	Values handed to the script. Read them with `event.params` from KubeJS, or `params` inside a data pack script. This is how one script serves several powers.

Example

Turn the block above into whatever params names, but only if that block is air. That kind of check reads badly as nested block conditions. The script goes in kubejs/server_scripts/gardener.js:

kubejs/server_scripts/gardener.js

ApoliEvents.blockAction('gardener:sprout', event => {
  const above = event.pos.above()
  if (!event.level.getBlock(above).isAir()) return
  event.level.getBlock(above).set(event.params.getString('block'))
})

{
  "type": "apoli:action_on_block_use",
  "block_action": {
    "type": "apoli:script",
    "script": "gardener:sprout",
    "params": { "block": "minecraft:short_grass" }
  }
}

note

This action needs KubeJS. Without it the type still loads and the pack still works, but the call logs once and does nothing. Scripts always run on the server.