Datapack Template Guide: How to Add Custom Modifiers
This template provides the folder structure and examples you need to add custom moveset modifiers to your weapons. Follow these steps to configure your own:
1. Defining the Modifier (tinkering folder)
This folder contains two subfolders: modifiers and tags.
-
Create the Modifier: Open the modifiers folder. Copy the contents of an existing modifier JSON file into a new file, then rename it to your desired modifier ID.
-
Right-Click Abilities: If your modifier is for a moveset with a right-click active skill, you must include the chargeable module in your JSON. (See antitheus.json for the exact syntax.)
-
Tagging: Open the JSON file inside the tags folder and add your new modifier ID to ensure it is properly associated with the moveset tags.
2. Setting Up Recipes (recipes folder)
-
Crafting Recipes: Navigate to recipes/tools/modifiers/slotless to define the recipe required to apply your newly created modifier.
-
Extraction Recipes (Optional): If you want players to be able to safely remove the modifier and recover their weapon, add an extraction recipe in the root of the recipes folder. Refer to the existing extraction JSON files for the correct syntax.
-
If you don't know the exact registry name of an item for your recipes, hold the item in your main hand in-game and run this command:
/data get entity @s SelectedItem
3. Mapping the Moveset (modifier_profiles folder)
This folder acts as a bridge between your modifier and its corresponding Epic Fight moveset.
-
Create a new JSON file here and copy the syntax from the existing files to map your modifier to its corresponding animation set.
-
If you don't know the exact ID of an Epic Fight moveset, you can find it by opening the Datapack Editor GUI provided by Epic Fight in-game.
Roadmap
I plan to implement a custom Datapack Editor GUI for this mod in the future. This will make adding and managing custom moveset modifiers much easier and more intuitive directly in-game.