Guide · Mod compatibility

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.

Place your tac.animation.json file in the exact same animations folder as your main.animation.json.

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 weapon

Upper-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 RPG

Upper-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 RPG

Full-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 offhand

Targeting 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:

  1. For original TaC and Superb Warfare, each gun is a separate Minecraft item. Put the item ID after the $ symbol (for example, tac:ak47).
  2. 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.
  3. Replace :pistol, :rifle, or :rpg at the end of any upper-body or prone animation name with $.
tac:aim:fire$tac:ak47
If no custom $-animation exists for the held gun, YSM automatically falls back to the general :pistol, :rifle, or :rpg animation.

Questions

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.

Next: Immersive Melodies Instrument Animations →

More in Mod compatibility

C
Better Combat Animations in Yes Steve ModelStarting from version 2.6.0, Yes Steve Model (YSM) features improved compatibility with the Better Combat mod. Weapon swings now properly trigger YSM animations without first-person head clipping issues, and creators can use new Molang variables to build custom, dynamic combat animation controllers.
C
Carry On Mod Compatibility AnimationsYes Steve Model (YSM) includes built-in animation support for the popular Carry On mod, which lets players pick up blocks, mobs, and other players by holding Shift and right-clicking. By adding a dedicated animation file to your model pack, you can create custom poses for both the carrier and the player being carried.
C
Immersive Melodies Instrument AnimationsSince version 2.6.0, Yes Steve Model (YSM) includes deep integration with the Immersive Melodies mod. This feature allows your custom character models to react dynamically to live performance data, such as note pitch, volume, and timing. By setting up these animations, your model can realistically strum, blow, or strike instruments in sync with the music.
C
Iron's Spells 'n Spellbooks AnimationsSince version 2.6.0, Yes Steve Model (YSM) supports custom spellcasting animations for the Iron's Spells 'n Spellbooks mod. By linking a dedicated animation file in your model configuration, your character can perform unique movements for projectiles, slashes, and long chants. This guide covers how to register the animation file and lists every available spell animation trigger.
C
ParCool Parkour AnimationsYes Steve Model (YSM) includes built-in compatibility for the ParCool mod starting since version 2.2.2, allowing custom models to display dynamic parkour movements. By linking a dedicated animation file in your configuration, you can customize wall runs, vaults, rolls, and flips to fit your character's unique proportions.
C
SlashBlade Animations GuideStarting from version 2.3.0, Yes Steve Model (YSM) includes native animation compatibility for the SlashBlade mod, supporting both the legacy SlashBlade and SlashBlade: Resharped. This guide covers how to set up the required bone locators in your model, register the animation file in your configuration, and use in-game debugging tools to identify specific sword skill animation names.