How to add a new Hero

Follow these steps to add a new hero to the project.

Importing assets

First, you’ll need to import the following assets for your hero:

• 3D model of the hero

• Animations

• Texture

• Armory sprite (icon)

Required animations:

• Idle

• Run

• Defeat

• Shoot (one for each weapon type)

Optional but recommended animations:

• Walking

• Walking Without Weapon

• Running Without Weapon

• Idle Without Weapon

• Revive

Folder setup

1. Inside Assets/The Archer/Models/Heroes, create a new folder named after your hero. Import the 3D model and animation clips there.

2. Inside Assets/The Archer/Textures/Heroes, import your hero’s texture.

3. Inside Assets/The Archer/Sprites/UI/Armory, import your hero’s sprite and set its Texture Type to Sprite (2D and UI) in the Inspector.

Configuring animations

1. Open each animation file and select it's Animation tab.

1. Ensure there are no warnings or errors under the Import Messages section.

1. For Idle, Walking, and Running animations, enable the Loop Time toggle.

1. For Walking and Running animations:

   • Open the Events section.

   • Add animation events whenever the hero’s feet touch the ground.

   • Set the function name to Step.

1. For the Defeat animation, add an event near the end of the animation with the function OnDefeatAnimationEnded.

1. If you have a Revive animation, add OnReviveAnimationEnded near its end.

   If you don’t have a revive animation, add that event near the start of the Defeat animation — it will be played in reverse to simulate revival.

1. For every Shoot animation, add an event with the function Shoot at the frame where the projectile should be spawned.

Animator Setup

As mentioned in the Hero Overview, actual animation clips are not stored inside the Hero Animator asset. If you have only the standard animation set, you can skip this step.

1. Clone the base Hero Animator, rename it, and place it near your hero’s model folder.

2. If you don’t have revive animation:

   • Select the Revive state in the Animator.

   • In the Motion field, assign the Hero Defeat clip.

   • Set its Speed to -1 (to play it in reverse).

1. Movement with and without weapon are blend trees of three animations.

   If you don’t have a Walking animation, remove it from the blend tree.

Configuring Animation Sets

1. Open Assets/The Archer/Scriptables/Armory/Items/Animation Sets.

1. Clone one of the existing animation set assets for each weapon type.

2. Assign your hero’s animations in each asset and remove any unused clips.

   Make sure every animation used in your Animator has a corresponding entry here.

You’ll finalize these sets later when connecting them to the hero’s data.

Creating Hero Prefab

1. Go to Assets/The Archer/Prefabs/Player/Heroes.

1. Clone an existing hero prefab and open it.

2. Inside the model hierarchy, find Left Weapon Parent and Right Weapon Parent, and move them to the prefab’s root.

1. Delete the old hero model.

2. Drag and drop your new hero model into the prefab.

3. Select it and assign your Animator Controller from the previous step.

4. Add the HeroEventsHandler component to your model.

1. Reattach the Weapon Parents (from step 3) to the correct hand bones.

2. In Assets/The Archer/Materials/Heroes, create a new material for your hero.

   • Use the October Shader to enable custom rim effects.

   • Assign your hero’s texture and configure parameters as needed.

3. Assign this material to your hero’s model.

4. Select the root GameObject and assign its Animator field to the one used by your model.

Creating Hero Data

1. Open Assets/The Archer/Scriptables/Armory/Heroes.

2. Clone an existing Hero Data asset, or create a new one via: Right-click → Create → October → Armory → Hero Data.

3. Fill in the hero’s properties:

   • Name

   • Icon (the Armory sprite you imported)

   • Prefab (your newly created hero prefab)

   • Upgrade levels, HP, and Damage stats (you can fill these in now or later)

   Ensure at least one upgrade level is defined.

1. Open Assets/The Archer/Scriptables/Armory and select the Armory Database asset.

2. Add your new Hero Data asset to the Heroes List.

1. Assign the Animation Sets you configured earlier in the grid at the bottom of the Armory Database, next to your hero’s name.

That’s it! When you launch the game, your new hero should now appear in the Armory Page of the Main Menu and be fully playable.