HeadMoveAimer MonoBehaviour
Overview
The HeadMoveAimer module moves the character head to align the center of the camera with the weapon sights. This can actually tilt the camera, providing a different effect to the standard WeaponMoveAimer
In The Scene View
With a gameobject selected that uses a HeadMoveAimer component, the aimer guide handle will be visible in the scene view. This is used to represent the aim point of the aimer, with the blue arrow pointing forwards, and the green arrow pointing up.
Inspector
Properties
| Name | Type | Description |
|---|---|---|
| Start Active | Boolean | Should this module register as the active aimer immediately on start. |
| Activation Mode | Dropdown | How does module activation work. Options are: Component means the component will be enabled / disabled - use this when you have multiple modules on an object such as the firearm root. GameObject activates / deactivates the object - use this for attachments where you want the geo to appear/disappear. |
| Aim Up Audio | AudioClip | An audio clip to play when the weapon is raised. |
| Aim Down Audio | AudioClip | An audio clip to play when the weapon is lowered. |
| Hip Accuracy Cap | Float | The highest accuracy the firearm can achieve while not aiming down sights. |
| Aimed Accuracy Cap | Float | The highest accuracy the firearm can achieve while aiming down sights. |
| Can Aim While Reloading | Boolean | Should the weapon be lowered when reloading or can it stay aimed. |
| On Aim Up | UnityEvent | An event called when the weapon is fully raised. |
| On Aim Down | UnityEvent | An event called when the weapon is fully lowered. |
| Root Transform | Transform | The root transform of the hierarchy (should align with the camera). |
| Aim Offset | Transform | A target aim transform. The camera will be moved to align it to this transform when aiming down sights. Offsets are calculated on Awake, so moving this transform at after this point has no effect. |
| Aim Position Offset | Vector3 | The offset for the camera transform to move to align the weapon sights with the camera. This property will only be visible if no AimOffset transform is set. |
| Aim Rotation Offset | Vector3 | An euler angle offset for the camera to move to align the weapon sights with the camera. This property will only be visible if no AimOffset transform is set. |
| Raycast Transform | Transform | An optional transform that will be used for raycasting weapon shots when aiming down sights (not using the camera aim transform). This ensures bullets hit exactly on the aim point when the optics are positioned above the barrel. |
| Fov Multiplier | Float | A multiplier for the camera FoV for aim zoom. |
| Input Multiplier | Float | A multiplier for the camera input when aiming down sights. By default, this value is locked to the FoV multiplier. Clicking the lock icon next to the 2 multipliers allows you to modify it separately for situations such as render texture scopes. |
| Aim Time | Float | The time it takes to reach full aim, or return to zero aim. |
| Position Spring Multiplier | Float | A multiplier for procedural spring position animation on the weapon. Used to reduce movement when the firearm is close to the camera. |
| Rotation Spring Multiplier | Float | A multiplier for procedural spring rotation animation on the weapon. Used to reduce movement when the firearm is close to the camera. |
| Aim Anim Bool | String | The animator parameter key for a bool used to control aiming state in animations. |
| Block Trigger | Boolean | If true then the gun cannot fire while transitioning in and out of aim mode. This is used to prevent gunshots interrupting the animation. This property will only be shown if the Aim Anim Bool property is true. |
| Crosshair Up | FpsCrosshair | The crosshair to show when aiming down sights. |
| Crosshair Down | FpsCrosshair | The crosshair to show when not aiming down sights. |