For the complete documentation index, see llms.txt. This page is also available as Markdown.

Fundamental and Visual Abilities

Every registered ability on this page is documented as a complete reference entry. All entries also support the common ability fields from the Abilities page.

Registry keys on this page

  • mark

  • cancel_event

  • remove

  • place_block

  • particle

  • sound

  • vanilla_animation


mark

Purpose: Marks the selected entity as belonging to the current power chain.

Context: Default target: SKILL; requires the selected entity to exist.

Fields

No type-specific fields.

Example

Behavior and limits

  • The marker is internal; it does not add a visible scoreboard tag.

  • Normally used for projectiles or helper entities that must retain power context.


cancel_event

Purpose: Requests cancellation of the current trigger event.

Context: No entity target is required; the trigger must provide a cancellable event.

Fields

No type-specific fields.

Example

Behavior and limits

  • The cancellation signal is propagated through parent control-flow abilities.

  • Cancelling a late notification event may not undo server work that already happened.


remove

Purpose: Removes the selected entity from the world.

Context: Default target: SKILL; requires an entity.

Fields

No type-specific fields.

Example

Behavior and limits

  • Players are never intended targets for this cleanup ability.

  • Useful for projectiles, temporary helpers, or replaced skill entities.


place_block

Purpose: Places a temporary block at the resolved ability location.

Context: Uses the trigger location plus common location offsets; no entity target is required.

Fields

Field
Default
Description

block

COBWEB

Bukkit material to place; must be a valid block material.

duration

40

Lifetime in ticks, clamped to at least 1.

Example

Behavior and limits

  • The destination block must currently be air.

  • The original block is restored by TempBlockManager when the duration expires.


particle

Purpose: Spawns a Bukkit particle at the resolved location.

Context: Default target is ability-specific; positioning uses the trigger/resolved location and common offsets.

Fields

Field
Default
Description

particle

FLAME

Bukkit Particle enum name.

count

1

Particle count.

offset-x / offset-y / offset-z

0

Particle spread.

extra

0

Particle-specific speed/extra value.

block

STONE

Block material for block-data particles.

item

STONE

Item material for ITEM.

color

particle-specific

RGB value such as 255,0,0.

size

1

Dust size or particle-specific size/duration.

from / to

particle-specific

Transition colors, vibration destination, or other structured particle data.

value

1.0

Float data for particles such as DRAGON_BREATH or SCULK_CHARGE.

delay

20

Delay data for SHRIEK.

duration

20

Travel duration for VIBRATION.

Example

Behavior and limits

  • Invalid particle names or incompatible required data cause the ability to do nothing.

  • Keep counts small on high-frequency triggers.


sound

Purpose: Plays a Bukkit sound at the resolved location.

Context: Uses the trigger/resolved location and common offsets.

Fields

Field
Default
Description

sound

ENTITY_PLAYER_LEVELUP

Bukkit Sound enum name.

volume

1

Sound volume and audible range.

pitch

1

Sound pitch.

Example

Behavior and limits

  • Invalid sound names are ignored.

  • Very large volume values increase audible range.


vanilla_animation

Purpose: Plays a Bukkit EntityEffect animation on a selected entity.

Context: Default target: SOURCE; requires an entity compatible with the selected effect.

Fields

Field
Default
Description

animation

HURT

Bukkit EntityEffect enum name.

entity-effect

HURT

Alias used when animation is absent.

Example

Behavior and limits

  • Invalid animation/effect names are ignored.

  • The animation is client-visible and does not itself apply damage or another mechanic.


Last updated