Abilities

abilities.yml defines the 9 combat abilities that make elites more than just stat-boosted mobs. Each ability has its own activation rules, cooldowns, and per-tier scaling.

Common Fields

Every ability shares these settings:

Field	What it does
`isEnabled`	Master toggle for the ability.
`chancePerTier`	Probability that an elite of each tier gets this ability when it spawns. `1.0` = guaranteed.
`cooldownSecondsPerTier`	Minimum time between uses for each tier.
`gate`	Weapon category restrictions. Only mobs holding weapons from the allowed categories can use this ability.

Ability Gating

The ability gating system controls which elites can use each ability. When a mob spawns as an elite, RPGMobs checks three conditions before granting an ability:

Linked mob rule keys — the elite’s matched mob rule key must appear in the ability’s linkedMobRuleKeys list.
Per-entry tier enablement — each linked entry has its own per-tier toggle array. The entry’s tier toggle must be enabled for the elite’s tier.
Weapon category gate — the elite’s equipped weapon must belong to one of the ability’s allowedWeaponCategories.

If all three checks pass, the ability is granted.

charge_leap:
  isEnabled: true
  linkedMobRuleKeys:
    - "category:Skeletons"
    - "category:Zombies"
    - "category:Goblins"
    - "category:Trorks"
    - "category:Outlanders"
    - "category:Wraiths"
  excludeLinkedMobRuleKeys:
    - "Skeleton_Incandescent_Head"
    - "Crawler_Void"
    - "Eye_Void"
  gate:
    allowedWeaponCategories:
      - "category:Axes"
      - "category:Battleaxes"
      - "category:Swords"
      - "category:Longswords"
      - "category:Clubs"
      - "category:Daggers"
      - "category:Maces"
      - "category:Spears"

linkedMobRuleKeys accepts both individual mob rule keys (e.g. "Goblin_Duke") and category keys (e.g. "category:Skeletons"). A category key includes all mob rules within that category.
excludeLinkedMobRuleKeys removes specific mob rule keys that would otherwise be included by a category. For example, "Skeleton_Incandescent_Head" is excluded from Charge Leap even though the Skeletons category is linked.
allowedWeaponCategories restricts the ability to mobs wielding weapons from the listed categories. This prevents ranged mobs from using melee-only abilities like Charge Leap.

Each linked entry’s per-tier enablement is managed through the Admin UI. When you expand an ability in the Abilities tab, each linked mob entry shows five T1—T5 toggle buttons that control which tiers that specific mob can use the ability at.

Per-World Overlays

Abilities can be configured per-world via abilityOverlays in the overlay system. Each world can define its own set of linked mob entries with independent per-tier toggles, allowing you to enable or disable abilities for specific mobs on a per-world basis without changing the base configuration.

Charge Leap

A physics-based attack where the elite launches itself at a nearby player, dealing slam damage on impact.

charge_leap:
  isEnabled: true
  cooldownSecondsPerTier: [0, 0, 0, 16, 20]
  minRange: 9.0
  maxRange: 30.0
  faceTarget: true
  slamBaseDamagePerTier: [0, 0, 0, 20, 30]
  applyForcePerTier: [0, 0, 0, 530, 530]
  slamRangePerTier: [0, 0, 0, 3, 4]
  knockbackLiftPerTier: [0, 0, 0, 3, 6]
  knockbackPushAwayPerTier: [0, 0, 0, -3, -6]
  knockbackForcePerTier: [0, 0, 0, 20, 26]

Setting	What it does
`minRange` / `maxRange`	The elite will only leap if the target is within this distance range.
`faceTarget`	Whether the mob turns to face the player before leaping.
`slamBaseDamagePerTier`	Flat damage dealt on impact for each tier.
`applyForcePerTier`	Launch velocity force. Higher values mean faster, longer leaps.
`slamRangePerTier`	Area-of-effect radius for the slam damage.
`knockbackLiftPerTier`	Upward knockback applied to nearby players on landing.
`knockbackPushAwayPerTier`	Horizontal knockback (positive values pull inward).
`knockbackForcePerTier`	Overall knockback strength.

Heal Potion

Allows the elite to drink a healing potion when its health drops below a threshold. Players can interrupt the heal by dealing enough hits during the drinking animation.

heal_potion:
  isEnabled: true
  cooldownSecondsPerTier: [0, 0, 0, 15, 15]
  minHealthTriggerPercent: 0.50
  maxHealthTriggerPercent: 0.50
  instantHealChance: 1.0
  instantHealAmountPerTier: [0, 0, 0, 0.25, 0.25]
  npcDrinkDurationSeconds: 3.0
  npcDrinkItemId: "Potion_Health_Greater"

