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.
- Open your model pack's ysm.json file.
- Locate the animation object.
- Add the "parcool" key pointing to "animations/parcool.animation.json".
- 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"
}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.