Combat Punchy! Epic Fight x Punchy x Punchy!Moves

⚔ COMBAT PUNCHY ⚔

Epic Fight combat. Punchy movement. Automatic switching.

Minecraft 1.21.1 · NeoForge · Client-side

Combat Punchy brings Epic Fight, Punchy! and Punchy! Moves together, coordinating combat mode, first-person animations, body movement and third-person camera behavior.

Attack with a supported melee weapon to start fighting, or automatically ready yourself when an enemy hits you. Put your weapon away or take a breather to return to normal movement. Combat Punchy handles the transitions while keeping your animation preferences intact.

⚔ Reactive combat  ·  ✦ Natural movement  ·  ⚙ Configurable handoffs

⚔ Fight when you need to

Enter combat by attacking, rather than simply equipping a weapon. An eligible melee attack activates Epic Fight combat mode on that input. Holding your sword while exploring does not automatically change your mode.

• Attack to enter combat: Attack with an eligible Epic Fight melee weapon to activate combat mode.
• React when hit: Damage from another entity or projectile can activate combat even while you hold a tool, a non-weapon item or nothing at all.
• Switch away to leave combat: Selecting a tool, non-melee item or empty hand returns you to vanilla mode.
• Stay ready after a hit: Hit-triggered combat lets your currently selected tool or empty hand remain in combat until the timeout. Selecting another non-weapon still exits combat.

⌛ Take a breather between fights

After 7 seconds without combat activity by default, Combat Punchy returns you to vanilla mode—even if you are still holding your weapon.

• Attacks, active combat skills, guarding and receiving hits refresh the combat timer.
• Attack again to re-enter combat when the next fight starts.
• Keep normal block interactions: Mining and chopping do not trigger combat by default.
• Choose your own timing: Adjust the timeout or disable inactivity-based switching through the configuration.

✦ Your animations, working together

Combat Punchy coordinates which animation system takes control as your actions change. Punchy! can handle first-person movement and interactions between combat actions, while Epic Fight takes over for combat poses.

• Punchy! first-person animations: Normal movement, interactions and idle periods between combat actions.
• Epic Fight combat poses: Attacks, guarding, dodging and other combat actions take priority.
• Punchy! Moves handoffs: Moves yields its body animations and camera controls during Epic Fight combat, then resumes afterward.
• Native stance support: Preserves sheathed-katana and Ochs stances.
• Smoother transitions: A short, configurable first-person release delay reduces flickering between animation systems.
• Saved preferences: Retains your Punchy and Moves settings.

Version 1.1 also includes a dedicated attachment for Punchy! Moves animated facial features to follow Epic Fight’s combat head pose. See the compatibility notes below for its current verification status.

🗡 Weapon support

Combat Punchy recognizes eligible melee weapons through their Epic Fight weapon capabilities, including registered Weapons of Miracles (WOM) melee weapons.

• Registered melee weapons can trigger attack-based combat entry.
• Pickaxes, shovels, hoes, fishing rods, ranged weapons and shields do not trigger automatic melee activation.
• Axes with registered melee support remain eligible when attacking an entity or swinging into the air.
• Hit-triggered activation is independent: Receiving a qualifying hit can still activate combat while you hold a non-weapon.

⚙ Make it your own

Configure Combat Punchy through config/combatpunchy-client.toml. Enable the features you want and adjust how quickly the animation systems hand control back.

• Combat entry: Independently toggle attack-triggered and hit-triggered switching.
• Combat exit: Toggle item-switch exit, inactivity exit and starting in vanilla mode.
• Combat timer: Adjust the 7-second default timeout or disable it.
• Animation bridges: Toggle Punchy first-person, Moves body, camera and facial compatibility separately.
• Stances and transitions: Configure native stance handling and first-person transition timing.
• Block targeting: Optionally allow attack-triggered combat entry while targeting blocks.
• Master switch: Disable Combat Punchy’s automatic behavior and compatibility handoffs.

View all configuration options →

📦 Requirements

• Minecraft: 1.21.1
• NeoForge: 21.1.262 or newer within 21.1.x
• Epic Fight: 21.17.3.1 — required
• Punchy!: Optional first-person integration; versions from 2.8g up to, excluding, 3.2
• Punchy! Moves: Optional body, camera and facial integration; versions 1.0.3–1.0.5

Epic Fight is the only required gameplay mod. Punchy! and Punchy! Moves are optional integrations. Automatic combat mode switching also works with Epic Fight alone.

Combat Punchy is client-side. Epic Fight’s own multiplayer requirements and server mode-switching rules still apply.

⚠ Compatibility notes

• Use one compatibility solution: Epic Tweaks, Epic Punchy and the older TNK Combat Mode are incompatible with this addon. Combat Punchy supplies its own compatibility bridges.
• Hit-triggered switching happens after damage is reported: It cannot retroactively change the triggering hit’s damage or armor mitigation.
• Moves facial features: Version 1.1 includes a correction for displaced or duplicated facial features. Visual confirmation in Minecraft is still pending. Facial compatibility can be toggled separately in the configuration.

Follow the facial-rendering issue →

Source code ·
Wiki ·
Changelog ·
Report a bug

💬 Join the community

Questions, suggestions or compatibility issues? Join Towns & Kingdoms | Modding Hub for updates, discussion and support.

Developed by Mikaaah. Credit for the original combat and animation systems belongs to the creators of Epic Fight, Punchy!, Punchy! Moves and Weapons of Miracles.

🌐 Host your next adventure