Back to mods
CompatLink - Epic Fight Weapons Compat project artwork

CurseForge · Minecraft mod

CompatLink - Epic Fight Weapons Compat

Give ANY modded weapon Epic Fight movesets — no coding, just JSON.

Choose a version Pick your version below, then grab the matching file.

Quick answer

Which CompatLink - Epic Fight Weapons Compat release should I use?

Updated 2 months ago
Latest stable file compatlink-1.3.0.jar
Game version 1.20.1
Loader Forge

CompatLink - Epic Fight Weapons Compat compatlink-1.3.0.jar targets 1.20.1 with Forge. The project page does not say whether this file belongs on the client, dedicated server, or both. No extra mods listed for this file.

Where it goes

Is CompatLink - Epic Fight Weapons Compat required on the client, server, or both?

The project page does not say whether this file belongs on the client, dedicated server, or both.

Client Source doesn’t say
Dedicated server Source doesn’t say
Loader for this release Forge
Required install it here Optional supported, not mandatory Not supported do not install here Source doesn’t say do not assume

The source does not explicitly classify this release as client-only or server-only.

What else does CompatLink - Epic Fight Weapons Compat compatlink-1.3.0.jar need?

compatlink-1.3.0.jar. Change the file and its required mods may change too.

No extra mods listed for this file

This file does not list any required mods. Do not add a library just because a different file uses it.

This file does not list any required or optional mods.

Before you install it

Add CompatLink - Epic Fight Weapons Compat without breaking your instance.

Built for CompatLink - Epic Fight Weapons Compat compatlink-1.3.0.jar. Pick another file and the loader, install side or required mods may change.

  1. 01

    Stick to this file

    Use compatlink-1.3.0.jar. It targets 1.20.1 with Forge; another release may have different loader, side or dependency requirements.

  2. 02

    Bring the mods it needs

    This file does not list any required mods. Do not add a library just because a different file uses it.

  3. 03

    Put it on the correct side

    The project page does not say whether this file belongs on the client, dedicated server, or both.

  4. 04

    Pick the file you checked

    Use the “Get this file” button beside compatlink-1.3.0.jar. It opens that exact file at the source.

About this project

What does CompatLink - Epic Fight Weapons Compat add?

CompatLink

Give ANY modded weapon Epic Fight movesets — no coding, just JSON.

