Swords

Swords is mcMMO's melee combat skill for anyone fighting with a sword. It turns your attacks into something nastier: a stacking bleed (Rupture), passive bonus damage (Stab and Limit Break), a way to punish attackers (Counter Attack), and an on-demand area-of-effect super ability (Serrated Strikes).

You level it up the obvious way: by hitting things with a sword. The more damage you deal, the more Swords XP you earn, and the more its sub-skills unlock and grow.

How combat XP works

Every Swords sub-skill (and the XP itself) comes from landing sword hits. mcMMO awards combat XP based on the damage you actually deal, multiplied by a per-mob value:

Swords XP = damage dealt × (per-mob value × 10)

The per-mob value lives in experience.yml under Combat.Multiplier. A few examples (the number shown is the raw multiplier; multiply by 10 for XP per damage point):

Two important caps:

• Damage is counted, not kills. You earn XP proportional to the health you remove, so chipping a tough mob still pays out.
• The XP damage ceiling is 100 (Combat.XPCeiling.Damage_Limit). A single hit that deals more than 100 damage is treated as 100 for XP purposes.

PVP awards XP too (PVP.Rewards: true), unless the target is on your team or recently respawned.

Stab: passive bonus damage

Stab silently adds flat damage to every sword hit once unlocked. There's nothing to activate.

The bonus damage is:

Stab bonus = Base_Damage + (rank × Per_Rank_Multiplier)
           = 1.0 + (rank × 1.5)

So Rank 1 adds 2.5 damage and Rank 2 adds 4.0 damage. The bonus is scaled by your attack strength. If you swing before the vanilla attack cooldown has refilled, you get a proportionally smaller share of the Stab bonus.

Swords:
    Stab:
        Base_Damage: 1.0
        Per_Rank_Multiplier: 1.5

Rupture: the bleed

Rupture is mcMMO's bleed-over-time effect. When you land a hit, there's a chance to make the target bleed, taking small bursts of "pure" damage twice a second. If the bleed runs its full course without being refreshed, it explodes for a chunk of normal damage at the end.

When it unlocks

Your chance to apply it

Rupture's chance is fixed per rank (not a smooth per-level curve) and is then scaled by your attack strength:

Rupture chance = rank chance × attack strength

Hitting before your attack cooldown has refilled lowers the chance proportionally.

Bleed duration

Rupture lasts 5 seconds against both players and mobs by default. Re-hitting a target that's already bleeding refreshes the timer instead of stacking a second bleed.

Tick damage (the "pure" part)

While bleeding, the target takes damage twice a second. This tick damage is pure: it ignores armor, Protection, and absorption.

The explosion

If a bleed reaches the end of its 5 seconds without being refreshed, it explodes. Unlike the ticks, this explosion damage is not pure: it's reduced by armor, absorption, and resistances like normal.

Swords:
    Rupture:
        Rupture_Mechanics:
            Chance_To_Apply_On_Hit:
                Rank_1: 15
                Rank_2: 33
                Rank_3: 40
                Rank_4: 66
            Duration_In_Seconds:
                Against_Players: 5
                Against_Mobs: 5

Counter Attack: punishing attackers

When something hits you in melee, Counter Attack gives you a chance to reflect part of the damage straight back at the attacker.

Chance and reflected damage

The chance scales with your Swords level up to a cap:

When it triggers, the attacker takes back the incoming damage divided by the DamageModifier (default 2.0), so half the damage they dealt you:

reflected damage = incoming damage ÷ 2

Counter Attack only works against living attackers (mobs and players, not things like arrows or fall damage).

Swords:
    CounterAttack:
        ChanceMax: 30.0
        MaxBonusLevel:
            Standard: 100
            RetroMode: 1000
        DamageModifier: 2.0

Swords Limit Break: anti-armor bonus damage

Limit Break is a flat bonus-damage sub-skill designed mainly for PVP. It adds raw damage that scales with rank, with one twist: the better the target's armor, the smaller the bonus.

The base bonus equals your rank (so +10 raw damage at Rank 10), reduced by the target's total armor quality:

The bonus is also scaled by your attack strength, like Stab.

Serrated Strikes: the super ability

Serrated Strikes is the Swords super ability: a timed buff that makes your next several sword hits deal area-of-effect damage and spread Rupture to everything caught in the blow.

Activating it

1. Hold a sword and right-click to "ready" it (you'll see You ready your Sword).
2. Left-click an enemy within a moment to fire it off.

It unlocks at Swords level 5 (Standard) / 50 (RetroMode).

Duration

The active time scales with your Swords level. Every super ability uses the same formula:

duration (seconds) = 2 + (skill level ÷ 5)        # Standard
duration (seconds) = 2 + (skill level ÷ 50)       # RetroMode

The level used is capped at 100 (Standard) / 1000 (RetroMode), so the longest Serrated Strikes lasts is 22 seconds. For example, a level 50 Standard player gets 2 + 50/5 = 12 seconds.

Effect

While active, hits trigger an AoE burst around the target. The splash damage to nearby enemies is the hit's damage divided by the DamageModifier (default 4.0), and the AoE also applies Rupture (5 bleed ticks) to those it hits.

Swords:
    SerratedStrikes:
        DamageModifier: 4.0
        BleedTicks: 5

Cooldown

Serrated Strikes has a 240-second cooldown by default (Skills.Cooldowns.Serrated_Strikes in config.yml). There is no maximum length cap by default (Max_Seconds.Serrated_Strikes: 0), so only the level-based duration above applies.

Commands & permissions

Quick reference