# Invector Templates
## Asset Location
{% hint style="info" %}
## [**Basic Template**](https://assetstore.unity.com/packages/templates/systems/third-person-controller-basic-locomotion-template-59332) **|** [**Melee Template**](https://assetstore.unity.com/packages/templates/systems/third-person-controller-melee-combat-template-44227) **|** [**Shooter Template**](https://assetstore.unity.com/packages/templates/systems/third-person-controller-shooter-template-84583?aid=1100lHT6)
{% endhint %}
{% hint style="info" %}
### Remember to have both packages on your project installed correctly. Use always the latest verions
{% endhint %}
## **IMPORTANT CHANGES (Only version 4.4.9a HAP)**
New Settings to be Aware:
Change the Input Value from \[F] to \[E] to match the mounting UI
Weapon Manager -> External -> Ignore Parent weapon to **True**. Invector is the one Parenting the Weapons, not me (Malbers scripts)
Rider -> Set Collider Modifier to **is Trigger** and Right Click to **Internal Colliders -> Find Internal Colliders**
***
## **Install the Integration Package**
**1.-** Download from the[ **Integration Drive Folder** ](https://drive.google.com/drive/folders/0B3A6xDqyh3aYcFBjRTBIdWVFU1E?resourcekey=0-AOW96xpkf053CSFX1gEJtw\&usp=sharing)the package of the Template you own (Basic, Melee, or Shooter).
**2.-** Install/Drop the **unitypackage** to your project.
{% hint style="success" %}
You can test the Integrations **Demo Scenes** on each Template Folder:
{% endhint %}
**`Malbers Animations/Horse AnimSet Pro/Integrations/Invector`**
{% hint style="warning" %}
**IMPORTANT:**\
As part of the integration package all Invectors weapons **prefabs** that can be used with HAP, are modified and they have a **MWeapon** component; so they can be recognized by the Riding Combat System.
{% endhint %}
## **General Integration Steps**
{% hint style="info" %}
If you want to check how the final integration with the **Basic Template**: open the Demo Scene: **v3rdPersonController - HAP** on the HAP Integration Folder.
{% endhint %}
To create a new integration from scratch you need to do the following steps...
#### These steps are also included in the **Melee Template** and the **Shooter Template**, but with small changes.
{% hint style="success" %}
#### Use emoji variation if you are using a different Template:
* :person\_walking: for **Basic** Template
* :crossed\_swords: for **Melee** Template
* :gun: for **Shooter** Template
{% endhint %}
**1.-** Open the Demo Scene on the Invector Demo folders:
* :person\_walking: **v3rdPersonConroller\_Demo**
* :crossed\_swords: **vMeleeCombat\_DemoScene**
* :gun: **vShooterMelee\_DemoScene**
**2.-** Drag to the scene the **Horse Realistic** Prefab.
**3.-** Select the Character Controller Prefab:
* :person\_walking: **vBasicController**
* :crossed\_swords: **vMeleeController\_Inventory**
* :gun: **vShooterMeleeController**
**4.-** Change the Animator Controller:
* :person\_walking: from **Invector\@BasicLocomotion** to **Invector\@BasicLocomotion\_HAP**
* :crossed\_swords: from **Invector\@MeleeCombat\_Upperbody** to **Invector\@MeleeCombat\_HAP**
* :gun: from I**nvector\@ShooterMelee** to **Invector\@ShooterMelee\_HAP**
{% hint style="info" %}
This Animator already has the **Mount Layer** and the Rider **Animator Parameters** added. If you want to know how to add the **Mount Layer** to any Animator you can find out[ **HERE.**](https://malbersanimations.gitbook.io/animal-controller/annex/general-hap-integration#mounted-layer)
{% endhint %}
{% hint style="warning" %}
Make sure your Character Controller has the Animator set to Animate physics
{% endhint %}
### Mounted and Combat Layer
If by any chance you have modified your Animator Controller, or you are using other Animator Controllers Provided by Invector. you can always add the Mount Layer and Rider Combat Layers provided for the Riding system.
{% embed url="" %}
Adding Mount and Combat Layers to a new Animator
{% endembed %}
### Rider Component
**5.-** Add the **MRider** script to your Character controller.
**6.-** If you are using a "Custom Input System" you'll need to connect [**MRider.MountAnimal()**](https://malbersanimations.gitbook.io/animal-controller/riding/mrider/rider-mp#void-mountanimal) to your *Mount* Input, and [**MRider.DismountAnimal()**](https://malbersanimations.gitbook.io/animal-controller/riding/mrider/rider-mp#void-dismountanimal) to your *Dismount* Input. If you want to continue using my Malbers Input then use the Context Menu Create Mount Inputs.
This will create a [**MInput** ](https://malbersanimations.gitbook.io/animal-controller/main-components/malbers-input)component with 3 Inputs for the Rider (Mount, Dismount and Call Mount); and connect the events of the inputs to the proper methods.
You can change the *Type* from **Key** to **Input** and add those Inputs to the [**Unity Input Manager.**](https://docs.unity3d.com/Manual/class-InputManager.html)
Mount input connected to the method MRider.MountAnimal()
Dismount input connected to the method MRider.DismountAnimal()
**7.-** On Disable Components add the scripts that interfere with the logic while riding. (Usually is used for scripts that are not supposed to be active while the character is Riding. Like scripts that move and rotate the character, Ragdoll scripts, etc. Also are used to disable Inputs that are only supposed to be active when the character is not riding: Ex: a Crouch Input).
{% hint style="info" %}
In the case of Invector, it should be the **VFootStep**, **VRagdoll**, **VGenericAction**, **VLadder,** or any other you feel is necessary. Components that may interfere with the Riding system
{% endhint %}
### UI
**8.-** Add the **Mount UI** prefab to your current UI Canvas.
{% hint style="info" %}
The **Mount UI** notifies you when you can press the **Mount** and **Dismount** Inputs
{% endhint %}
**10.-** If you like you can also add to the UI canvas the **Slider Stamina** prefab and the **Slider Health** prefab to check the **health** and **stamina** of the horse.
### **Link Script**
{% hint style="success" %}
The Link script is the bridge between the Rider Component and Invector's templates. Allows the Rider to communicate with Invector's core Character Controller components. Disable features via code while the character is riding the animals and enabling them back when the character is back on foot
{% endhint %}
**11.-** Add the Invector **HAP Link** script to the Character.
* :person\_walking: With "Basic" Template add **Invector HAP Link** script
* :crossed\_swords: With "Melee" Template add **Invector HAP Melee Link** script
* :gun: With "Shooter" Template add **Invector HAP Shooter** **Link** script.
### **Camera Settings**
**12.-** Select the **ThirdPersonCamera** gameObject and change the *Camera State List* from:
* :person\_walking: **vBasicLocomotiont\@CameraState** to **vBasicLocomotiont\@CameraState\_HAP**
* :crossed\_swords: **vMeleeCombat\@CameraState** to **vMeleeCombat\@CameraState\_HAP**
* :gun: **vShooterMelee\@CameraState** to **vShooterMelee\@CameraState\_HAP**
{% hint style="success" %}
This new state list contains the Camera State **Ride** used when the character is riding the horse.
{% endhint %}
**13.-** Add the [**MEventListener** ](https://malbersanimations.gitbook.io/animal-controller/scriptable-architecture/scriptables/mevent-listener)component to the **ThirdPersonCamera**.
**14.-** Create a new Event Listener and select the Event Set Camera Settings
**15.-** *Enable* the **Transform (T) Listener** and *disable* the **Void Listener.** Create a new Unity Event Listener and drag the same game object to the Runtime Only Slot.
**16.-** Add the \*dynamic method `vThirdPersonCamera.Target()` to the Listener.
And that should be it… the basic controller should be able to ride the Horse.
## Melee Template
**For integrating the Melee Template you should follow the same steps of the** [**Basic Template**](https://docs.google.com/document/d/138DpSb2L8BsSDljrv37lGNQ85lPO8JzhWAZQC0uCxfs/edit#heading=h.m7kh3a75xomh) **but follow the Melee Template Steps.**
{% hint style="info" %}
**i**f you want to check how the final integration should look like you can open the Demo Scene: **vMeleeCombat HAP4.**
{% endhint %}
**The Extra Steps you should follow to complete the Melee Integration are the following:**
### Weapon Manager Component
Add the **Weapon Manager** Script.
{% hint style="info" %}
### Since we are using the **Animators** provided for the Integration package, is not necessary to Add the **\[**Combat Layers].
{% endhint %}
**But, if you want to learn how to add the Combat Layers check this video:**
{% embed url="" %}
### Inputs
If you are using a **Custom Input System** you will need to connect:
* `MWeaponManager.Set_Aim(bool)` to your **Aim** Input.
* `MWeaponManager.MainAttack(bool)` to your **MainAttack** Input.
* `MWeaponManager.SecondAttack(bool)` to your **SecondaryAttack** Input.
* `MWeaponManager.ReloadWeapon()` to your **Reload** Input.
But If you want to continue using [**Malbers Input** ](https://malbersanimations.gitbook.io/animal-controller/main-components/malbers-input)then use the Context Menu "Create Combat Inputs".
This automatically adds to the **MInput** Script, the Inputs needed for the Rider Combat and connects the inputs to the Weapon Manager methods.
You can change the *Type* from **Key** to **Input** and add those Inputs to the [**Unity Input Manager.**](https://docs.unity3d.com/Manual/class-InputManager.html)
### **Events**
Create the Combat Event Listeners by using the Context menu "Create Event Listeners".
This will automatically add the[ MEventListener](https://malbersanimations.gitbook.io/animal-controller/scriptable-architecture/scriptables/mevent-listener) component with the Events needed for the Rider Combat system to communicate/listen to external scripts in a non-dependant way.
This is used for Mobile Input on all HAP Demo Scenes. Skip this part if you are not using Mobile
### **No Equip Points**
In the **General** group -> **Weapons Equip Points;** Remove the **\[Left Hand]** and **\[Right Hand]** References and set to true the **\[Ignore Hand Offset]** Parameter.
{% hint style="info" %}
Invector System will be handling all the offsets and weapon parenting to the proper position.
{% endhint %}
### **Use External**
Select the **Holsters/Use External** and set **\[Use External]**
**\[Instantiate On Equip] = false** and **\[Destroy On Unequip] = false**
{% hint style="info" %}
Invector System will be handling all the weapon instances.
{% endhint %}
## Shooter Template
For integrating the **Shooter Template** you should follow the same steps as the [**General Steps**](#general-integration-steps) but follow the **Shooter Template** way.
Also, you need to follow the [**Melee Template**](#melee-template) Steps.
{% hint style="info" %}
If you want to check how the final integration should look like you can open the Demo Scene: **vShooterMelee Inventory HAP.**
{% endhint %}
**Make sure the Invector's Bow and Handgun have the Malbers Weapon component attached to it.**
Now the Controller should be able to use the pistol and the Bow weapons while riding the horse.
#### Next:
On the next page, check how the weapons are properly configured to be used with HAP
{% content-ref url="invector-templates/invector-weapon-settings" %}
[invector-weapon-settings](https://malbersanimations.gitbook.io/animal-controller/annex/integrations/invector-templates/invector-weapon-settings)
{% endcontent-ref %}