Setting	What it does
`minHealthTriggerPercent` / `maxHealthTriggerPercent`	The health threshold range at which the heal triggers. A random value between min and max is chosen once when the elite spawns. `0.50` means the elite tries to heal at 50% HP.
`instantHealChance`	Chance to use an instant heal (restores health immediately) vs. regeneration over time. `1.0` = always instant.
`instantHealAmountPerTier`	Fraction of max health restored by instant heal. `0.25` = heals 25% of max HP.
`npcDrinkDurationSeconds`	How long the drinking animation lasts. Players have this window to interrupt it.
`npcDrinkItemId`	The item the mob visually holds while drinking.

Undead Summon

Allows elites to summon reinforcement minions during combat. By default, undead elites summon undead minions (skeleton archers, zombies, wraiths), Goblin_Duke summons goblins, and Trork_Shaman summons trorks. When the summoner dies, all its minions despawn.

undead_summon:
  isEnabled: true
  chancePerTier: [0, 0, 0, 0.5, 1.0]
  cooldownSecondsPerTier: [0, 0, 0, 25, 25]
  maxAliveMinionsPerSummoner: 4
  skeletonArcherWeight: 100
  zombieWeight: 0
  wraithWeight: 25
  aberrantWeight: 25
  excludeFromSummonPool: ["Trork_Shaman"]
  roleIdentifiers:
    - "Skeleton_Frost"
    - "Skeleton_Sand"
    - "Skeleton_Burnt"
    - "Skeleton_Incandescent"
    - "Skeleton_Pirate"
    - "Skeleton"
    - "Zombie_Burnt"
    - "Zombie_Frost"
    - "Zombie_Sand"
    - "Zombie"
    - "Goblin_"
    - "Trork_"

Setting	What it does
`maxAliveMinionsPerSummoner`	Maximum number of summoned minions alive at once per summoner. Capped at 0-50.
`skeletonArcherWeight`	Weight for skeleton archers in the summon pool. Higher = more likely.
`zombieWeight`	Weight for zombie minions.
`wraithWeight`	Weight for wraith minions.
`aberrantWeight`	Weight for aberrant zombies in the zombie summon pool.
`excludeFromSummonPool`	Roles excluded from the auto-generated summon pool. Prevents summoners from summoning themselves (e.g., Trork_Shaman won’t summon other Shamans).
`roleIdentifiers`	List of role name fragments used to pick which variant of minion gets summoned. The summoner’s own role is checked against this list to pick a matching variant. For example, a Goblin_Duke matches `"Goblin_"` and will summon other goblin NPCs.

Role-Based Summoning

The summon system automatically builds per-role summon pools from the mob rules. When a summoner’s role matches a roleIdentifier, only NPCs matching that same identifier are added to its summon pool:

Undead summoners (skeletons, zombies, wraiths) summon other undead variants
Goblin_Duke summons other goblins (matching "Goblin_")
Trork_Shaman summons other trorks (matching "Trork_"), excluding itself via excludeFromSummonPool

Tip: The summon ability is gated via linkedMobRuleKeys to undead mobs, Goblin_Duke, and Trork_Shaman by default. To allow other mob types to summon, add them to the ability’s linkedMobRuleKeys (either individually or via a category) and add an appropriate prefix to roleIdentifiers so the summon system knows which pool to build for them.

Dodge Roll

A reactive and preemptive defensive ability. When a nearby player starts attacking, the elite has a chance to dodge sideways with a brief invulnerability window. Charged attacks give a boosted dodge chance. Detected by RPGMobsPlayerAttackDetectionSystem which reads player attack interactions in a cone.

dodge_roll:
  isEnabled: true
  cooldownSecondsPerTier: [12, 10, 8, 6, 5]
  dodgeChancePerTier: [0.05, 0.08, 0.12, 0.18, 0.25]
  dodgeForce: 300.0
  invulnerabilityDurationPerTier: [0.3, 0.3, 0.4, 0.5, 0.6]

Setting	What it does
`dodgeChancePerTier`	Probability that the elite dodges when triggered. Charged player attacks boost this chance.
`dodgeForce`	Lateral dash velocity. Higher values mean faster, longer dodges.
`invulnerabilityDurationPerTier`	Duration in seconds of the invulnerability window during the dodge.

Multi Slash Short

Quick 1-2 hit strikes with 3 random variations per weapon type. The fastest of the Multi Slash abilities, designed for interrupting player actions. Available to all tiers.

multi_slash_short:
  isEnabled: true
  cooldownSecondsPerTier: [10, 8, 6, 5, 4]

Each of the 8 weapon variants (Swords, Longswords, Daggers, Battleaxes, Axes, Maces, Clubs, Spears) has independent config values for trigger chance, cooldown, damage, forward drift, knockback, and melee range. These are configured per-variant in the Admin UI using the variant selector buttons.

Multi Slash Medium

2-4 hit combos with 2 random variations per weapon type. A balance of damage and recovery time. Available T2+.

multi_slash_medium:
  isEnabled: true
  cooldownSecondsPerTier: [0, 12, 10, 8, 6]

Uses the same per-weapon-variant config system as Multi Slash Short.

Multi Slash Long

4-6 hit full combos with 1 variation per weapon type. High damage output but long wind-up and recovery times give players counter windows. Available T3+.

