Guide · Mod compatibility

ParCool Parkour Animations

Yes 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.

Overview and Version Compatibility

ParCool is a popular Minecraft mod that adds dozens of agile parkour actions to the player. YSM added compatibility support for ParCool starting in version 2.2.2, ensuring your custom models do not break or freeze when performing advanced movements.

Because several parkour actions distinguish between forward, backward, left, and right directions, you should always inspect the default model's parcool.animation.json file as a reference for exact animation sub-names.

As an extra benefit, the parcool:ride_zipline animation is also reused for riding chain conveyors in the Create mod, meaning setting up this animation covers two major mods at once.

Registering the ParCool Animation File

To add custom parkour animations to your model, you must declare the parcool key inside the animation block of your ysm.json file. This tells YSM where to look when the player triggers a ParCool movement.

Once declared, create your animation file at the specified path and use the default model's parcool.animation.json as a template.

  1. Open your model pack's ysm.json file.
  2. Locate the animation object.
  3. Add the "parcool" key pointing to "animations/parcool.animation.json".
  4. Place your customized parcool.animation.json inside your animations folder.
"animation": {
    "main": "animations/main.animation.json",
    "arm": "animations/arm.animation.json",
    "extra": "animations/extra.animation.json",
    "tac": "animations/tac.animation.json",
    "carryon": "animations/carryon.animation.json",
    "parcool": "animations/parcool.animation.json",
    "swem": "animations/swem.animation.json",
    "slashblade": "animations/slashblade.animation.json",
    "tlm": "animations/tlm.animation.json"
}
If your custom parkour animations do not play in-game, double-check that you properly declared the parcool path in ysm.json first.

Running, Swimming, and Vaulting Animations

These animations handle high-speed ground movement, water traversal, and clearing low obstacles. Remember to check the default parcool.animation.json for directional variants where applicable.

parcool:fast_running plays during ParCool's sprint, which moves slightly faster than vanilla running. parcool:fast_swim triggers when swimming at boosted ParCool speeds.

parcool:kong_vault and parcool:speed_vault are the two obstacle-clearing animations. ParCool splits vaulting into the two-handed monkey/kong vault and the one-handed speed vault.

parcool:sliding plays when performing a ground slide or slide tackle, while parcool:crawl is used for crawling (this matches vanilla crawling and generally does not require a newly built animation).

Wall and Cliff Interactions

Wall movements are essential for vertical traversal in ParCool. Many of these animations require holding specific keys while airborne against a surface.

parcool:wall_jump is the standard kick off a wall, while parcool:backward_wall_jump is designated for jumping backward off a wall. parcool:horizontal_wall_run and parcool:vertical_wall_run control running along or straight up vertical surfaces.

parcool:wall_slide is a static animation that plays when airborne players hold the wall-slide key (default Right-Click) against a wall to slow their fall for a safe landing.

For ledges, parcool:cling_to_cliff triggers when grabbing onto a cliff face (which supports left and right shimmying), parcool:climb_up plays when pulling yourself up over a wall, parcool:hang is used for hanging downwards, and parcool:jump_from_bar is listed for bar jumps.

Jumps, Flips, Rolls, andDodges

Acrobatic maneuvers and impact-recovery actions keep the player moving smoothly across gaps and drops. Timing on some of these animations is very brief, so snappy keyframes work best.

parcool:jump_charging and parcool:charge_jump work as a pair: pressing Shift charges up a high jump, and pressing Space releases the actual high jump.

parcool:cat_leap plays during a long precision pounce. parcool:dive_animation_host triggers when diving headfirst from a height, and parcool:dive_into_water is a very brief animation played when diving into water.

In the air or on the ground, parcool:flipping plays during mid-air somersaults, while parcool:dodge handles quick evasive dashes (often directional).

Upon landing, parcool:roll triggers a combat roll (visually distinct from flipping), and parcool:tap plays a quick landing buffer animation to absorb fall impact.

Questions

Why aren't my edited parkour animations showing up in-game?

In most cases, you forgot to declare the "parcool": "animations/parcool.animation.json" line inside the "animation" block of your ysm.json file.

Which version of YSM is required for ParCool support?

You need Yes Steve Model version 2.2.2 or newer for ParCool animation compatibility.

How do I handle animations that move left, right, forward, or backward?

Open the default model's parcool.animation.json file and inspect the exact animation names used there, as directional actions are split into specific sub-animations.

Does the ParCool animation file affect any other mods?

Yes. The parcool:ride_zipline animation is also reused by YSM when riding chain conveyors in the Create mod.

Next: SlashBlade Animations Guide →

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
Gun animations for TaCZ and Superb WarfareYes 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.
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
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.