# Boss: Swiper (Code)

## 1. UNIT

### 1.1. Lua

We have several bosses already implemented which you should feel free to use as inspiration/reference. Also you can reference some other custom games which have boss fights including [Second Day of Frostivus][www.github.com/openangelarena/frostivus2017] where you will find our IO boss (designed by Yahnich).  Files should follow the structure already established in the components subfolders (abilities, boss, etc) and reference any necessary libraries (libraries and internal folders).

- Unit AI: The boss should utilize a thinker in order to attempt to cast spells from a sub-list of his spells but only if they are off cooldown. The sub-list of spells, the level of the spells, and their respective cooldowns, depends on the boss phase. Furthermore, in Phase 3 the boss should cast Deathly Apparition immediately before the wind-up of his other spells when possible. Finally, AOE spells should perform a calculation to attempt to hit as many units as possible and ranged spells should attempt to hit far away units, and this is discussed later under "Abilities".

### 1.2. KV

The following list of required unit properties to be outlined in KV is not exhaustive and coders should expand upon it as required.

- Armor: boss average
- Magic Resist: boss average
- Status Resist: boss average
- Hitpoints: boss average
- Hitpoint Regen: boss average
- Manapoints: boss average
- Manapoints Regen: boss average
- Attack Behavior: No auto attack
- XP Bounty:
- Gold Bounty:
- Inventory: Upgrade Core, Boss Heart
- Abilities: Thrust, Frontswipe, Backswipe, Reaper's Rush, Deathly Apparition
- All settings typical to other bosses which are relevant.

### 1.3. Tooltips

A tooltip file should be created and list

- Name: Sabnock
- Description: the Swordsman
- Lore: Demon.

### 1.4. Model & Animations

Temporary models are needed for the purposes of coding and testing the boss properly. The base boss model should be used from the pool of existing dota 2 models respecting considerations such as attack range and basic necessary animations. FollowEntity() or a similar wearables library-related method should be used to attach a temporary sword of some kind.

Range: Melee

### 1.5. Animations

- Additional ability animations detailed in Abilities section.

## 2. ABILITIES

All abilities should be telegraphed by a particle effect outlining the location, area, and general motion of the ability. Abilities require a significant "wind-up" animation to play accompanied by the creation of this targetting reticle particle before executing the damage, so players will learn to dodge his abilities. For the purposes of coding the basic boss, custom particles are not required, but a filler particle must be used. Particles can be hidden or commented out at the coder's discretion, but the particle code must be complete and working.

### 2.1. Lua

- Boss Resistance: Used by all bosses.

- Cliffwalking: Used by all bosses

- Thrust: Long range (~600u), targeting the ground at the location of a player furthest away from the boss up to a certain range. Damages in an AOE line.

- Frontswipe: Swing the sword in a 180-degree arc counter-clockwise. Short range (~200u), targetted to hit as many players as possible.

- Backswipe: Occasionally (~25%) and immediately follows frontswipe swinging the sword in a 180-degree clockwise arc. Short range (~200u).

- Reaper's Rush: Holds the sword to the right, perpendicular to his facing direction. Runs quickly to a far away location in the arena in the direction of the highest concentration of players. Players hit by the sword take massive damage. Enemies hit by the boss's body take moderate damage, are pushed away (~100u), and are slowed. Upon reaching his destination, swings the sword in a 360-degree arc counter-clockwise.

- Deathly Apparition: Blink into advantageous position (with lots of convenient targets nearby).

### 2.2. KV

KV should account for abilities with 3 levels corresponding to the 3 phases. Damage should increase per level. Cooldown should decrease per level.

- Thrust: Delay, Range, Width, Target_Max_Range, Target_Min_Range, Damage, Cooldown
- Frontswipe: Delay, Start_Angle, End_Angle, Range, Min_Targets, Target_Max_Range, Damage, Cooldown
- Backswipe: Delay, Start_Angle, End_Angle, Range, Damage, Cooldown
- Reaper's Rush: Delay, Speed, Max_Range, Min_Range, Min_Targets, Push_Length, Slow, Slow_Duration, Max_Damage, Min_Damage, Start_Angle, End_Angle, Cooldown
- Deathly Apparition: Range, Cooldown

### 2.3. Tooltip
- Name, Description, KV-entries, Lore

### 2.4. Icons
- Filler icons

### 2.5. Particles
Telegraph particles should accompany the wind-up animation and have a lifespan of approximately the same timespan.


### 2.6. Animations

If the following animations cannot be found in the same hero, get as close as you can with as many as you can:

- Run: With sword perpendicular to him (the model used should have a "special" run animation in addition to his normal run. Use that animation here. Animations can be viewed in the Dota 2 tools model editor)
- Ability: Thrust weapon forward
- Ability: Swipe weapon clockwise
- Ability: Swipe weapon Counterclockwise


## 3. MODIFIERS

### 3.1. Lua
- Slow Modifier: Units slowed by Rush should have a modifier indicating this
- Any other modifier required by previous coding.

### 3.2. Tooltip
- Name: Required.
- Description: Required. Should reference KV entry for any relevant values.

### 3.3. Icons
- Filler icons

### 3.4. Particles
- Overhead filler particle indicating slowed status

## 4. PHASES

### 4.1 Phase One
- Active while boss is between 100 and 75% HP
- Sub-list of abilities: Thrust, Frontswipe and Backswipe

### 4.2. Phase Two
- Active while boss is between <75% and 50% HP
- Sub-list of abilities: Thrust, Frontswipe, Backswipe, Rush
- Particle/Model: Boss model should gain an indicator particle or model modification to indicate that he is in stage 2

### 4.3. Phase Three
- Active while boss is between <50% and 0% HP
- Sub-list of abilities: Thrust, Frontswipe, Backswipe, Rush, Teleport
- Particle/Model: Boss model should gain an indicator particle or model modification to indicate that he is in stage 3