# Hand Ik

A `StateMachineBehaviour` that toggles hand IK and switches hand targets at precise moments during an animation. Integrates with any component implementing `IHandIK`.

✅ **Requires**:

* At least one `IHandIK` component on the Animator’s children or parent (e.g., `FishingRod` or custom IK handler).

🔧 **Inspector Settings**

<figure><img src="https://2707882048-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F7extQzUzohv5ZZCgCVG8%2Fuploads%2FvfgsqxVREd2lOwp5Jhss%2Fimage.png?alt=media&#x26;token=854732b2-fe3d-4f09-b232-3b96e90c70fa" alt="" width="443"><figcaption></figcaption></figure>

**Target IK State**

* **Enable**: Activates hand IK.
* **Disable**: Deactivates hand IK.

**Hand Target Switching**

* **Right Hand Switch**:
  * *Don’t Switch* (default)
  * *Switch to Default*
  * *Switch to Handle*
* **Left Hand Switch**:
  * *Don’t Switch* (default)
  * *Switch to Default*
  * *Switch to Reel Pose*

**Activation Triggers**

* **Execute on State Enter**: Applies IK/targets immediately when animation starts.
* **Execute on State Exit**: Applies IK/targets when animation ends (skips self-transitions).
* **Execute on State Update**: Fires at a specific animation time.
  * **Activation Time** *(0 – 1)*: When during the animation to trigger (only visible if *Execute on State Update* is enabled).

📈 **Key Behavior**

This is used in conjuntion with [**Malbers IK system**](https://malbersanimations.gitbook.io/animal-controller/secondary-components/ik-manager) to have fine control ever when we want hand IK to be enabled or disable, it has controls for both left and right hand individually.

<figure><img src="https://2707882048-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F7extQzUzohv5ZZCgCVG8%2Fuploads%2FzzwyBi6KNh9m45NCy0Sk%2Fimage.png?alt=media&#x26;token=e56c0f34-51a8-4be4-b020-f0d67fd623b7" alt="" width="309"><figcaption></figcaption></figure>

{% hint style="warning" %}
Important: You will need to add curves named *IKLeftHand* and/or *IKRightHand* in a animation clip in order to make it compatible with the *IK System*
{% endhint %}

<div align="center"><figure><img src="https://2707882048-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F7extQzUzohv5ZZCgCVG8%2Fuploads%2FGpbeHxIjg8ikXeVLNhii%2Fimage.png?alt=media&#x26;token=9c05e9f1-d9bb-4dc1-aaf9-185d2e6a8122" alt="" width="450"><figcaption></figcaption></figure></div>

💡 **Notes**

* Designed for fishing-specific poses: e.g., enable IK when reeling, switch right hand to rod handle, left to reel grip.
* Activation Time uses normalized time, so it’s frame-rate and speed-independent.
* [**RodIK** ](https://sunfish-studios.gitbook.io/fishing-for-animal-controller/secondary-components/rod-ik)implements *IHandIK.*
