Explode (Bi-Entity Action Type)

Creates an explosion in the world, with control over where it originates and how it interacts with blocks. Damage attribution and kill credit go to the actor.

Type ID: apoli:explode

Fields#

Field	Type	Default	Description
power	Float	required	The blast radius/power of the explosion
destruction_type	String	"destroy"	How the explosion affects blocks. Accepted values: "none", "break", "destroy"
create_fire	Boolean	false	Whether the explosion places fire in the blast area
at_target	Boolean	false	If true, the explosion originates at the target’s position; otherwise it originates at the actor’s
damage_self	Boolean	true	Whether the actor takes damage from its own explosion
damage_targets	Boolean	true	Whether everything other than the actor takes damage. false keeps the blocks and the knockback, drops the damage
indestructible	Block Condition	optional	Block condition for blocks that are protected from the explosion regardless of destruction_type
destructible	Block Condition	optional	Block condition for blocks that are explicitly allowed to be destroyed, taking priority over indestructible

Block Destruction Logic#

Block protection is resolved in this order:

1. If destructible is set and a block matches it, that block can be destroyed regardless of indestructible.
2. If indestructible is set and a block matches it, that block is protected.
3. Otherwise, destruction_type governs normal explosion block destruction.

Examples#

{
    "type": "apoli:explode",
    "power": 3.0,
    "destruction_type": "break",
    "create_fire": false
}

Explosion at the actor’s position, breaking blocks.