Skip to main content

​
Recoil Animation component

Recoil Animation is a component that generates smooth and fluid firing animations at runtime:
Recoil Animation component in the Unity Inspector

Recoil Animation component.

This component has 3 methods that need to be called in the shooting code.

​
Recoil Anim Data

Recoil parameters are defined in the RecoilAnimData — a Scriptable Object that you can create via right-click ▸ Create ▸ KINEMATION ▸ Procedural Recoil ▸ Recoil Data:
Recoil Anim Data properties in the Unity Inspector

Recoil Anim Data properties.

  • Pitch - max and min values for the pitch (up) rotation
  • Roll - max and min values for the roll rotation.
  • Yaw - max and min values for the yaw (right) rotation.
Roll and Yaw components are Vector4. That’s because of the way random values are calculated:Minimum value for Roll and Yaw is a random value in [X;Y] range, while the maximum value is in [Z;W] range.Aim Rot and Aim Loc define multipliers for each rotation and translation. Applied when aiming.

​
Recoil curves

There are 4 Vector curves in the data asset. Each curve animates the rotation or translation when auto or single firing.
Example semi-fire recoil curves

Example semi curves.

All curves must start and end with zero.
Here’s the difference between auto and semi curves:
Example automatic-fire recoil curve
Curves are almost identical. The only difference is that the Auto curve value is very close to zero at some point. This point is the delay between shots.
For example, a fire rate of 600 RPM has a delay of 0.1 seconds between shots. All auto curves must be close to 0 at 0.1 seconds.
When auto or burst mode is enabled, the curve length is set to the fire delay. The auto or burst curve is cropped to the delay between shots.

​
Apply recoil animation

Add the Recoil Animation component to the character’s prefab and apply the changes. Then, add a Modify Bone modifier to the Procedural Animation settings and bind the recoil OutRot and OutLoc values:
Modify Bone modifier bound to Recoil Animation outputs

Modify Bone and Recoil Animation.