action executors - magemonkeystudio/divinity GitHub Wiki

⚡ Action Executors

Action executors define the effects that will run when an action is triggered. These effects range from particles and damage to running commands or showing messages.

Each executor is written in the form:

[ACTION_TYPE] ~key: value; ~key2: value; ~target: selector;

📜 Full List of Executors

These action types are built into the Codex engine and available in all Divinity modules:

Executor	Description
`ACTION_BAR`	Sends an action bar message to a player.
`BROADCAST`	Sends a message to the entire server.
`BURN`	Sets entities on fire.
`DAMAGE`	Deals direct damage to a target.
`HEALTH`	Heals or harms HP by a fixed amount.
`MESSAGE`	Sends a direct chat message to a player.
`COMMAND_PLAYER`	Makes the executor run a command.
`COMMAND_CONSOLE`	Runs a command as the server console.
`COMMAND_OP`	Temporarily grants OP to execute a command.
`FIREWORK`	Spawns a random firework at the target location.
`HOOK`	Used to trigger internal plugin hooks (dev use).
`LIGHTNING`	Strikes lightning at the target location.
`PARTICLE_SIMPLE`	Displays a simple particle effect.
`POTION`	Applies potion effects to a target.
`PROGRESS_BAR`	Animates a progress bar visually.
`PROJECTILE`	Spawns and shoots a projectile (e.g., arrow, fireball).
`THROW`	Launches an entity from its current position.
`SATURATION`	Adds food saturation to players.
`HUNGER`	Restores player hunger.
`SOUND`	Plays a sound at the target location.
`TELEPORT`	Teleports the target to a location.
`TITLES`	Displays title and subtitle messages.
`GOTO`	Jumps to another named action sequence.

🧪 Example

action-executors:
  - '[DAMAGE] ~amount: -50%; ~target: near;'
  - '[PARTICLE_SIMPLE] ~name: EXPLOSION_LARGE; ~target: self;'
  - '[TITLES] ~title: &aSuccess; ~subtitle: &fIt worked!; ~target: self;'

🛠 Tips