Skip to main content

Combat Mechanics

These mechanics form the core of your mob’s offensive and defensive capabilities.

Damage & Healing

damage

Deals a specified amount of damage to the target.
  • Attributes:
    • amount (number): The amount of damage to deal.
    • element (string): The damage element (e.g., FIRE, MAGIC).
    • ignoreArmor (boolean): Whether to bypass armor.
    • cause (string): The damage cause (e.g., ENTITY_ATTACK).
- damage{amount=10;element=FIRE} @target ~onAttack

heal

Restores health to the target.
  • Attributes:
    • amount (number): Health to restore.
    • percent (boolean): If true, amount is treated as a percentage of max health.
- heal{amount=5} @self ~onTimer:20

percentdamage / basedamage

Deals damage based on percentage of health or base damage values.
  • Attributes:
    • amount (number): Percentage (0-100) or base value.

shieldbreak

Disables the target’s shield for a duration.
  • Attributes:
    • duration (ticks): How long the shield remains broken.

Projectiles & Missiles

missile

Fires a guided projectile that tracks its target.
  • Attributes:
    • velocity (number): Speed of the missile.
    • gravity (boolean): Whether the missile is affected by gravity.
    • onTick (skill): Skill to run every tick.
    • onHit (skill): Skill to run when it hits a target.
- missile{v=10;onTick=FireTrail;onHit=Explode} @target

projectile

Fires a standard projectile (Arrow, Fireball, etc.).
  • Attributes:
    • type (string): The projectile type (ARROW, SNOWBALL, FIREBALL).
    • velocity (number): Speed of the projectile.
- projectile{type=ARROW;v=5} @target

Control & Status

stun

Prevents the target from moving or attacking.
  • Attributes:
    • duration (ticks): How long the stun lasts.

parry

Enters a parry state, reducing or reflecting incoming damage.
  • Attributes:
    • duration (ticks): How long the state lasts.
    • reduce (number): Multiplier for incoming damage (e.g., 0.5 for 50%).

attribute

Modifies an entity’s base attributes (Speed, Strength, Health, etc.).
  • Attributes:
    • stat (string): Attribute name.
    • amount (number): Modification value.
    • mode (string): ADD, MULTIPLY, or SET.

slash

Executes a sweeping attack in front of the caster.
  • Attributes:
    • damage (number): Damage dealt.
    • range (number): Reach of the slash.

Advanced Defense

shield

Provides a temporary shield that absorbs damage.
  • Attributes:
    • amount (number): Shield capacity.
    • duration (ticks): Shield expiration.
Use shieldbreak in combination with damage to penetrate defensive players!

decapitate

Drops a player head upon death.
  • Attributes:
    • chance (number): Drop probability (0.0 - 1.0).

totem

Simulates a Totem of Undying effect on the target.

suicide

Immediately kills the caster. Useful for exploding mobs or sacrificial summons.