offhandcombo

# Off Hand Combo

**Two hands, one rhythm.** Hold the attack key and your off hand finally joins in:
main hand, off hand, main hand, off hand. Every swing still waits for the regular attack
meter, so your damage per second stays exactly the same — the other weapon just stops
being decoration.

The off-hand hit is performed by **Off Hand Combat** itself, not reimplemented here. This
add-on only sets its attack flag and lets it swap the items, swap the attributes, play the
off-hand animation and flag the attack packet, so damage, enchantments, durability and the
server-side check all resolve for the off-hand weapon. Any item that mod accepts — anything
carrying attack damage — can be used in the off hand.

## Features

- **Alternating dual wield** — hold attack and the hands take turns, pacing the combo with
  your main hand's attack speed.
- **Right click is vanilla again** — Off Hand Combat's right-click off-hand attack is turned
  off (toggleable), so interacting, feeding and placing blocks behave normally.
- **Better Combat aware** — weapons it drives are never attacked twice; when it owns the main
  hand only the missing off-hand follow-up is added.
- **Auto Attack friendly** — if Auto Attack is installed, its attack-key handler is taken over
  at runtime so the two never double hit.
- **Non-destructive** — no other mod's jar is touched. Everything lives in this add-on and its
  two small mixins.

## Requirements

| | |
|---|---|
| Minecraft | 1.20.1 |
| Forge | 47.x |
| Off Hand Combat | 2.0.0 or newer (required) |



# 副手连击 (Off Hand Combo)

**两只手，一个节奏。** 按住左键，副手终于也参与进来：主手、副手、主手、副手……
每次出手仍然要等攻击条回满，所以 DPS 和单手连击完全一样，只是另一把武器不再是摆设。

副手这一下是由 **副手战斗** 自己执行的，本 mod 不重写伤害逻辑：只负责把攻击标记打上，
剩下的换武器、换属性、副手动画、攻击包标记全交给它。伤害、附魔、耐久、服务端判定
都按副手武器算，凡是它认可的武器（带攻击力的物品）都能放副手用。

## 特性

- **双手交替**：按住左键自动轮流出手，节奏跟随主手的攻击速度。
- **右键恢复原版**：关闭副手战斗的右键副手攻击（可开关），交互、喂食、放置方块都恢复
  正常，不会再莫名打一下。
- **认识 Better Combat**：被它接管的武器不会被重复驱动；主手归它时，只补一记缺失的副手。
- **兼容自动攻击**：装了 Auto Attack 也没关系，它的按键处理会在运行时被接管，不会双打。
- **不改别人的 jar**：逻辑全在本 mod 内（两个小 mixin），两个原 mod 一个字节没动。

## 前置

| | |
|---|---|
| Minecraft | 1.20.1 |
| Forge | 47.x |
| Off Hand Combat | 2.0.0+（必需） |