Archery

Archery is the bow-and-arrow skill. It makes your shots hit harder as you level, gives you a chance to disorient players you hit, lets you recover spent arrows from the corpses of mobs you kill, and adds extra PVP punch through Limit Break.

You train Archery by shooting mobs and players with a bow. Hitting targets from far away pays bonus XP, so accuracy at range is rewarded.

Skill Shot: bonus bow damage

Skill Shot passively increases the damage of your bow shots. It has 20 ranks, and each rank adds a percentage to your arrow's damage, up to a hard cap on the total bonus.

The formula

damage bonus % = rank × RankDamageMultiplier ÷ 100      (RankDamageMultiplier = 10.0)
new damage     = old damage + (old damage × bonus %)
                 but capped so the *added* damage never exceeds MaxDamage (9.0)

With the defaults, each rank adds 10%, so at rank 20 you're adding 200% bonus damage, but the total bonus is capped so it never adds more than 9 extra damage to a single shot.

Archery:
    SkillShot:
        RankDamageMultiplier: 10.0   # +10% damage per rank
        MaxDamage: 9.0               # added damage can never exceed this

Daze: disorient your target

Daze only works against other players. When it triggers on a shot, the victim's view is yanked to a random angle (it forces them to look around as if dazed), they get a short Nausea effect, and they take a bit of bonus damage.

Activation chance

So a level 50 Standard archer dazes about 25% of the time, reaching the 50% cap at level 100.

Effects

• Bonus damage: a successful Daze adds 4 extra damage (2 hearts) to the shot.
• Disorientation: the target's view direction is snapped to a random pitch, throwing off their aim.
• Nausea: the target gets the Nausea (confusion) potion effect for 10 seconds.

Archery:
    Daze:
        ChanceMax: 50.0
        MaxBonusLevel:
            Standard: 100
            RetroMode: 1000
        BonusDamage: 4.0   # extra damage on a daze (2 hearts)

Arrow Retrieval: get your arrows back

Arrow Retrieval gives you a chance to recover the arrows you fired when you kill a mob with them. When a tracked mob dies, mcMMO drops back some of the arrows stuck in it.

Recovery chance

So a level 50 Standard archer recovers arrows about 50% of the time; at level 100 you get them back on every kill (per arrow tracked).

Archery:
    ArrowRetrieval:
        ChanceMax: 100.0
        MaxBonusLevel:
            Standard: 100
            RetroMode: 1000

Arrow Retrieval unlocks at Archery level 1, so even brand-new archers have a small chance to get arrows back.

Archery Limit Break: PVP damage

Like the other combat skills, Archery has a Limit Break sub-skill that adds flat raw damage in PVP (and in PVE only if the server enables it). It has 10 ranks.

The formula

raw bonus = rank, then reduced by the defender's total armor quality:
  armor quality ≤ 4   →  × 0.25  (75% reduction)
  armor quality ≤ 8   →  × 0.50  (50% reduction)
  armor quality ≤ 12  →  × 0.75  (25% reduction)
  armor quality > 12  →  × 1.00  (full bonus)

Against mobs (when PVE Limit Break is enabled) the full rank bonus applies. The point is to deal more damage against tough, well-armored opponents.

Earning XP

Archery XP comes from the damage you deal with arrows, scaled by the target's combat XP multiplier (the Experience_Values.Combat.Multiplier table in experience.yml).

The distance bonus

Archery rewards long-range shots. The farther the target was from where the arrow was fired, the more XP that hit pays:

distance multiplier = 1 + (min(distance, 50) × Distance_Multiplier)
                    = 1 + (min(distance, 50) × 0.025)

So distance is counted up to 50 blocks. A 50-block shot gives 1 + 50 × 0.025 = 2.25× the normal XP. A point-blank shot gets the base 1×.

Experience_Values:
    Archery:
        Distance_Multiplier: 0.025

Bow force

Skills:
    Archery:
        ForceMultiplier: 2.0

A fully-drawn bow shot can have its XP boosted by the ForceMultiplier (2.0), rewarding fully-charged shots over quick taps.

Standard combat exploit limits apply: the per-hit XP ceiling (ExploitFix.Combat.XPCeiling, default 100) caps damage counted per shot, and unnatural spawns (spawners, eggs) are worth 0 XP by default.

Commands & permissions

The real permission nodes have no underscores (e.g. arrowretrieval, not arrow_retrieval). See Permissions for the full list and how to assign them.

Quick reference