Synergies

Synergies are a special eighth layer of progression — 8 powerful cross-skill abilities that reward players who invest across multiple skill trees instead of specializing in one.

How Synergies Work

A synergy unlocks automatically when a player reaches level 50 in both qualifying skills. No points required. No quest to complete. The plugin fires a SkillLevelUpEvent SynergyGateCheck — if both required skills are ≥ 50, the synergy ability is granted at rank 1 and the player receives a chat notification.

Synergies: - Cannot be purchased or revoked manually (no admin command to remove them except /skills admin lock). - Survive a respec — they depend on skill levels, not point allocations. - Are equippable to the active ability bar like any other ability. - Are lost if skill levels fall below 50 (e.g. via /skills admin setlevel).

The 8 Synergies

Synergy	Required Skills	Mechanic
Riposte	Swords + Defense	On block with a shield within 1s of a melee hit, deal 150% of the blocked damage back as a burst.
BattleDance	Swords + Archery	Alternating melee ranged melee hits each deal +20% damage, stackable up to 3× while the chain is unbroken.
Stoneshield	Mining + Defense	While holding a pickaxe, gain a passive damage-absorption shield that regenerates every 30s.
ResourceSurge	Mining + Woodcutting	Every 100th block broken triggers a 10s surge: +50% XP from all gather actions and a chance to double drops.
HuntersPatience	Archery + Farming	After standing still for 3s, the next arrow deals +80% damage and applies a 3s root.
BerserkersEdge	Axes + Woodcutting	Killing a mob with an axe while your health is below 50% grants a 5s damage buff (+30%) and restores 5 mana.
Provider	Farming + Fishing	Harvesting a crop or catching a fish has a 15% chance to generate a second identical drop and grant +10 mana.
Anchor	Defense + Fishing	While fishing, damage taken is reduced by 25%. Hooking a fish immediately ends the damage-reduction window and deals AoE knockback to nearby mobs.

Synergy Gate Check

The check runs every time a SkillLevelUpEvent fires. Logic:

for each Synergy S:
  if player.skillLevel(S.skillA) >= 50
  and player.skillLevel(S.skillB) >= 50
  and not player.hasAbility(S.abilityId):
      grantAbility(player, S.abilityId, rank=1)
      notify(player)

The check is O(8) — trivially fast. It also runs on player join so levels set offline are reconciled immediately on next login.

Synergy YAML Schema

Synergy abilities use the same YAML schema as other abilities with type: SYNERGY. The engine enforces that synergy abilities are never rankable and cannot appear in the base ability purchase flow.

abilities:
  riposte:
    id: riposte
    skill: swords          # primary skill (determines which tree displays it)
    type: SYNERGY
    pattern: InstantDamage
    pvp-enabled: true
    max-rank: 1
    rank-params:
      1:
        reflect-multiplier: 1.5
        mana-cost: 0          # synergies often cost 0 mana to keep them feel passive
        cooldown-seconds: 1
    icon: SHIELD
    name: "<gold>Riposte"
    lore:
      - "<gray>Block a hit within 1s of taking melee damage"
      - "<gray>to reflect <b>150%</b> of the blocked amount."
      - ""
      - "<yellow>Requires: <white>Swords 50 + Defense 50"

Home | Configuration | Abilities | Milestones