CompatLink – Epic Fight Weapons Compat Mod (1.21.1, 1.20.1)

CompatLink – Epic Fight Weapons Compat Mod extends Epic Fight with custom JSON mappings for modded weapons. Out of the box, that combat system only recognizes vanilla gear. This mod connects claymores to greatsword swings, katanas to uchigatana draws, and modded spears to proper thrust attacks without any coding. It also fixes broken modded armor textures in battle mode so every piece of gear renders clearly during fights.

Features:

• Custom Weapon Movesets: Connects any item or modded weapon to built-in weapon types like sword, greatsword, longsword, uchigatana, tachi, spear, dagger, axe, and bow.
• Addon Moveset Sharing: Borrows weapon presets and attack animations registered by other combat addon mods so any item in your modpack can use them.
• Battle Mode Armor Fix: Repairs garbled or invisible 64×64 modded armor textures in battle mode by generating a corrected vanilla-shaped mesh automatically.
• Automatic Swing Trails: Gives mapped weapons matching swing trails right away, with JSON options to customize trail colors and particles or turn them off per weapon.
• Maps all items from a mod in one line with wildcards like somemod:* while letting exact item IDs or higher priority rules override single weapons.
• Skips non-armor items and armor that already renders properly when using wildcards, though mods that already have dedicated 3D armor compat mods should not be listed in the armor fix.
• Gives modded mobs combat AI and attack animations when mapped to a preset that shares the exact same model family and texture layout.
• Ignores mistyped or broken mapping files and writes the reason to the log so a bad JSON file never crashes the game.
• Loads safely even if the main combat mod is missing, waiting until it is installed to apply your mappings.
• Reads mapping files from both the config folder and datapacks placed at data/<your_namespace>/compatlink/mappings/*.json.

Commands:

• /reload: applies new or edited weapon and mob JSON mappings while the game is running.

Configuration:

• config/compatlink/mappings/: stores your custom JSON mapping files and creates an example file on first launch.
• config/compatlink/settings.json: turns off automatic swing trails globally when you set "auto_trails": false.

Example weapon mapping file (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" }
  ]
}

Example battle mode armor fix:

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

How to Use:

1. Start Minecraft once so the mod creates the config/compatlink/mappings/ folder with an example file.
2. Create a JSON file such as mymappings.json inside that folder and enter your target weapon or armor IDs.
3. Run /reload in chat or restart the game to apply weapon movesets.
4. Press F3+T or relaunch the game to reload resources after adding a battle mode armor fix.
5. Install the mod and place the exact same JSON mapping files on both the client and server when playing on a dedicated server.

Requirements:

Minecraft Forge RequiredNeoForge RequiredEpic Fight Indestructible Mod Required

CompatLink Download Links