@v12-engine/create 0.1.0 → 0.4.0

package/starters/melee/src/melee/heroes.ts

@@ -0,0 +1,1025 @@
+import {
+	type AbilityDef,
+	type AttackDef,
+	applyBuff,
+	type BuffDef,
+	type BuffInstance,
+	defineComponent,
+	defineEffect,
+	defineHook,
+	type EffectDef,
+	type EffectType,
+	type EffectValueContext,
+	type Entity,
+	hasBuff,
+	heroOf,
+	holdsUp,
+	type HookDef,
+	invalidateStats,
+	removeBuff,
+	type UnitTypeDef,
+	type World
+} from '@v12-engine/engine'
+
+/*
+ * The heroes: four of the Kingdom, trained at its altar, and four of the Restless at theirs; a tavern hires any of them
+ * (items-and-spells plan, phase 4). Each has callings (what it is good at, 1 to 3), an innate it has from level 1 that
+ * changes how it is played, three abilities and an ultimate that changes the shape of a fight, and two of the engine's
+ * hero spells (`defaultHeroSpells`). What they do is said in general words (heroes, creeps, buildings, allies, kills),
+ * so a hero fits a game of bases, a campaign and one of lanes alike. What the engine's fields do not say is done here in
+ * code: the hooks and the effect at the end of this file
+ */
+
+// the game's own effects, each with the fields it reads (`EffectTypes`)
+declare module '@v12-engine/engine' {
+	interface EffectTypes {
+		/** Lightning that leaps from where a spell went off to the nearest other enemy within `radius`: Static Charge */
+		staticArc: { amount: number; perLevel: number; radius: number }
+	}
+}
+
+/** What every hero grows by, a level: the stats of a fighter up close, of one from afar, of a caster */
+const GROWTH = {
+	melee: { stats: { health: 99, healthRegen: 0.1, mana: 55, manaRegen: 0.2, attackDamage: 3.5, armor: 4.3, magicResist: 2.05 }, percent: { attackSpeed: 0.02 } },
+	ranged: { stats: { health: 88, healthRegen: 0.09, mana: 40, manaRegen: 0.15, attackDamage: 3.4, armor: 3.8, magicResist: 1.5 }, percent: { attackSpeed: 0.03 } },
+	caster: { stats: { health: 85, healthRegen: 0.1, mana: 64, manaRegen: 0.2, attackDamage: 3, armor: 4, magicResist: 1.6 }, percent: { attackSpeed: 0.02 } }
+}
+
+/** What a hero of each side costs and takes to train or hire */
+const HERO = { kind: 'unit', radius: 0.5, sight: 12, inventory: 6, cost: { gold: 425, lumber: 100 }, supply: 5, buildTime: 45, threat: 3 } as const
+
+/** A hero's ranged attack of magic, a bolt that flies */
+const BOLT: AttackDef = { damageType: 'magic', damagePoint: 0.4, acquisitionRange: 8, projectileSpeed: 18, targets: ['ground', 'air'] }
+
+// ---- the Kingdom
+
+export const oathbreaker: UnitTypeDef = {
+	...HERO,
+	id: 'oathbreaker',
+	race: 'human',
+	name: 'Oathbreaker',
+	stats: { health: 660, healthRegen: 1.3, mana: 280, manaRegen: 1.6, attackDamage: 54, attackSpeed: 0.625, attackRange: 0.6, armor: 42, magicResist: 32, moveSpeed: 4.25 },
+	attacks: [{ damagePoint: 0.45, acquisitionRange: 8 }],
+	hero: {
+		growth: GROWTH.melee,
+		callings: { vanguard: 3, keeper: 1 },
+		innate: 'bulwark',
+		learns: ['oathCharge', 'shieldwall', 'ironResolve', 'lastStand'],
+		spells: ['flash', 'waystone']
+	},
+	hotkey: 'O'
+}
+
+export const dawnPriest: UnitTypeDef = {
+	...HERO,
+	id: 'dawnPriest',
+	race: 'human',
+	name: 'Dawn Priest',
+	stats: { health: 560, healthRegen: 1.1, mana: 480, manaRegen: 1.9, attackDamage: 46, attackSpeed: 0.65, attackRange: 6.5, armor: 22, magicResist: 32, moveSpeed: 4.1 },
+	attacks: [{ ...BOLT }],
+	hero: {
+		growth: GROWTH.caster,
+		callings: { keeper: 3, arcanist: 1 },
+		innate: 'mercysEcho',
+		innateLevels: [1, 4, 7, 10],
+		learns: ['holyLight', 'cleansingFlame', 'dawnlightAura', 'sanctuary'],
+		spells: ['secondWind', 'purify']
+	},
+	hotkey: 'D'
+}
+
+export const stormcaller: UnitTypeDef = {
+	...HERO,
+	id: 'stormcaller',
+	race: 'human',
+	name: 'Stormcaller',
+	stats: { health: 570, healthRegen: 1.1, mana: 400, manaRegen: 2.1, attackDamage: 52, attackSpeed: 0.625, attackRange: 6.9, armor: 26, magicResist: 30, moveSpeed: 4.1 },
+	attacks: [{ ...BOLT }],
+	hero: {
+		growth: GROWTH.caster,
+		callings: { arcanist: 3, binder: 2 },
+		innate: 'staticCharge',
+		learns: ['tornado', 'chainLightning', 'galeWard', 'eyeOfTheStorm'],
+		spells: ['flash', 'purify']
+	},
+	hotkey: 'S'
+}
+
+export const galeHunter: UnitTypeDef = {
+	...HERO,
+	id: 'galeHunter',
+	race: 'human',
+	name: 'Gale Hunter',
+	stats: { health: 540, healthRegen: 1, mana: 300, manaRegen: 1.4, attackDamage: 56, attackSpeed: 0.7, attackRange: 7.5, armor: 24, magicResist: 28, moveSpeed: 4.3 },
+	attacks: [{ damagePoint: 0.3, acquisitionRange: 9, projectileSpeed: 24, targets: ['ground', 'air'] }],
+	hero: {
+		growth: GROWTH.ranged,
+		callings: { ranger: 3, roamer: 1 },
+		innate: 'steadyAim',
+		learns: ['piercingBolt', 'tumble', 'huntsman', 'arrowstorm'],
+		spells: ['flash', 'barrier']
+	},
+	hotkey: 'G'
+}
+
+// ---- the Restless
+
+export const gravelord: UnitTypeDef = {
+	...HERO,
+	id: 'gravelord',
+	race: 'undead',
+	name: 'Gravelord',
+	// no mana: what he casts costs him health (Blood Tithe)
+	stats: { health: 700, healthRegen: 1.6, attackDamage: 54, attackSpeed: 0.65, attackRange: 0.6, armor: 38, magicResist: 32, moveSpeed: 4.4 },
+	attacks: [{ damagePoint: 0.45, acquisitionRange: 8 }],
+	hero: {
+		growth: { ...GROWTH.melee, stats: { ...GROWTH.melee.stats, mana: 0, manaRegen: 0, health: 108, healthRegen: 0.14 } },
+		callings: { reaver: 3, vanguard: 1, keeper: 1 },
+		innate: 'bloodTithe',
+		innateLevels: [1, 4, 7, 10],
+		learns: ['graveLash', 'siphon', 'deathlessAura', 'armyOfTheGrave'],
+		spells: ['phantomStride', 'brand']
+	},
+	hotkey: 'G'
+}
+
+export const rimeWitch: UnitTypeDef = {
+	...HERO,
+	id: 'rimeWitch',
+	race: 'undead',
+	name: 'Rime Witch',
+	stats: { health: 550, healthRegen: 0.9, mana: 420, manaRegen: 2, attackDamage: 44, attackSpeed: 0.6, attackRange: 6.5, armor: 24, magicResist: 30, moveSpeed: 4.1 },
+	attacks: [{ ...BOLT }],
+	hero: {
+		growth: GROWTH.caster,
+		callings: { binder: 3, arcanist: 2 },
+		innate: 'shatter',
+		innateLevels: [1, 5, 9],
+		learns: ['rimeBolt', 'grasp', 'hoarfrost', 'whiteout'],
+		spells: ['flash', 'barrier']
+	},
+	hotkey: 'R'
+}
+
+export const duskblade: UnitTypeDef = {
+	...HERO,
+	id: 'duskblade',
+	race: 'undead',
+	name: 'Duskblade',
+	stats: { health: 560, healthRegen: 1.1, mana: 300, manaRegen: 1.5, attackDamage: 50, attackSpeed: 0.8, attackRange: 0.6, armor: 30, magicResist: 28, moveSpeed: 4.5 },
+	attacks: [{ damagePoint: 0.3, acquisitionRange: 8 }],
+	hero: {
+		growth: { ...GROWTH.melee, percent: { attackSpeed: 0.03 } },
+		callings: { stalker: 3, roamer: 2 },
+		innate: 'shadowStep',
+		innateLevels: [1, 5, 9],
+		learns: ['duskMark', 'fade', 'twinFangs', 'eclipse'],
+		spells: ['flash', 'brand']
+	},
+	hotkey: 'D'
+}
+
+export const boneReaver: UnitTypeDef = {
+	...HERO,
+	id: 'boneReaver',
+	race: 'undead',
+	name: 'Bone Reaver',
+	stats: { health: 640, healthRegen: 1.4, mana: 260, manaRegen: 1.5, attackDamage: 55, attackSpeed: 0.65, attackRange: 0.6, armor: 36, magicResist: 30, moveSpeed: 4.35 },
+	attacks: [{ damagePoint: 0.45, acquisitionRange: 8 }],
+	hero: {
+		growth: GROWTH.melee,
+		callings: { roamer: 3, reaver: 2 },
+		innate: 'harvest',
+		meter: 'harvest',
+		learns: ['boneCleaver', 'gorge', 'carrionHunger', 'bonePit'],
+		spells: ['reap', 'phantomStride']
+	},
+	hotkey: 'B'
+}
+
+/** The Kingdom's four, trained at its altar */
+export const KINGDOM_HEROES = [oathbreaker, dawnPriest, stormcaller, galeHunter].map((hero) => hero.id)
+/** The Restless' four, raised at theirs */
+export const HOLLOW_HEROES = [gravelord, rimeWitch, duskblade, boneReaver].map((hero) => hero.id)
+
+export const heroes: UnitTypeDef[] = [oathbreaker, dawnPriest, stormcaller, galeHunter, gravelord, rimeWitch, duskblade, boneReaver]
+
+// ---- what they do
+
+/** Stormcaller's every fourth spell, as the stacks of Static Charge are full: free, and leaping to one more */
+const CHARGED: EffectDef = { type: 'charged', effects: [{ type: 'staticArc', amount: 40, perLevel: 10, radius: 8 }] }
+
+/**
+ * Whom a hero's areas strike: its enemies, the camps' creeps among them (the creeps' player is everyone's enemy), and
+ * not what is nobody's (a shop, a critter). Said outright: a buff's area goes to allies when it says nothing
+ */
+const FOES = { affects: 'enemies' } as const
+/** An area's effect on foes that are not heroes */
+const FOES_NOT_HEROES = { affects: 'enemies', where: (_context: EffectValueContext, unit: Entity) => !heroOf(unit) } as const
+
+/** How many kills a hero's death counts as, to Harvest */
+const HERO_HARVEST = 5
+/** The most Harvest holds */
+const MOST_HARVEST = 50
+
+export const heroBuffs: BuffDef[] = [
+	// Oathbreaker
+	{ id: 'bulwarkWard', name: 'Bulwark', description: 'An Oathbreaker near takes a fifth of the damage this hero takes', tags: ['guard'] },
+	{ id: 'taunted', name: 'Taunted', description: 'Made to attack whoever taunted it', harmful: true, control: 'taunt', tags: ['control'] },
+	{ id: 'shieldwall', name: 'Shieldwall', description: 'A shield takes the damage', duration: 4, shield: [80, 140, 200], shieldScaling: { abilityPower: 0.4 }, tags: ['shield'] },
+	{ id: 'lastStand', name: 'Last Stand', description: 'Takes 30% less damage', stats: { incomingDamage: -0.3 }, tags: ['defence'] },
+	// Dawn Priest
+	{ id: 'mercysEcho', name: 'Mercy’s Echo', description: 'Healing past full health becomes a shield', overheal: { buff: 'echoShield', part: [0.4, 0.6, 0.8, 1], most: 0.25 } },
+	{ id: 'echoShield', name: 'Echo', description: 'Healing past full health, held as a shield', duration: 5, tags: ['shield'] },
+	{ id: 'dawnlight', name: 'Dawnlight', description: 'Heals over time, and healing it gets is stronger', stats: { healthRegen: [1, 2, 3], incomingHealing: [0.1, 0.15, 0.2] } },
+	{
+		id: 'sanctuary',
+		name: 'Sanctuary',
+		description: 'A blow that would kill it leaves it at 30% health and untouchable for 2 seconds instead',
+		duration: 6,
+		passive: [{ type: 'onFatal', health: 0.3, cooldown: 6, effects: [{ type: 'buff', buff: 'hallowed', on: 'caster' }, { type: 'removeBuff', buff: 'sanctuary', on: 'caster' }] }],
+		tags: ['save']
+	},
+	{ id: 'hallowed', name: 'Hallowed', description: 'Takes no damage', duration: 2, invulnerable: true, dispellable: false },
+	// Stormcaller
+	{ id: 'staticCharge', name: 'Static Charge', description: 'Every fourth spell costs no mana and leaps to one more enemy', maxStacks: 3 },
+	{ id: 'buffeted', name: 'Buffeted', description: 'Moves slower', harmful: true, duration: 1.5, percent: { moveSpeed: [-0.2, -0.3, -0.4] }, tags: ['slow'] },
+	{ id: 'stormSlow', name: 'In the Storm', description: 'Moves 35% slower', harmful: true, percent: { moveSpeed: -0.35 }, tags: ['slow'] },
+	// Gale Hunter
+	{
+		id: 'steadyAim',
+		name: 'Steady Aim',
+		description: 'Standing still steadies the aim: more range and critical chance, lost as soon as it moves',
+		// half a second still at a time adds a stack, moving takes them off (`steadyTick`)
+		onTick: { every: 0.5, run: steadyTick }
+	},
+	{ id: 'steadied', name: 'Steadied', description: '+0.5 range and +6% critical chance for every half second still', maxStacks: 4, perStack: true, stats: { attackRange: 0.5, critChance: 0.06 } },
+	{
+		id: 'tumbleShot',
+		name: 'Tumble',
+		description: 'The next attack deals more',
+		duration: 4,
+		passive: [{ type: 'onHit', effects: [{ type: 'damage', amount: [40, 70, 100], damageType: 'physical' }] }],
+		breaksOn: ['attack']
+	},
+	{ id: 'pinned', name: 'Pinned', description: 'Moves 50% slower', harmful: true, percent: { moveSpeed: -0.5 }, tags: ['slow'] },
+	// Gravelord
+	{ id: 'bloodTithe', name: 'Blood Tithe', description: 'Abilities cost health, not mana, and damage dealt heals', paysWithHealth: 1, stats: { omnivamp: [0.08, 0.1, 0.12, 0.14] } },
+	{ id: 'graveChill', name: 'Grave Chill', description: 'Moves 30% slower', harmful: true, duration: 1.5, percent: { moveSpeed: -0.3 }, tags: ['slow'] },
+	{ id: 'deathless', name: 'Deathless Aura', description: 'Moves faster and heals near a Gravelord', percent: { moveSpeed: [0.1, 0.15, 0.2] }, stats: { healthRegen: [1, 2, 3] } },
+	{ id: 'graveRallied', name: 'Grave Rally', description: 'Its attacks heal it', duration: 8, stats: { lifeSteal: 0.2 } },
+	// Rime Witch
+	{ id: 'shatterSense', name: 'Shatter', description: 'Who she holds takes more from the next blow of her allies, which ends the hold' },
+	{ id: 'frozen', name: 'Frozen', description: 'Frozen solid: cannot do anything', harmful: true, stun: true, tags: ['hold', 'frost'] },
+	{ id: 'iceRooted', name: 'Grasping Ice', description: 'Held by the ice: cannot move', harmful: true, root: true, tags: ['hold', 'frost'] },
+	{ id: 'frostbitten', name: 'Frostbite', description: 'Moves slower', harmful: true, duration: 1.5, percent: { moveSpeed: [-0.2, -0.25, -0.3] }, tags: ['slow', 'frost'] },
+	{ id: 'whiteoutChill', name: 'Whiteout', description: 'Moves 30% slower', harmful: true, percent: { moveSpeed: -0.3 }, tags: ['slow', 'frost'] },
+	{
+		id: 'frostbite',
+		name: 'Freezing',
+		description: 'Two seconds in the storm freezes it',
+		harmful: true,
+		duration: 0.5,
+		maxStacks: 8,
+		onMaxStacks: [{ type: 'buff', buff: 'frozen', duration: 1.5 }, { type: 'removeBuff', buff: 'frostbite' }],
+		tags: ['frost']
+	},
+	// Duskblade
+	{
+		id: 'shadowWatch',
+		name: 'Shadow Step',
+		description: 'Three seconds out of a fight hides it in the shadows',
+		onTick: { every: 0.25, run: (world, carrier, instance) => shadowTick(world, carrier, instance) }
+	},
+	{
+		id: 'shadowed',
+		name: 'In the Shadows',
+		description: 'Seen only from up close; its first strike from the shadows is a critical one and silences',
+		camouflage: 2.5,
+		passive: [
+			{
+				type: 'onHit',
+				effects: [
+					{ type: 'damage', amount: 0, scaling: { attackDamage: [0.75, 1, 1.25] }, damageType: 'physical' },
+					{ type: 'buff', buff: 'hushed', duration: 1.5 }
+				]
+			}
+		],
+		breaksOn: ['attack', 'cast']
+	},
+	{ id: 'hushed', name: 'Silenced', description: 'Cannot use its abilities', harmful: true, silence: true, tags: ['hold'] },
+	{
+		id: 'duskMark',
+		name: 'Dusk Mark',
+		description: 'Takes more damage from everyone, is seen wherever it goes, and bursts when the mark runs out',
+		harmful: true,
+		duration: 4,
+		revealed: true,
+		stats: { incomingDamage: [0.1, 0.15, 0.2] },
+		onEnd: [{ type: 'damage', amount: [60, 100, 140], damageType: 'magic', radius: 0.5 }],
+		tags: ['mark']
+	},
+	{ id: 'faded', name: 'Fade', description: 'Walks through units, faster, and seen only from up close', duration: 2, phasing: true, camouflage: 1.5, percent: { moveSpeed: 0.4 }, breaksOn: ['attack'] },
+	{ id: 'eclipsed', name: 'Eclipse', description: 'Silenced, cannot be healed, and seen wherever it goes', harmful: true, duration: 3, silence: true, revealed: true, stats: { incomingHealing: -1 }, tags: ['hold', 'anti-heal'] },
+	// Bone Reaver
+	{
+		id: 'harvest',
+		name: 'Harvest',
+		description: 'More health and damage for every kill; a hero counts as five, and half of it is lost on death',
+		maxStacks: MOST_HARVEST,
+		// what it reaped is kept on the hero (`harvested`), through deaths and forms: the stacks and the stats are of it
+		onApply: (_world, carrier, instance) => void (instance.stacks = carrier.get(harvested)?.count ?? 0),
+		change: (_world, carrier) => {
+			const count = carrier.get(harvested)?.count ?? 0
+			return count ? { stats: { health: 6 * count, attackDamage: 1 * count } } : undefined
+		}
+	},
+	{ id: 'carrionHunger', name: 'Carrion Hunger', description: 'Blows from up close strike those around the target too', cleave: { part: [0.3, 0.45, 0.6], radius: 2.5, angle: 1.6 } },
+	{ id: 'bonePitFrenzy', name: 'Bone Pit', description: 'Attacks faster, and its attacks heal it', percent: { attackSpeed: 0.3 }, stats: { lifeSteal: 0.25 } }
+]
+
+export const heroAbilities: AbilityDef[] = [
+	// ---- Oathbreaker: charges in, taunts, shields who stands behind him
+	{
+		id: 'bulwark',
+		name: 'Bulwark',
+		description: 'Takes a fifth of the damage allied heroes near him take, before their armor',
+		target: 'passive',
+		maxLevel: 1,
+		effects: [{ type: 'aura', buff: 'bulwarkWard', radius: 8, only: 'heroes' }]
+	},
+	{
+		id: 'oathCharge',
+		name: 'Oath Charge',
+		description: 'Charges to a spot: enemies around where he lands take 60, 100 or 140 (+50% attack damage) and are made to attack him for 1.25 to 1.75 seconds',
+		hotkey: 'Q',
+		target: 'point',
+		range: 8,
+		manaCost: 80,
+		cooldown: [14, 12, 10],
+		effects: [
+			{
+				type: 'dash',
+				distance: 8,
+				effects: [
+					{ type: 'damage', amount: [60, 100, 140], scaling: { attackDamage: 0.5 }, damageType: 'physical', radius: 2.5, ...FOES },
+					{ type: 'buff', buff: 'taunted', duration: [1.25, 1.5, 1.75], radius: 2.5, ...FOES }
+				]
+			}
+		]
+	},
+	{
+		id: 'shieldwall',
+		name: 'Shieldwall',
+		description: 'He and the allies around him get a shield of 80, 140 or 200 (+40% ability power) for 4 seconds',
+		hotkey: 'W',
+		target: 'none',
+		manaCost: 90,
+		cooldown: 16,
+		effects: [{ type: 'buff', buff: 'shieldwall', radius: 7, affects: 'allies' }]
+	},
+	{
+		id: 'ironResolve',
+		name: 'Iron Resolve',
+		description: 'Whoever strikes him from up close takes 12, 22 or 32 magic damage back',
+		target: 'passive',
+		effects: [{ type: 'onDamaged', melee: true, attack: true, effects: [{ type: 'damage', amount: [12, 22, 32], damageType: 'magic' }] }]
+	},
+	{
+		id: 'lastStand',
+		name: 'Last Stand',
+		description: 'Enemies around him are made to attack him for 2 seconds, and for 6 seconds allies who stay near him take 30% less damage',
+		hotkey: 'R',
+		target: 'none',
+		manaCost: 150,
+		cooldown: 100,
+		maxLevel: 1,
+		ultimate: true,
+		effects: [
+			{ type: 'buff', buff: 'taunted', duration: 2, radius: 6, ...FOES },
+			{ type: 'zone', follow: 'caster', duration: 6, radius: 7, effects: [{ type: 'buff', buff: 'lastStand', duration: 0.5, radius: 7, affects: 'allies' }] }
+		]
+	},
+
+	// ---- Dawn Priest: heals, cleanses, and an ultimate that saves a life
+	{
+		id: 'mercysEcho',
+		name: 'Mercy’s Echo',
+		description: 'Healing she gives past full health becomes a shield on whoever she healed: 40% of it, up to all of it as she grows, at most a quarter of their health',
+		target: 'passive',
+		maxLevel: 4,
+		effects: [{ type: 'buff', buff: 'mercysEcho' }]
+	},
+	{
+		id: 'holyLight',
+		name: 'Holy Light',
+		description: 'Heals an ally for 200, 350 or 500 (+80% ability power)',
+		hotkey: 'Q',
+		target: 'unit',
+		targets: { allies: true, self: false },
+		manaCost: 65,
+		cooldown: 5,
+		range: 8,
+		castTime: 0.4,
+		effects: [{ type: 'heal', amount: [200, 350, 500], scaling: { abilityPower: 0.8 } }]
+	},
+	{
+		id: 'cleansingFlame',
+		name: 'Cleansing Flame',
+		description: 'A flame in an area: allies in it are freed of what holds them and healed 60, 100 or 140, enemies burn for as much (+50% ability power)',
+		hotkey: 'W',
+		target: 'point',
+		range: 8,
+		manaCost: 90,
+		cooldown: 10,
+		castTime: 0.3,
+		effects: [
+			{ type: 'cleanse', radius: 3 },
+			{ type: 'heal', amount: [60, 100, 140], scaling: { abilityPower: 0.4 }, radius: 3, affects: 'allies' },
+			{ type: 'damage', amount: [60, 100, 140], scaling: { abilityPower: 0.5 }, damageType: 'magic', radius: 3, ...FOES }
+		]
+	},
+	{
+		id: 'dawnlightAura',
+		name: 'Dawnlight Aura',
+		description: 'Allies near her heal 1, 2 or 3 a second, and healing they get is 10, 15 or 20% stronger',
+		target: 'passive',
+		effects: [{ type: 'aura', buff: 'dawnlight', radius: 9 }]
+	},
+	{
+		id: 'sanctuary',
+		name: 'Sanctuary',
+		description: 'Heals an ally 200 (+60% ability power) and for 6 seconds a blow that would kill it leaves it at 30% health and untouchable for 2 seconds',
+		hotkey: 'R',
+		target: 'unit',
+		targets: { allies: true, self: true },
+		range: 8,
+		manaCost: 150,
+		cooldown: 110,
+		maxLevel: 1,
+		ultimate: true,
+		effects: [
+			{ type: 'heal', amount: 200, scaling: { abilityPower: 0.6 } },
+			{ type: 'buff', buff: 'sanctuary' }
+		]
+	},
+
+	// ---- Stormcaller: lightning and wind; every fourth spell free
+	{
+		id: 'staticCharge',
+		name: 'Static Charge',
+		description: 'Every fourth spell costs no mana, and lightning leaps from it to one more enemy for 40 (+10 a level)',
+		target: 'passive',
+		maxLevel: 1,
+		effects: [{ type: 'onCast', effects: [{ type: 'buff', buff: 'staticCharge', stack: true, on: 'caster' }] }]
+	},
+	{
+		id: 'tornado',
+		name: 'Tornado',
+		description:
+			'Whips up a tornado that sets off in a line. Enemies it passes, on the ground and in the air, take 60, 85 or 110 (+35% ability power) and are thrown up for 1 second',
+		hotkey: 'Q',
+		target: 'direction',
+		manaCost: [60, 70, 80],
+		cooldown: [12, 11, 10],
+		charge: 'staticCharge',
+		effects: [
+			{
+				type: 'missile',
+				delay: 0.75,
+				speed: 11,
+				distance: [11, 12.5, 14],
+				radius: 1.4,
+				effects: [
+					{ type: 'damage', amount: [60, 85, 110], scaling: { abilityPower: 0.35 } },
+					{ type: 'buff', buff: 'knockedUp', duration: 1 }
+				]
+			},
+			CHARGED
+		]
+	},
+	{
+		id: 'chainLightning',
+		name: 'Chain Lightning',
+		description: 'Lightning strikes an enemy for 90, 130 or 170 (+50% ability power), then leaps to two more near it, a quarter less each time',
+		hotkey: 'W',
+		target: 'unit',
+		targets: { enemies: true },
+		range: 8,
+		manaCost: 90,
+		cooldown: 9,
+		castTime: 0.3,
+		charge: 'staticCharge',
+		effects: [
+			{ type: 'missile', homing: true, speed: 30, bounce: { count: 2, range: 5, falloff: 0.25 }, effects: [{ type: 'damage', amount: [90, 130, 170], scaling: { abilityPower: 0.5 } }] },
+			CHARGED
+		]
+	},
+	{
+		id: 'galeWard',
+		name: 'Gale Ward',
+		description: 'Enemies his abilities hurt are slowed 20, 30 or 40% for 1.5 seconds',
+		target: 'passive',
+		effects: [{ type: 'onAbilityHit', effects: [{ type: 'buff', buff: 'buffeted' }] }]
+	},
+	{
+		id: 'eyeOfTheStorm',
+		name: 'Eye of the Storm',
+		description:
+			'A storm over an area for 5 seconds: enemies in it are slowed 35% and take 40 a second (+16% ability power), and whoever crosses its edge is thrown up and takes 60',
+		hotkey: 'R',
+		target: 'point',
+		range: 9,
+		manaCost: 175,
+		cooldown: 100,
+		castTime: 0.5,
+		maxLevel: 1,
+		ultimate: true,
+		charge: 'staticCharge',
+		effects: [
+			{
+				type: 'zone',
+				duration: 5,
+				radius: 4,
+				effects: [
+					{ type: 'damage', amount: 10, scaling: { abilityPower: 0.04 }, radius: 4, ...FOES },
+					{ type: 'buff', buff: 'stormSlow', duration: 0.5, radius: 4, ...FOES }
+				],
+				edge: [
+					{ type: 'buff', buff: 'knockedUp', duration: 0.75, ...FOES },
+					{ type: 'damage', amount: 60, ...FOES }
+				]
+			},
+			CHARGED
+		]
+	},
+
+	// ---- Gale Hunter: long shots, a dash, a volley that pins an area
+	{
+		id: 'steadyAim',
+		name: 'Steady Aim',
+		description: 'Each half second standing still adds 0.5 range and 6% critical chance, four times at most; moving loses all of it',
+		target: 'passive',
+		maxLevel: 1,
+		effects: [{ type: 'buff', buff: 'steadyAim' }]
+	},
+	{
+		id: 'piercingBolt',
+		name: 'Piercing Bolt',
+		description: 'A bolt that flies far in a line, through everyone in its way: 80, 130 or 180 (+80% attack damage) to each',
+		hotkey: 'Q',
+		target: 'direction',
+		manaCost: 70,
+		cooldown: [10, 9, 8],
+		castTime: 0.25,
+		effects: [
+			{ type: 'missile', speed: 24, distance: 14, radius: 0.8, pierce: true, effects: [{ type: 'damage', amount: [80, 130, 180], scaling: { attackDamage: 0.8 }, damageType: 'physical' }] }
+		]
+	},
+	{
+		id: 'tumble',
+		name: 'Tumble',
+		description: 'Rolls a short way, and the next attack within 4 seconds deals 40, 70 or 100 more',
+		hotkey: 'W',
+		target: 'point',
+		range: 5,
+		manaCost: 40,
+		cooldown: [9, 8, 7],
+		effects: [
+			{ type: 'dash', distance: 5 },
+			{ type: 'buff', buff: 'tumbleShot', on: 'caster' }
+		]
+	},
+	{
+		id: 'huntsman',
+		name: 'Huntsman',
+		description: 'Attacks on creeps and anything that is not a hero deal 15, 25 or 35 more',
+		target: 'passive',
+		effects: [{ type: 'onHit', effects: [{ type: 'damage', amount: [15, 25, 35], damageType: 'physical', where: { hero: false } }] }]
+	},
+	{
+		id: 'arrowstorm',
+		name: 'Arrowstorm',
+		description: 'Arrows fall over an area for 4 seconds: enemies in it are pinned, 50% slower, and take 48 a second (+20% attack damage)',
+		hotkey: 'R',
+		target: 'point',
+		range: 10,
+		manaCost: 150,
+		cooldown: 90,
+		castTime: 0.4,
+		maxLevel: 1,
+		ultimate: true,
+		effects: [
+			{
+				type: 'zone',
+				duration: 4,
+				radius: 5,
+				effects: [
+					{ type: 'damage', amount: 12, scaling: { attackDamage: 0.05 }, damageType: 'physical', radius: 5, ...FOES },
+					{ type: 'buff', buff: 'pinned', duration: 0.5, radius: 5, ...FOES }
+				]
+			}
+		]
+	},
+
+	// ---- Gravelord: drains life, an aura for his allies, raises the dead
+	{
+		id: 'bloodTithe',
+		name: 'Blood Tithe',
+		description: 'He has no mana: his abilities cost health instead, and 8 to 14% of the damage he deals heals him',
+		target: 'passive',
+		maxLevel: 4,
+		effects: [{ type: 'buff', buff: 'bloodTithe' }]
+	},
+	{
+		id: 'graveLash',
+		name: 'Grave Lash',
+		description: 'Lashes an enemy for 90, 150 or 210 (+60% ability power) and slows it 30% for 1.5 seconds',
+		hotkey: 'Q',
+		target: 'unit',
+		targets: { enemies: true },
+		range: 7,
+		manaCost: 60,
+		cooldown: 7,
+		castTime: 0.3,
+		effects: [
+			{ type: 'damage', amount: [90, 150, 210], scaling: { abilityPower: 0.6 } },
+			{ type: 'buff', buff: 'graveChill' }
+		]
+	},
+	{
+		id: 'siphon',
+		name: 'Siphon',
+		description: 'For 3 seconds, drains an enemy of 40, 60 or 80 a second (+20% ability power) and heals as much. Broken off as it gets away',
+		hotkey: 'W',
+		target: 'unit',
+		targets: { enemies: true },
+		range: 6,
+		manaCost: 70,
+		cooldown: 14,
+		effects: [],
+		channel: {
+			duration: 3,
+			every: 0.5,
+			leash: 8,
+			effects: [
+				{ type: 'damage', amount: [20, 30, 40], scaling: { abilityPower: 0.1 } },
+				{ type: 'heal', amount: [20, 30, 40], scaling: { abilityPower: 0.1 }, on: 'caster' }
+			]
+		}
+	},
+	{
+		id: 'deathlessAura',
+		name: 'Deathless Aura',
+		description: 'Allies near him move 10, 15 or 20% faster and heal 1, 2 or 3 a second',
+		target: 'passive',
+		effects: [{ type: 'aura', buff: 'deathless', radius: 9 }]
+	},
+	{
+		id: 'armyOfTheGrave',
+		name: 'Army of the Grave',
+		description: 'Six of the dead around him rise as skeletons for 40 seconds, and the attacks of his allies near heal them for 8 seconds',
+		hotkey: 'R',
+		target: 'none',
+		manaCost: 150,
+		cooldown: 120,
+		maxLevel: 1,
+		ultimate: true,
+		effects: [
+			{ type: 'raiseDead', unit: 'skeleton', count: 6, radius: 9, duration: 40 },
+			{ type: 'buff', buff: 'graveRallied', radius: 9, affects: 'allies' }
+		]
+	},
+
+	// ---- Rime Witch: roots and freezes; her team follows her holds up
+	{
+		id: 'shatter',
+		name: 'Shatter',
+		description: 'An enemy she holds (frozen, rooted) takes 25 to 35% more from the next blow of an ally of hers, which ends the hold',
+		target: 'passive',
+		maxLevel: 3,
+		effects: [{ type: 'buff', buff: 'shatterSense' }]
+	},
+	{
+		id: 'rimeBolt',
+		name: 'Rime Bolt',
+		description: 'Hits an enemy for 80, 130 or 180 (+60% ability power) and freezes it for 1, 1.25 or 1.5 seconds',
+		hotkey: 'Q',
+		target: 'unit',
+		targets: { enemies: true },
+		range: 8,
+		manaCost: 80,
+		cooldown: 8,
+		castTime: 0.3,
+		effects: [
+			{ type: 'damage', amount: [80, 130, 180], scaling: { abilityPower: 0.6 } },
+			{ type: 'buff', buff: 'frozen', duration: [1, 1.25, 1.5] }
+		]
+	},
+	{
+		id: 'grasp',
+		name: 'Grasping Ice',
+		description: 'Ice bursts from the ground in an area: enemies there take 70, 110 or 150 (+50% ability power) and are held where they stand for 1.5 to 2 seconds',
+		hotkey: 'W',
+		tags: ['ground'],
+		target: 'point',
+		range: 8,
+		manaCost: 90,
+		cooldown: 12,
+		castTime: 0.4,
+		effects: [
+			{ type: 'damage', amount: [70, 110, 150], scaling: { abilityPower: 0.5 }, radius: 2.5, layers: ['ground'], ...FOES },
+			{ type: 'buff', buff: 'iceRooted', duration: [1.5, 1.75, 2], radius: 2.5, layers: ['ground'], ...FOES }
+		]
+	},
+	{
+		id: 'hoarfrost',
+		name: 'Hoarfrost',
+		description: 'Her attacks slow 20, 25 or 30% for 1.5 seconds',
+		target: 'passive',
+		effects: [{ type: 'onHit', effects: [{ type: 'buff', buff: 'frostbitten' }] }]
+	},
+	{
+		id: 'whiteout',
+		name: 'Whiteout',
+		description:
+			'A blizzard over an area for 5 seconds: enemies in it are slowed 30% and take 32 a second (+12% ability power), and one that stays 2 seconds is frozen for 1.5',
+		hotkey: 'R',
+		target: 'point',
+		range: 9,
+		manaCost: 175,
+		cooldown: 100,
+		castTime: 0.5,
+		maxLevel: 1,
+		ultimate: true,
+		effects: [
+			{
+				type: 'zone',
+				duration: 5,
+				radius: 4.5,
+				effects: [
+					{ type: 'damage', amount: 8, scaling: { abilityPower: 0.03 }, radius: 4.5, ...FOES },
+					{ type: 'buff', buff: 'whiteoutChill', duration: 0.5, radius: 4.5, ...FOES },
+					{ type: 'buff', buff: 'frostbite', stack: true, radius: 4.5, ...FOES }
+				]
+			}
+		]
+	},
+
+	// ---- Duskblade: waits in the shadows, marks one and bursts it, slips away through a crowd
+	{
+		id: 'shadowStep',
+		name: 'Shadow Step',
+		description:
+			'Three seconds out of a fight (neither hurting nor hurt) hide her in the shadows, seen only from up close: her first strike from them deals 75 to 125% more and silences for 1.5 seconds',
+		target: 'passive',
+		maxLevel: 3,
+		effects: [{ type: 'buff', buff: 'shadowWatch' }]
+	},
+	{
+		id: 'duskMark',
+		name: 'Dusk Mark',
+		description:
+			'Cuts an enemy for 60, 100 or 140 (+50% attack damage) and marks it for 4 seconds: it takes 10 to 20% more from everyone, is seen wherever it goes, and the mark bursts for 60, 100 or 140 at its end',
+		hotkey: 'Q',
+		target: 'unit',
+		targets: { enemies: true },
+		range: 7,
+		manaCost: 70,
+		cooldown: 10,
+		effects: [
+			{ type: 'damage', amount: [60, 100, 140], scaling: { attackDamage: 0.5 }, damageType: 'physical' },
+			{ type: 'buff', buff: 'duskMark' }
+		]
+	},
+	{
+		id: 'fade',
+		name: 'Fade',
+		description: 'For 2 seconds she walks through units, 40% faster, seen only from up close. Attacking ends it',
+		hotkey: 'W',
+		target: 'none',
+		manaCost: 60,
+		cooldown: [16, 14, 12],
+		effects: [{ type: 'buff', buff: 'faded', on: 'caster' }]
+	},
+	{
+		id: 'twinFangs',
+		name: 'Twin Fangs',
+		description: 'Every third attack strikes again for 20, 35 or 50 (+50% attack damage)',
+		target: 'passive',
+		effects: [{ type: 'onHit', every: 3, effects: [{ type: 'damage', amount: [20, 35, 50], scaling: { attackDamage: 0.5 }, damageType: 'physical' }] }]
+	},
+	{
+		id: 'eclipse',
+		name: 'Eclipse',
+		description: 'Steps to an enemy and cuts it off for 3 seconds: it cannot use its abilities, cannot be healed, and is seen wherever it goes',
+		hotkey: 'R',
+		target: 'unit',
+		targets: { enemies: true },
+		range: 6,
+		manaCost: 120,
+		cooldown: 90,
+		maxLevel: 1,
+		ultimate: true,
+		effects: [
+			{ type: 'blink', distance: 6 },
+			{ type: 'buff', buff: 'eclipsed' }
+		]
+	},
+
+	// ---- Bone Reaver: clears camps fast, grows with every kill
+	{
+		id: 'harvest',
+		name: 'Harvest',
+		description: `Every kill adds 6 health and 1 attack damage for good, a hero's ${HERO_HARVEST} times as much, up to ${MOST_HARVEST}; he loses half of it when he dies`,
+		target: 'passive',
+		maxLevel: 1,
+		effects: [{ type: 'buff', buff: 'harvest' }]
+	},
+	{
+		id: 'boneCleaver',
+		name: 'Bone Cleaver',
+		description: 'Cleaves all around him for 60, 100 or 140 (+80% attack damage), twice as much to creeps and anything that is not a hero',
+		hotkey: 'Q',
+		target: 'none',
+		manaCost: 70,
+		cooldown: [8, 7, 6],
+		castTime: 0.3,
+		effects: [
+			{ type: 'damage', amount: [60, 100, 140], scaling: { attackDamage: 0.8 }, damageType: 'physical', radius: 3, ...FOES },
+			{ type: 'damage', amount: [60, 100, 140], scaling: { attackDamage: 0.8 }, damageType: 'physical', radius: 3, ...FOES_NOT_HEROES }
+		]
+	},
+	{
+		id: 'gorge',
+		name: 'Gorge',
+		description: 'Tears into a creep or another unit that is not a hero for 250, 400 or 550 true damage, and heals 60, 100 or 140',
+		hotkey: 'W',
+		target: 'unit',
+		targets: { enemies: true, heroes: false },
+		range: 2,
+		manaCost: 90,
+		cooldown: [16, 14, 12],
+		castTime: 0.25,
+		effects: [
+			{ type: 'damage', amount: [250, 400, 550], damageType: 'true' },
+			{ type: 'heal', amount: [60, 100, 140], on: 'caster' }
+		]
+	},
+	{
+		id: 'carrionHunger',
+		name: 'Carrion Hunger',
+		description: 'His blows strike the enemies around his target too, for 30, 45 or 60% of their damage',
+		target: 'passive',
+		effects: [{ type: 'buff', buff: 'carrionHunger' }]
+	},
+	{
+		id: 'bonePit',
+		name: 'Bone Pit',
+		description: 'A ring of bones for 4 seconds: whoever crosses it is stunned for 1 second, and allies inside attack 30% faster and heal by their attacks',
+		hotkey: 'R',
+		target: 'point',
+		range: 7,
+		manaCost: 150,
+		cooldown: 100,
+		maxLevel: 1,
+		ultimate: true,
+		effects: [
+			{
+				type: 'zone',
+				duration: 4,
+				radius: 4.5,
+				effects: [{ type: 'buff', buff: 'bonePitFrenzy', duration: 0.5, radius: 4.5, affects: 'allies' }],
+				edge: [{ type: 'buff', buff: 'stunned', duration: 1, ...FOES }]
+			}
+		]
+	}
+]
+
+// ---- in code: what the fields above do not say
+
+/** What Bone Reaver reaped, kept on him through deaths, saved with him: the count of Harvest */
+export const harvested = defineComponent<{ count: number }>({ id: 'melee.harvested' })
+
+/** Gale Hunter, every half second: where it stood the last time, a stack more of Steadied; moved, none */
+function steadyTick(world: World, carrier: Entity, instance: BuffInstance): void {
+	const was = instance.data as { x: number; z: number } | undefined
+	instance.data = { x: carrier.pos.x, z: carrier.pos.z }
+	const [dx, dz] = [carrier.pos.x - (was?.x ?? 0), carrier.pos.z - (was?.z ?? 0)]
+	if (!was || dx * dx + dz * dz > STILL * STILL) {
+		if (hasBuff(carrier, 'steadied')) removeBuff(world, carrier, 'steadied')
+		return
+	}
+	applyBuff(world, carrier, 'steadied', undefined, carrier)
+	const steadied = carrier.buffs.find((each) => each.id === 'steadied')
+	if (steadied) steadied.stacks = Math.min((steadied.stacks ?? 0) + 1, world.registry.buff('steadied').maxStacks ?? 1)
+	invalidateStats(world, carrier)
+}
+
+/** How far a unit may be nudged in half a second and still stand still, to Steady Aim */
+const STILL = 0.2
+
+/** Seconds out of a fight before Duskblade is in the shadows */
+const QUIET = 3
+
+/** Duskblade, every quarter second: three seconds since she last hurt anyone or was hurt, in the shadows */
+function shadowTick(world: World, carrier: Entity, instance: BuffInstance): void {
+	const struck = (instance.data?.struckAt as number | undefined) ?? -Infinity
+	if (hasBuff(carrier, 'shadowed') || world.time - Math.max(carrier.hurtAt, struck) < QUIET) return
+	applyBuff(world, carrier, 'shadowed', undefined, carrier, instance.level)
+}
+
+/** Bone Reaver's Harvest put to a new count: the stacks shown and the stats */
+function setHarvest(world: World, hero: Entity, count: number): void {
+	hero.set(harvested, { count })
+	const buff = hero.buffs.find((instance) => instance.id === 'harvest')
+	if (buff) buff.stacks = count
+	invalidateStats(world, hero)
+}
+
+/** The ally of a hero's who stands guard over it (Bulwark): the Oathbreaker whose aura it carries, alive and not itself */
+function guardOf(world: World, hero: Entity): Entity | undefined {
+	const ward = hero.buffs.find((instance) => instance.id === 'bulwarkWard')
+	const guard = ward && world.get(ward.source)
+	return guard?.alive && guard !== hero && !guard.hidden ? guard : undefined
+}
+
+/** The share of a blow Bulwark takes */
+const BULWARK = 0.2
+/** How much more a shattering blow deals, by the level of Shatter */
+const SHATTER = [0.25, 0.3, 0.35]
+
+export const heroHooks: HookDef[] = [
+	defineHook({
+		hook: 'beforeDamage',
+		id: 'melee.heroes.damage',
+		run(world, event) {
+			const { target, source } = event
+			if (!target.buffs.length) return
+			// Shatter: a hold of a Rime Witch's, struck by an ally of hers, deals more and ends
+			if (source && !event.tags?.includes('shatter'))
+				for (const instance of target.buffs) {
+					const def = world.registry.buff(instance.id)
+					if (!def.harmful || !holdsUp(def)) continue
+					const witch = world.get(instance.source)
+					const sense = witch?.buffs.find((each) => each.id === 'shatterSense')
+					if (!witch || !sense || witch === source || world.areEnemies(witch.owner, source.owner)) continue
+					event.amount *= 1 + SHATTER[Math.min(sense.level, SHATTER.length) - 1]
+					for (const hold of target.buffs.filter((each) => each.source === witch.id && holdsUp(world.registry.buff(each.id))))
+						removeBuff(world, target, hold.id, witch)
+					break
+				}
+			// Bulwark: an Oathbreaker near takes a fifth of what an allied hero takes, before its armor
+			const guard = event.tags?.includes('bulwark') ? undefined : guardOf(world, target)
+			if (guard && event.amount > 0) {
+				const share = event.amount * BULWARK
+				event.amount -= share
+				world.damage(guard, share, source, { damageType: event.type, tags: ['bulwark'] })
+			}
+		}
+	}),
+	defineHook({
+		hook: 'afterDamage',
+		id: 'melee.heroes.shadows',
+		run(_world, event) {
+			// Duskblade out of the shadows as she strikes; and the time of it, for Shadow Step
+			const watch = event.source?.buffs.find((instance) => instance.id === 'shadowWatch')
+			if (watch) watch.data = { ...watch.data, struckAt: _world.time }
+			if (event.dealt > 0 && hasBuff(event.target, 'shadowed')) removeBuff(_world, event.target, 'shadowed')
+		}
+	}),
+	defineHook({
+		hook: 'beforeCast',
+		id: 'melee.heroes.staticCharge',
+		run(world, event) {
+			// Static Charge full: the spell costs nothing
+			const charge = event.ability.charge
+			if (charge !== 'staticCharge') return
+			const stacks = event.caster.buffs.find((instance) => instance.id === charge)?.stacks ?? 0
+			if (stacks >= (world.registry.buff(charge).maxStacks ?? 1)) event.manaCost = 0
+		}
+	}),
+	defineHook({
+		hook: 'death',
+		id: 'melee.heroes.harvest',
+		run(world, { entity, killer }) {
+			// Harvest: a kill adds to it, a hero's five times; dying, Bone Reaver loses half
+			if (entity.has(harvested)) setHarvest(world, entity, Math.floor(entity.get(harvested)!.count / 2))
+			if (!killer || killer === entity || !killer.alive || killer.def.hero?.innate !== 'harvest' || !entity.isUnit) return
+			if (!world.areEnemies(killer.owner, entity.owner)) return
+			const gain = heroOf(entity) ? HERO_HARVEST : 1
+			setHarvest(world, killer, Math.min((killer.get(harvested)?.count ?? 0) + gain, MOST_HARVEST))
+		}
+	})
+]
+
+export const heroEffects: EffectType[] = [
+	/** Lightning leaping from where a spell went off to the nearest other enemy: Static Charge */
+	defineEffect({ type: 'staticArc', run: ({ world, caster, target }, effect) => {
+		const from = target ?? caster
+		const struck = world.query({ near: from, radius: effect.radius, is: 'enemy', of: caster.owner, kinds: ['unit'], except: [caster, ...(target ? [target] : [])], sort: 'nearest', limit: 1 })[0]
+		if (!struck) return
+		const level = heroOf(caster)?.level ?? 1
+		world.damage(struck, effect.amount + effect.perLevel * (level - 1), caster, { damageType: 'magic', ability: 'staticCharge' })
+	} })
+]