Gun animations for TaCZ and Superb Warfare
Yes Steve Model includes built-in animation support for popular firearm mods, allowing your custom character models to hold, aim, reload, and fire weapons naturally. All gun animations are stored in a dedicated tac.animation.json file and use a split upper-body and lower-body system to save you animation work.
Supported Gun Mods and File Setup
YSM supports three major firearm mods across different Minecraft versions: Timeless and Classics Guns (TaC) for Forge 1.16.5 and 1.18.2, Timeless and Classics Guns: Zero (TaCZ) for Forge 1.18.2–1.20.1 and Fabric 1.20.1–1.21.1, and Superb Warfare for Forge and NeoForge 1.20.1.
For historical reasons and backward compatibility with older YSM models, all three mods share the same tac.animation.json file and use the tac: prefix for every animation name. When a player holds a gun from any of these mods, YSM automatically reads from this file.
Weapons are grouped into three broad categories: pistols (pistol), rifles (rifle), and rocket launchers (rpg). Most animations are split into upper-body and lower-body layers, which drastically reduces the number of animations you need to create because one set of leg movements works with every gun type.
Lower-Body Animations
Lower-body animations control only the legs and hips while the player is holding a firearm. Because leg movement does not change much between holding a pistol or a rifle, you only need to animate three basic states.
Make sure you only keyframe lower-body bones in these animations so they do not conflict with the upper-body aiming and firing poses.
tac:idle - Lower-body idle pose while holding a weapon
tac:walk - Lower-body walking animation while holding a weapon
tac:run - Lower-body sprinting animation while holding a weaponUpper-Body Holding, Aiming, and Firing
Upper-body animations control the torso, head, and arms while blended on top of the lower-body movement. Each action has three variants corresponding to the weapon category: :pistol, :rifle, and :rpg.
There are distinct animations for holding a gun at the hip (hold), firing from the hip (hold:fire), aiming down sights (aim), and firing while aimed (aim:fire).
tac:hold:pistol - Holding a pistol (idle upper body)
tac:hold:rifle - Holding a rifle
tac:hold:rpg - Holding an RPG
tac:hold:fire:pistol - Hip-firing a pistol
tac:hold:fire:rifle - Hip-firing a rifle
tac:hold:fire:rpg - Hip-firing an RPG
tac:aim:pistol - Aiming down sights with a pistol
tac:aim:rifle - Aiming down sights with a rifle
tac:aim:rpg - Aiming down sights with an RPG
tac:aim:fire:pistol - Firing while aiming a pistol
tac:aim:fire:rifle - Firing while aiming a rifle
tac:aim:fire:rpg - Firing while aiming an RPGUpper-Body Reload, Sprint, and Melee
In addition to shooting, the upper body handles reloading, sprinting stances, and weapon melee attacks. For example, during a sprint, tac:run plays on the legs while tac:run:rifle plays on the arms and torso.
Just like the aiming poses, only keyframe the upper-body bones in these animations so the legs can continue walking or standing freely.
tac:reload:pistol - Reloading a pistol
tac:reload:rifle - Reloading a rifle
tac:reload:rpg - Reloading an RPG
tac:run:pistol - Upper-body pose while sprinting with a pistol
tac:run:rifle - Upper-body pose while sprinting with a rifle
tac:run:rpg - Upper-body pose while sprinting with an RPG
tac:melee:pistol - Melee attack while holding a pistol
tac:melee:rifle - Melee attack while holding a rifle
tac:melee:rpg - Melee attack while holding an RPGFull-Body Prone, Crawling, and Grenade Animations
When a player lies prone or crawls on the ground, splitting the body into upper and lower layers no longer looks natural. Therefore, prone and crawling states are animated as full-body poses where you can keyframe every bone in the model.
Note the naming difference: climb refers to moving while prone (crawling), whereas climbing refers to staying still while prone (lying down) or firing from a prone position.
YSM also supports grenade throwing animations depending on whether the grenade is in the main hand or offhand.
tac:climb:pistol - Crawling while holding a pistol
tac:climb:rifle - Crawling while holding a rifle
tac:climb:rpg - Crawling while holding an RPG
tac:climbing:pistol - Lying prone while holding a pistol
tac:climbing:rifle - Lying prone while holding a rifle
tac:climbing:rpg - Lying prone while holding an RPG
tac:climbing:fire:pistol - Firing a pistol while lying prone
tac:climbing:fire:rifle - Firing a rifle while lying prone
tac:climbing:fire:rpg - Firing an RPG while lying prone
tac:mainhand:grenade - Throwing a grenade from the main hand
tac:offhand:grenade - Throwing a grenade from the offhandTargeting a Specific Gun ID
Sometimes a generic :rifle or :pistol animation does not fit a unique weapon. You can create custom animations for a specific firearm by replacing the category suffix with a $ followed by the gun identifier.
How you find that identifier depends on which gun mod you are targeting:
- For original TaC and Superb Warfare, each gun is a separate Minecraft item. Put the item ID after the $ symbol (for example, tac:ak47).
- For TaCZ (Timeless and Classics: Zero), all guns share a single base item and differentiate weapons using the GunId NBT tag. YSM automatically reads this NBT tag, so simply put the TaCZ GunId after the $ symbol.
- Replace :pistol, :rifle, or :rpg at the end of any upper-body or prone animation name with $.
tac:aim:fire$tac:ak47Questions
Do I need a different animation file for TaCZ or Superb Warfare?
No. For backward compatibility, original TaC, TaCZ, and Superb Warfare all use the exact same tac.animation.json file and the tac: animation prefix.
Why are my model's legs stiff when aiming or reloading?
You likely keyframed leg bones inside an upper-body animation like tac:aim:rifle or tac:reload:rifle. Remove leg keyframes from upper-body animations so tac:idle, tac:walk, and tac:run can control the lower body.
How do I make a custom animation for a single TaCZ weapon when all TaCZ guns share one item ID?
YSM reads the GunId field from the item's NBT data in TaCZ. Just write the GunId after the dollar sign (for example, tac:reload$) instead of the base item ID.