Add Custom Animated Weapons Using Datapacks

Creating Custom Weapon Definitions

If you're using gun addons or custom firearms, you can define their combat animations by creating datapack entries. The mod provides a system for assigning weapon classes and animations to new guns without needing code modifications.

Steps to Define a Custom Weapon

1. Create or edit a datapack in your world's datapacks folder

2. Locate or create the mod's configuration directory for weapon definitions

3. Specify the weapon's ID (matching the gun mod's internal name)

4. Assign a combat class (pistol, rifle, bazooka, mini_gun, or grenade)

5. Test in-game to verify animations play correctly

Tips for Custom Weapons

Consult the mod's documentation for the exact datapack format and file structure. Match the weapon's real-world characteristics to its class—a heavy sniper rifle should use the rifle class, while a sidearm should use pistol. If animations don't apply, double-check that the weapon ID matches exactly. The mod automatically applies animations once the definition is recognized.