Clean Combos

Clean Combos 1.0.0-beta.2

Combat feel

• Combo rhythm: after a combo’s second hit there’s a short pause before the next combo, equal to the time the +25% attack speed bonus saved. Each swing stays snappy, but your sustained attack speed is your weapon’s real speed, and combos read as “da-da … da-da”. Stopping after the first hit doesn’t pause. Config: comboPause (on).
• Longer reach: every attack reaches 0.5 blocks further. Config: attackRangeBonus.
• Thrusts reach further: spear thrusts and running sword thrusts get another +1 block. This was done because attacking fleeing enemies was found to be particularly difficult. Targeting and the lunge use the extra reach while you sprint. Config: thrustRangeBonus.
• Lunges land closer: a lunge now stops at 60% of your range instead of right at its edge.. Config: lungeStopFraction.
• Walking out of a combo: holding forward after an attack now walks instead of sprinting straight away.

Weapons

• Weapon types: items are now recognised as sword, greatsword, katana, rapier, dagger, axe, mace, hammer, scythe, halberd, spear, trident, staff, claw, fist, tool or other. /clean_combos item shows the type for each hand.
• Non-weapons use vanilla’s attack: example - holding a torch, block or food no longer starts a punch combo; it attacks and mines like vanilla. Punch combos need an empty hand or a fist weapon (claws, gauntlets, knuckles…).
• Death messages by weapon: “was run through by” for a rapier, “was hammered flat by” for a hammer, “was mauled by” for claws, and so on. Named weapons add “using [weapon]”.

For mod and pack authors

• New public API (com.cleannrooster.clean_combos.api, stable across 1.x; see docs/API.md):
  • Weapon type, moveset and damage kind (slashing, piercing or bludgeoning) for any item.
  • The attack an entity is making right now: phase, progress, combo slot.
  • Events: attack start (cancellable), strike (adjust damage per target, or cancel it), and miss.
  • currentStrike(), so your damage hooks can recognise a Clean Combos hit.
• Item tags to classify weapons without config: #clean_combos:weapon_type/<type>, #clean_combos:moveset/<swing|chop|thrust|fist>, and #clean_combos:vanilla_attack.