multi_slash_long:
  isEnabled: true
  cooldownSecondsPerTier: [0, 0, 15, 12, 10]

Uses the same per-weapon-variant config system as Multi Slash Short. Wind-up times are standardized at a minimum of 2.1 seconds.

Weapon Variants

All three Multi Slash abilities support 8 weapon variants, each with unique animations, sounds, trails, and timing:

Variant	Short (hits)	Medium (hits)	Long (hits)	Signature moves
Swords	1-2	3	6	Spins and overhead jump finisher
Longswords	1-2	3	4	Wide sweeps and stab finisher
Daggers	1-2	3	4	Razor strikes and kick finisher
Battleaxes	1	2	3	Whirlwind and downstrike finisher
Axes	1-2	3	4	Charged swings and upswing finisher
Maces	1-2	2	3	Uppercut and falling slam finisher
Clubs	1-2	2	3	Side bashes and overhead slam
Spears	1-2	3	5	Stab and spin sweep finisher

Enrage

A berserk transformation where the elite drops its weapon and enters a 20-second rapid punch chain. The mob cycles through 3 random variation patterns of light and heavy punches, then dies from exhaustion with normal loot and XP drops. Available T2+.

enrage:
  isEnabled: true
  cooldownSecondsPerTier: [0, 60, 60, 60, 60]
  triggerHealthPercentPerTier: [0, 0.30, 0.25, 0.20, 0.15]
  lightPunchDamagePerTier: [0, 3, 5, 8, 12]
  heavyPunchDamagePerTier: [0, 6, 10, 16, 24]

Setting	What it does
`triggerHealthPercentPerTier`	Health threshold below which enrage can trigger. `0.30` means 30% HP.
`lightPunchDamagePerTier`	Damage per light punch (0.45s each, 2.0 range).
`heavyPunchDamagePerTier`	Damage per heavy punch (0.65s each, 2.5 range, with visual trails).

Note: Enrage is restricted to melee mobs only. The mob’s weapon is de-equipped at the start and restored if the ability is interrupted (death or deaggro). Enrage can only trigger once per mob (the enraged flag persists across chunk unload/reload).

Volley

A ranged projectile burst for mobs wielding bows, crossbows, or guns. The mob aims upward briefly, then fires a spread of projectiles. Available T3+.

volley:
  isEnabled: true
  cooldownSecondsPerTier: [0, 0, 18, 15, 12]
  volleyTriggerChancePerTier: [0, 0, 0.08, 0.12, 0.18]
  minRange: 8.0
  maxRange: 30.0
  projectileCountPerTier: [0, 0, 3, 4, 5]
  spreadAnglePerTier: [0, 0, 15, 20, 25]
  baseDamagePerProjectilePerTier: [0, 0, 5, 8, 12]

Setting	What it does
`volleyTriggerChancePerTier`	Probability of triggering per combat tick evaluation.
`minRange` / `maxRange`	Target must be within this distance range.
`projectileCountPerTier`	Number of projectiles fired in the burst.
`spreadAnglePerTier`	Spread angle in degrees between projectiles.
`baseDamagePerProjectilePerTier`	Damage per individual projectile.

Global Ability Cooldown

After any ability completes, a random cooldown of 1-3 seconds prevents the next ability from triggering. This prevents ability spam in group combat.

globalCooldownMinSeconds: 1.0
globalCooldownMaxSeconds: 3.0

Ability Gating Summary

Abilities are no longer filtered by combat personality. Instead, each ability uses the linked mob rule system with per-entry per-tier toggles. This gives full control over which mobs can use which abilities at which tiers, configured through the Admin UI or the abilityOverlays in per-world overlays. Abilities are evaluated in feature registration order - the first ability whose gate passes wins. A global cooldown (1-3 seconds, configurable) prevents immediate ability chaining after any ability completes.

Getting Started

Admin UI

File Configuration

Developer API

Reference

Common Fields

Ability Gating

Per-World Overlays

Charge Leap

Heal Potion

Undead Summon

Role-Based Summoning

Dodge Roll

Multi Slash Short

Multi Slash Medium

Multi Slash Long

Weapon Variants

Enrage

Volley

Global Ability Cooldown

Ability Gating Summary

Getting Started

Admin UI

File Configuration

Developer API

Reference

​Common Fields

​Ability Gating

​Per-World Overlays

​Charge Leap

​Heal Potion

​Undead Summon

​Role-Based Summoning

​Dodge Roll

​Multi Slash Short

​Multi Slash Medium

​Multi Slash Long

​Weapon Variants

​Enrage

​Volley

​Global Ability Cooldown

​Ability Gating Summary

Common Fields

Ability Gating

Per-World Overlays

Charge Leap

Heal Potion

Undead Summon

Role-Based Summoning

Dodge Roll

Multi Slash Short

Multi Slash Medium

Multi Slash Long

Weapon Variants

Enrage

Volley

Global Ability Cooldown

Ability Gating Summary