14 Ability Types
PhantomPig edited this page 2026-05-29 18:06:34 +00:00

Ability Types

Block

Reduces incoming damage like a shield.

Field Default Description
damage_type <required> A HolderSet for the damage type either to block or not to block, depending on whitelist. A common value is "#minecraft:bypasses_shield".
whitelist true If true, then damage_type acts as a whitelist for bypassing, specifying which damage types will bypass the ability. If false, then it instead acts as a blacklist, and only matching damage types will be blocked.
angle 30 The maximum yaw angle on either side of where the player is looking that blocked damage can come from. For a typical Vanilla shield effect, use 90 (for 180 degrees total of coverage). To block damage from all sides, use 180. Accepts a Value and reacts to an animation timer.
max_blocked_piercing_level 0 The maximum piercing level (i.e. from a crossbow with the piercing enchantment) that will be blocked. If a projectile's piercing level is above this value, then the damage will not be blocked. Accepts a Value.
reduction 1.0 The percentage (formatted as a decimal) of damage to block. 1 -> 100% -> all of the damage is blocked; 0.5 -> 50% -> half of the damage is blocked. Accepts a Value.

Examples:

{
  "type": "vibranium:block",
  "angle": 45,
  "damage_type": "#minecraft:bypasses_shield",
  "max_blocked_piercing_level": 2
}
{
  "type": "vibranium:block",
  "angle": {
    "type": "palladium:moon_phase",
    "modify": "this * 10"
  },
  "damage_type": "#minecraft:bypasses_shield"
}

Effect on Hit

Applies potion effects to the victim when the entity with the ability damages another entity.

Field Default Description
effects <required> The effect(s) to apply to the victim entity.
direct_only true If false, then projectiles and other non-direct damage will also apply the effect(s).

Examples:

{
  "type": "vibranium:effect_on_hit",
  "effects": {
    "id": "minecraft:weakness",
    "duration": 40,
    "amplifier": 2,
    "show_icon": false,
    "show_particles": true,
    "ambient": false
  }
}
{
  "type": "vibranium:effect_on_hit",
  "direct_only": false,
  "effects": [
    {
      "id": "minecraft:levitation",
      "duration": 30
    },
    {
      "id": "minecraft:resistance",
      "duration": 80,
      "amplifier": 1
    }
  ]
}

Explosion

Explodes.

Field Default Description
size 4.0 The size/power of the explosion. Accepts a Value and reacts to an animation timer.
cause_fire false Whether the explosion causes fire. Accepts a Value.
hurt_self false If true, the entity with the ability will be affected by the explosion.
explosion_interaction TNT The ExplosionInteraction to use. Determines how blocks are affected by the explosion.
respect_tnt_explodes_game_rule true If true, the "tnt_explodes" game rule must also be true for the explosion to take effect.

Examples:

{
  "type": "vibranium:explosion",
  "size": 15.0,
  "cause_fire": true
}

Force Flight

Forces the entity to either start or stop flight. Requires a "palladium:flight" ability to also be active; this ability does not alone grant flight.

Field Default Description
start true If "start" is true, flight will begin; if it is false, flight will be forced to stop.

Examples:

{
  "type": "vibranium:force_flight",
  "state": {
    "enabling": {
      "type": "palladium:brightness_at_position",
      "min": 7,
      "max": 15
  }
}
{
  "type": "vibranium:force_flight",
  "start": false
}

Step Down

Allows for stepping down blocks quickly.

Field Default Description
fall_speed <required> Speed at which you fall off the block.
fall_distance <required> Fall distance it will enable at. Accepts a Value and reacts to an animation timer.
safety_checks true If false, checks for if the ability SHOULD be enabled such as the entity being in spectator, fall flying, swimming, or on the ground will be disabled.
allow_vehicles false If true, the step-down effect will apply to the entity's vehicle, if the entity is riding something.
allow_fluids false If true, it will work in fluids.
allowed_fluids "minecraft:water" A HolderSet determining the fluid(s) the entity can step down in.

Examples:

{
  "type": "vibranium:step_down",
  "fall_speed": 1,
  "fall_distance": 2,
  "allow_fluids": true,
  "allowed_fluids": "#minecraft:lava"
}