github.com/Antikythera-Studios/epicfight @21.16.4

Epic Fight adds complex game mechanics and fighting styles to your gameplay.
With a pinch of soulslike combat and unique animation handling that bends Minecraft,
Epic Fight will spice up your gameplay to a whole new level and bring great new challenges along the way.

You'll face a new take on Minecraft's combat,
where all entities have new and challenging fighting mechanics.

Controls

Tap to show/hide

• Vanilla Basic Attack | Epic Fight Basic Attack
  

• Dash Attack (Attack + Sprinting)
  

• Dodging (Left Alt, requires a Dodge Skill)
  

• Special Attack (Press Attack key)
  

• Toggle Epic Fight Mode (optional, initial key: R)
  

Toggling Epic Fight mode allows the player to disable the Epic Fight player model, animations, and combat mechanics while in-game.

Abilities

Tap to show/hide

Weapon & Armor

• Armor Negation: This percentage won't decrease the total damage by defense points.
• Impact: Increases the total stun time of the hit target.
• Hit N enemies per swing: Maximum number of hittable enemies per swing.
• 
• Weight: Shortens the stun time when hit, increases stamina consumption of skills, and decreases attack speed. Items with high attack speed are affected more.
• Stun Armor: Increases the time between stuns.

The Special Attack

Most weapons have a special attack. To use it, fill the special attack gauge by dealing damage to any entity with HP. Special attacks are more powerful than basic and dash attacks. You can see the tooltip of a special attack by pressing the special attack tooltip key (initial setting: P).

Enchantments

Sharpness

Increases damage to every type of attack.

Sweeping Edge

Increases special attack damage (50% | 67% | 75%).

Knockback

Increases stun time.

Restrictions

• Two-handed weapons cannot be held in the offhand and disable offhand functionality.

Weapon Combination

Some weapons have different attack styles depending on what is held in the offhand. Basic attack animations and special attacks change accordingly. Try the various attack styles!

Stun

All animated attacks stun the target for a short time, including the player. You can't control your character during this time. Stun Armor and Weight points help protect yourself.

• Stun Armor & Weight: Acquired by equipping armors. Higher-value armor grants more Stun Armor points.

Stamina & Skills

You can learn skills through the skill book (found in dungeon chests or dropped from hostile mobs). Skills are classified into three types:

• Dodge Skills: Consume stamina; stamina is displayed in the bottom-right corner.
• Guard Skills: Consume stamina; block attacks like shields but have a short stun time.
• Passive Skills: Automatically applied when their conditions are met.

FAQ

Tap to show/hide

• Making different mods compatible
  Achieving compatibility can be complex and may require Java knowledge.
  If you are a mod developer, refer to the API Guide for detailed instructions.
  Alternatively, you can explore the Epic Fight Wiki for additional guidance.

• Creating custom weapons or assigning weapon types to modded weapons
  Refer to the Item Capability Guide
  and the Weapon Type Editor Guide for detailed instructions.

• Patching custom modded entities to use Epic Fight animations and mechanics
  Refer to the Custom Entity Datapack Guide for instructions.
  For advanced cases, Java code may be necessary to fully patch an entity.

• Modded armor appears invisible or looks unusual
  Epic Fight changes the player model to support more complex animations.
  To make armor display correctly, a compatibility resource pack is required.
  If you're familiar with Blender or 3D modeling, check out this Epic Fight guide for detailed instructions.

• Backport the latest Epic Fight update to older Minecraft versions?
  There are currently no plans to backport newer Epic Fight features to older Minecraft versions, due to the major code differences between versions and the maintenance burden it would create for developers.

• Any plans to make a Bedrock version?
  Minecraft Bedrock is completely different from Java Edition.

• New Translations?
  In the future, new translations will be added. Currently, only verified members can submit translations, so adding new languages takes time.

Support & Affiliates

🔧 Compatibility

✅ Fully Supported and Compatible Mods

Tap to show/hide

• Epic Fight: Skill Tree
• Controlify
• ParCool
• Sodium
• Iris Shaders
• 3D Skin Layers
• Shoulder Surfing Reloaded
• playerAnimator
• Geckolib
• AzureLib
• First-person Model
• KubeJS

⚠️ Incompatible Mods

Tap to show/hide

• Optifine (closed-source mod)
• Controllable

🐞 Bug Reports

If you encounter any crashes or bugs in Epic Fight:

1. Reproduce the issue in a fresh Minecraft instance with as few mods as possible.
2. Generate a crash/log report using mclo.gs.
3. Submit the report by sending the link along with detailed relevant information (e.g., Epic Fight version) to this GitHub repository.

⚠️ Important: Always reproduce the crash or bug with a minimal set of mods.
Sharing reports from instances with 100+ mods makes it nearly impossible to debug each mod individually due to the high volume of reports and limited resources.

Note: We only address issues and bugs that originate from Epic Fight itself.

Official Integrations/Addons

Skill Tree

The Epic Fight: Skill Tree is an official first-party addon developed by the Epic Fight team to replace the Skill Book Items system with a Skill Tree, providing a more RPG-focused experience.

ParCool

The Epic ParCool mod is an official addon developed in collaboration with the ParCool project authors.

📚 WIKI

For detailed information on Epic Fight, including skills, recipes, API and Blender guides, custom trails, weapon or entity patches, armor fixes, resource pack integrations and more, visit the Epic Fight WIKI.

Contributing

For contribution guidelines, please refer to the Contributing Guide.

License

• Source Code (Java, Kotlin, C++, C, Groovy, etc.): GNU GPLv3

  • Applies only to the source code in this repository.

• Assets (images, models, textures, sounds, translations, animations, native libraries, etc.): All Rights Reserved

  • Applies only to the mod assets (under src/main/resources/assets) in this repository.

You CAN

• Use this mod in a modpack.
• Write your own code that uses this code as a dependency (such as addons, resource packs or datapacks).
• Submit Pull Requests to this repository.
• Fork and modify the code as long as modifications are not distributed publicly.
• Third-party redistribution is allowed only if all the following conditions are met:
  • All assets under src/main/resources/assets are removed and replaced with custom, original-made assets.
  • The mod and project use a different name to avoid confusion with Epic Fight.
  • Credit and a link to the original Epic Fight project are provided.
  • You grant the Epic Fight project a non-exclusive, royalty-free, worldwide license to use, copy, modify, and distribute your modifications, provided that appropriate credit or attribution is given to you.

You CANNOT

• Redistribute ANY assets from this mod (located under src/main/resources/assets).
  • Note: You may replace all original assets with your own to redistribute your fork publicly.
• Sell addons, mods, or other derivative works that use any Epic Fight assets, including but not limited to animations, textures, sounds, or models.

Disclaimer

_{THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.}

To comply with the Minecraft Essential guidelines, the following disclaimer is included:

NOT AN OFFICIAL MINECRAFT PRODUCT. THIS PRODUCT IS NOT APPROVED BY OR ASSOCIATED WITH MOJANG AND/OR MICROSOFT, NOR ASSOCIATED TRADEMARKS / PRODUCTS.