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.