Epic Fight only knows vanilla weapons out of the box. CompatLink lets you connect any modded weapon to an Epic Fight moveset by dropping a small JSON file in your config folder. Claymores swing like greatswords, katanas draw like uchigatana, spears thrust like spears — for any mod, in minutes.

  • Available for Forge 1.20.1 (Epic Fight 20.14.17+) and NeoForge 1.21.1 (Epic Fight 21.13+)

  • Any item, any Epic Fight moveset — including weapon types from other Epic Fight addon mods, not just the built-in ones

  • Swing trails, combat-stat tuning, and (experimental) mob movesets — all from the same JSON

  • New in 1.2.0 — fixes modded armor that renders broken in battle mode, with one line of JSON

  • 100% data-driven: no code, no datapack knowledge required for basic use

  • Safe by design: broken mapping files are skipped with a log message — never a crash

  • Loads fine without Epic Fight installed (mappings just wait until it's there)

For players & modpack makers: 30-second setup

  1. Install CompatLink (plus Epic Fight).

  2. Open config/compatlink/mappings/ — CompatLink creates it with an example on first run.

  3. Create mymappings.json:

{
  "format": 1,
  "backend": "epicfight",
  "weapons": [
    { "target": "simplyswords:iron_claymore", "preset": "epicfight:greatsword" },
    { "target": "cataclysm:the_incinerator",  "preset": "epicfight:greatsword" },
    { "target": "somemod:*_katana",           "preset": "epicfight:uchigatana" }
  ]
}
  1. Start the game (or run /reload). Done — the log prints

    CompatLink: N entity mappings, M weapon mappings applied.

Wildcards (somemod:*) and priorities (higher wins; exact id beats wildcard on ties) let you map whole mods in one line and override single items afterwards.

Available weapon presets include epicfight:sword, epicfight:greatsword, epicfight:longsword, epicfight:uchigatana, epicfight:tachi, epicfight:spear, epicfight:dagger, epicfight:axe, epicfight:bow and any weapon type added by Epic Fight datapacks.

Use movesets from other Epic Fight addons

A preset is just an Epic Fight weapon-type id, so you're not limited to the built-in ones — you can borrow movesets registered by other Epic Fight addon mods. Any item can take any moveset:

{
  "format": 1,
  "backend": "epicfight",
  "weapons": [
    { "target": "minecraft:golden_apple", "preset": "wom:ender_blaster" }
  ]
}

Here a plain golden apple picks up the full attack animations of the wom:ender_blaster weapon type from another addon. Whatever weapon types are registered in your modpack — Epic Fight's own or ones added by other mods — are all valid presets.

Weapon trails: mapped weapons automatically inherit their weapon type's Epic Fight swing trail — no extra setup. Add an explicit "trail" object to a mapping for a custom one (EF item_skins schema: color, begin_pos, end_pos, lifetime, interpolations, texture_path, particle_type). Opt a single weapon out with "trail": "none" (or false), or disable automatic trails entirely — so only weapons with an explicit "trail" object get one — by setting "auto_trails": false in config/compatlink/settings.json. Optional "params" tune EF weapon attributes (impact, armor_negation, max_strikes, damage_bonus, speed_bonus).

Fix broken modded armor in battle mode (NEW in 1.2.0)

In Epic Fight's battle mode, armor from many mods renders as a garbled, nearly invisible mess. Epic Fight falls back to a generic armor mesh whose UVs assume a vanilla 64x32 texture, so mods that use 64x64 armor textures (Ice and Fire CE and plenty of others) sample the wrong part of the sheet. One line of JSON fixes it:

{
  "format": 1,
  "backend": "epicfight",
  "armors": [
    { "target": "somemod:*" }
  ]
}

One exception: if a dedicated compat mod already restores that mod's armor (e.g. CompatLink: Ice and Fire CE, which rebuilds Ice and Fire armor with its original 3D shape), do not also list that mod here — a generated mesh takes priority over the better fix and silently replaces it with the vanilla silhouette.

No texture sizes, no preset — CompatLink measures each item's armor texture itself and generates a corrected mesh only where one is needed. Non-armor items and armor that already renders correctly are skipped automatically, so mod-wide wildcards are safe. Optional texture_width / texture_height are there if auto-detection ever fails. New files apply on the next resource reload (F3+T) or the next launch, and persist from then on.

The result is the vanilla armor silhouette wearing the mod's texture — mod-specific 3D armor shapes (face guards, wings, crests) don't show up in battle mode, the same treatment Epic Fight gives every non-GeckoLib armor. Client-side only, and Epic Fight must be installed. No Epic Fight asset is bundled: the base mesh is read from your own install at runtime.

For pack/mod authors: ship mappings as a datapack

Put mapping files at data/<your_namespace>/compatlink/mappings/*.json in any datapack or mod jar. They participate in /reload and merge with config-folder mappings under the same priority rules. Ready-made packs: CompatLink: Simply Swords (all 122 weapons mapped) — see the project page sidebar.

Entity mapping (EXPERIMENTAL)

You can also give mobs Epic Fight combat AI/animations with an entities array (e.g. map an illager-type boss to the minecraft:evoker preset). This is an experimental feature for advanced pack authors:

  • The preset must share the target's model family and texture layout — otherwise the mob renders broken (the game itself keeps working).

  • Validation is strict: if anything about a mapping can't be wired safely, CompatLink registers nothing for it and logs the reason.

FAQ

Does the server need it? The client? Both, on dedicated servers — install CompatLink (and the same mapping files) on client and server. In singleplayer one install is enough.

What happens if Epic Fight is missing? Nothing breaks. CompatLink loads, parses your files, and reports "backend 'epicfight' unavailable" in the log.

A mapping file has a typo — will my game crash? No. That one file is skipped and the reason is logged; everything else applies.

Can other combat mods be supported? The core API is a loader-agnostic, MIT-licensed backend SPI. Epic Fight is the first backend; NeoForge 1.21 support is on the roadmap.

Do weapon params do anything yet? Not yet — the field is parsed and reserved for future tuning (attributes, colliders).

Project description from CurseForge.

Pick your setup

CompatLink - Epic Fight Weapons Compat by Minecraft version and loader

Choose the version and loader you play, then open the matching release.

2 available setups

Check the dependencies, then try the file in a copied instance before changing a world you care about.

Recent files

CompatLink - Epic Fight Weapons Compat versions and loaders

11 of 11 releases match

Looking for an older file? The official CurseForge project page is in Resources.