epicnpc: Bringing EpicFight Combat to CustomNPC Characters
If you have ever tried to combine two of Minecraft's most popular character mods, you already know the frustration. CustomNPC lets you build detailed, scripted characters for quests, shops, and storylines, while EpicFight transforms vanilla combat into a fluid, animation-driven brawler. On their own, each mod is excellent. Together, they simply refuse to cooperate. That is exactly the gap epicnpc was built to fill.
This lightweight add-on patches the connection between the two systems so your CustomNPC characters can trigger EpicFight animations, skills, and combat logic. Instead of watching your carefully designed boss stand frozen in a default pose, you get sweeping sword arcs, guard breaks, and hit reactions. For map makers and RPG server owners, it is a genuine quality-of-life upgrade.
What epicnpc Actually Does
At its core, epicnpc for Minecraft adds a patch layer and rewrites part of the rendering logic so CustomNPC models display correctly when EpicFight's animation system takes over. The mod also exposes a small API that lets CustomNPC scripts call EpicFight methods that would otherwise be unreachable.
The reason those methods are unreachable is technical but worth understanding. EpicFight contains functions that reference client-only classes without marking them as client-only. When a CustomNPC script tries to call them directly, the game throws an error because the server side cannot resolve those classes. epicnpc routes the call through an intermediary class, which sidesteps the problem entirely and lets your scripts run cleanly.
Supported Versions and Loader
The add-on targets the Forge loader and is built around the 1.16.5 era of Minecraft, which is where both CustomNPC and EpicFight see the most active modpack usage. If you run a 1.16.5 Forge server with both parent mods installed, epicnpc slots in without conflict. Always confirm that your CustomNPC and EpicFight builds match the version range listed on the release page before installing.
Rendering Caveats You Should Know
The mod does not add rendering to the NPCEntity itself. In practice, this means you should open the CustomNPC model settings and pick an existing model such as the zombie rather than leaving the entity blank. Doing so gives EpicFight a valid skeleton to animate.
Some models still behave oddly. The iron golem and the ender dragon are known problem cases, largely because their skeletons and proportions differ significantly from the standard biped rig EpicFight expects. If a particular model looks broken, swap it for a humanoid alternative and the animations will line up correctly. Fashion Workshop v2.0.4 is supported as well, so custom outfits render alongside the combat animations.
How to Install epicnpc
Getting the add-on running is straightforward if you already have a working mod setup.
- Install Minecraft Forge for your target version and confirm it launches.
- Place CustomNPC and EpicFight in your mods folder, then launch once to verify both load.
- Download epicnpc from its release page and drop the jar into the same mods folder.
- Restart the game and check the mod list to confirm epicnpc appears without errors.
- Open a CustomNPC character, set a compatible model such as the zombie, and test an animation through a script.
When you download epicnpc, keep the jar version aligned with your Forge build. Mismatched versions are the most common cause of startup crashes, and the fix is usually as simple as grabbing the matching release.
If you prefer a smoother setup, the foxygame.net launcher bundles epicnpc inside its add-on catalog, so you can enable it with a single click and let the launcher handle updates and version matching automatically.
Scripting Animations with the API
Once installed, you can trigger EpicFight animations from a CustomNPC script. A typical example defines a resource location pointing to an EpicFight animation file, then calls the play method on the NPC's underlying entity inside an interact function. This lets a guard NPC perform a longsword guard hit animation the moment a player right-clicks them.
The API constant that matters most is the one that avoids client-only calls. By referencing it through the provided tool class, your script stays safe on both sides of the game and avoids the class resolution errors that plague direct calls.
A Note on Maintenance
The original project has been marked as abandoned, and the author now recommends a successor mod, Epic Fight Script Extension, for ongoing development. That does not make epicnpc useless. For players running older 1.16.5 Forge packs where the successor is not compatible, epicnpc remains a practical solution that works today.
Final Thoughts
epicnpc solves a very specific but very real problem: making two beloved Minecraft mods talk to each other. If you want CustomNPC characters that move, fight, and animate with EpicFight's signature style, this add-on is the missing link. Set your models correctly, match your versions, and your NPCs will finally feel alive.