@v12-engine/create 0.1.1 → 0.4.0

package/starters/examples/src/examples/abilities/buffs.ts

@@ -0,0 +1,287 @@
+/**
+ * Buffs and auras: something lasting on a unit, put on by the `buff` effect or kept on everyone near by an `aura`.
+ * Stats, a shield, stacks that go off at five, an immolation turned on and off, a bomb that goes off when its time is
+ * up, untouchable and unkillable, walking through units, cleaving blows, healing past full kept as a shield, and a
+ * doom that leaves a demon where its carrier dies
+ */
+import type { AbilityDef, BuffDef } from '@v12-engine/engine'
+import { exampleField } from '../define'
+import { ENEMY, PLAYER } from '../common/units'
+import type { Family } from './family'
+import { caster, put, sparring } from './kit'
+
+const buffs: BuffDef[] = [
+	// flat and percent stats
+	{
+		id: 'abilitiesInnerFire',
+		name: 'Inner Fire',
+		description: '+10 armor, +40% attack damage',
+		duration: 20,
+		stats: { armor: 10 },
+		percent: { attackDamage: 0.4 }
+	},
+	// a shield takes damage first; its amount set by the cast
+	{ id: 'abilitiesBarrier', name: 'Barrier', description: 'A shield', duration: 8, shield: 150 },
+	// an aura's buff has no duration: it stays while its carrier is near the one with the aura
+	{ id: 'abilitiesDevotion', name: 'Devotion Aura', description: '+8 armor while near the paladin', stats: { armor: 8 } },
+	// stacks: at five, a stun, and the stacks spent
+	{
+		id: 'abilitiesRend',
+		name: 'Rend',
+		description: 'Bleeds; at five stacks, a stun',
+		harmful: true,
+		duration: 6,
+		maxStacks: 5,
+		stacking: 'refresh',
+		onTick: { every: 1, effects: [{ type: 'damage', amount: 10 }] },
+		onMaxStacks: [
+			{ type: 'buff', buff: 'abilitiesRendStun' },
+			{ type: 'removeBuff', buff: 'abilitiesRend' }
+		]
+	},
+	{ id: 'abilitiesRendStun', name: 'Ruptured', harmful: true, duration: 1.5, stun: true },
+	// kept on until cast again, taking mana every second
+	{
+		id: 'abilitiesImmolating',
+		name: 'Immolation',
+		description: 'Burns everyone near, 8 mana a second',
+		drain: { mana: 8 },
+		onTick: { every: 1, effects: [{ type: 'damage', amount: 20, radius: 3 }] }
+	},
+	// goes off when its time is up
+	{ id: 'abilitiesTimeBomb', name: 'Time Bomb', harmful: true, duration: 3, onEnd: [{ type: 'damage', amount: 200, radius: 3 }] },
+	// no damage, no enemy casts or attacks
+	{ id: 'abilitiesDivineShield', name: 'Divine Shield', description: 'Takes no damage', duration: 5, invulnerable: true },
+	// out of everyone's reach, still seen, and held
+	{ id: 'abilitiesStasis', name: 'Stasis', description: 'Untouchable and held', duration: 2.5, invulnerable: true, untargetable: true, stun: true },
+	// damage never takes it under 100
+	{ id: 'abilitiesUndying', name: 'Undying Rage', description: 'Can not fall below 100 health', duration: 6, minHealth: 100 },
+	// walks through units, and they through it
+	{ id: 'abilitiesGhost', name: 'Ghost', description: 'Walks through units, 40% faster', duration: 6, phasing: true, percent: { moveSpeed: 0.4 } },
+	// its blows strike the enemies around their target too, 60% of their damage
+	{
+		id: 'abilitiesCleaving',
+		name: 'Cleaving Blows',
+		description: 'Blows strike those around the target too',
+		duration: 10,
+		cleave: { part: 0.6, radius: 2.5 }
+	},
+	// healing it gives past full health becomes a shield on the one healed
+	{
+		id: 'abilitiesMercy',
+		name: 'Mercy’s Echo',
+		description: 'Healing past full health becomes a shield',
+		duration: 20,
+		overheal: { buff: 'abilitiesEcho', part: 1, most: 0.5 }
+	},
+	{ id: 'abilitiesEcho', name: 'Echo', description: 'A shield of healing past full', duration: 6 },
+	// where its carrier dies carrying it, a demon of whoever put it on
+	{
+		id: 'abilitiesDoom',
+		name: 'Doom',
+		harmful: true,
+		duration: 30,
+		silence: true,
+		onTick: { every: 0.5, effects: [{ type: 'damage', amount: 60 }] },
+		onCarrierDeath: [{ type: 'spawn', unit: 'abilitiesDemon' }]
+	}
+]
+
+const abilities: AbilityDef[] = [
+	{
+		id: 'abilitiesCastInnerFire',
+		name: 'Inner Fire',
+		description: 'An ally: +10 armor and +40% attack damage for 20 seconds',
+		hotkey: 'Q',
+		target: 'unit',
+		targets: { allies: true, self: true },
+		range: 8,
+		cooldown: 0.5,
+		effects: [{ type: 'buff', buff: 'abilitiesInnerFire' }]
+	},
+	{
+		// the buff's shield, sized by the cast
+		id: 'abilitiesCastBarrier',
+		name: 'Shield',
+		description: 'An ally: a shield of 300 for 8 seconds, taken before its health',
+		hotkey: 'W',
+		target: 'unit',
+		targets: { allies: true, self: true },
+		range: 8,
+		cooldown: 0.5,
+		effects: [{ type: 'buff', buff: 'abilitiesBarrier', amount: 300 }]
+	},
+	{
+		id: 'abilitiesCastRend',
+		name: 'Rend',
+		description: 'A stack of bleeding; at five, a stun, the stacks spent',
+		hotkey: 'E',
+		target: 'unit',
+		targets: { enemies: true },
+		range: 8,
+		cooldown: 0.2,
+		effects: [{ type: 'buff', buff: 'abilitiesRend', stack: true }]
+	},
+	{
+		// `toggle`: on, then off when cast again
+		id: 'abilitiesImmolation',
+		name: 'Immolation',
+		description: 'Turned on and off: burns everyone within 3, for mana every second',
+		hotkey: 'R',
+		target: 'none',
+		effects: [{ type: 'toggle', buff: 'abilitiesImmolating' }]
+	},
+	{
+		id: 'abilitiesCastTimeBomb',
+		name: 'Time Bomb',
+		description: 'A bomb on an enemy, going off around it in 3 seconds',
+		hotkey: 'T',
+		target: 'unit',
+		targets: { enemies: true },
+		range: 8,
+		cooldown: 0.5,
+		effects: [{ type: 'buff', buff: 'abilitiesTimeBomb' }]
+	},
+	{
+		id: 'abilitiesCastDivineShield',
+		name: 'Divine Shield',
+		description: 'The caster takes no damage for 5 seconds',
+		hotkey: 'D',
+		target: 'none',
+		cooldown: 0.5,
+		effects: [{ type: 'buff', buff: 'abilitiesDivineShield', on: 'caster' }]
+	},
+	{
+		id: 'abilitiesCastStasis',
+		name: 'Stasis',
+		description: 'The caster is untouchable, by anyone, and held for 2.5 seconds',
+		hotkey: 'F',
+		target: 'none',
+		cooldown: 0.5,
+		effects: [{ type: 'buff', buff: 'abilitiesStasis', on: 'caster' }]
+	},
+	{
+		id: 'abilitiesCastUndying',
+		name: 'Undying Rage',
+		description: 'An ally can not fall below 100 health for 6 seconds',
+		hotkey: 'G',
+		target: 'unit',
+		targets: { allies: true, self: true },
+		range: 8,
+		cooldown: 0.5,
+		effects: [{ type: 'buff', buff: 'abilitiesUndying' }]
+	},
+	{
+		id: 'abilitiesCastGhost',
+		name: 'Ghost',
+		description: 'The caster walks through units, faster, for 6 seconds',
+		hotkey: 'Z',
+		target: 'none',
+		cooldown: 0.5,
+		effects: [{ type: 'buff', buff: 'abilitiesGhost', on: 'caster' }]
+	},
+	{
+		id: 'abilitiesCastCleave',
+		name: 'Cleaving Blows',
+		description: 'An ally’s blows strike the enemies round its target too',
+		hotkey: 'X',
+		target: 'unit',
+		targets: { allies: true },
+		range: 8,
+		cooldown: 0.5,
+		effects: [{ type: 'buff', buff: 'abilitiesCleaving' }]
+	},
+	{
+		// with Mercy's Echo on the caster, a heal past full health leaves a shield on the healed
+		id: 'abilitiesCastMercy',
+		name: 'Overheal',
+		description: 'The caster’s healing past full becomes a shield; then it heals an ally for 400',
+		hotkey: 'C',
+		target: 'unit',
+		targets: { allies: true, self: true },
+		range: 8,
+		cooldown: 0.5,
+		effects: [
+			{ type: 'buff', buff: 'abilitiesMercy', on: 'caster' },
+			{ type: 'heal', amount: 400 }
+		]
+	},
+	{
+		id: 'abilitiesCastDoom',
+		name: 'Doom',
+		description: 'An enemy is silenced and burns; where it dies a demon of yours stands',
+		hotkey: 'V',
+		target: 'unit',
+		targets: { enemies: true },
+		range: 8,
+		cooldown: 0.5,
+		effects: [{ type: 'buff', buff: 'abilitiesDoom' }]
+	},
+	{
+		// takes stacks or a whole buff off: here every bomb and bleed off everyone near
+		id: 'abilitiesDefuse',
+		name: 'Remove buffs',
+		description: 'Takes every Time Bomb, Rend and Doom off the enemies within 12',
+		hotkey: 'B',
+		target: 'none',
+		cooldown: 0.5,
+		effects: [
+			{ type: 'removeBuff', buff: 'abilitiesTimeBomb', radius: 12, affects: 'enemies' },
+			{ type: 'removeBuff', buff: 'abilitiesRend', radius: 12, affects: 'enemies' },
+			{ type: 'removeBuff', buff: 'abilitiesDoom', radius: 12, affects: 'enemies' }
+		]
+	}
+]
+
+/** The paladin's aura: a passive that keeps its buff on every ally within 7 */
+const devotionAura: AbilityDef = {
+	id: 'abilitiesDevotionAura',
+	name: 'Devotion Aura',
+	description: 'Allies within 7: +8 armor',
+	target: 'passive',
+	effects: [{ type: 'aura', buff: 'abilitiesDevotion', radius: 7, affects: 'allies' }]
+}
+
+export const buffsFamily: Family = {
+	abilities,
+	more: [devotionAura],
+	buffs,
+	units: [
+		caster('abilitiesPaladin', 'Paladin', [...abilities.map((each) => each.id), devotionAura.id]),
+		// an ally that fights: what Inner Fire and Cleaving Blows make stronger
+		sparring('abilitiesSoldier', 'Footman', {
+			stats: { health: 900, healthRegen: 3, attackDamage: 20, attackSpeed: 1.1, attackRange: 0.5, armor: 5, moveSpeed: 4 },
+			attacks: [{ damagePoint: 0.45, acquisitionRange: 6 }]
+		}),
+		// what Doom leaves where its carrier dies
+		sparring('abilitiesDemon', 'Doom Guard', {
+			radius: 0.6,
+			stats: { health: 1400, attackDamage: 40, attackSpeed: 1, attackRange: 0.6, armor: 8, moveSpeed: 3.6 },
+			attacks: [{ damagePoint: 0.4, acquisitionRange: 8 }],
+			lifetime: 30
+		})
+	],
+	example: {
+		id: 'abilities-buffs',
+		category: 'abilities',
+		title: 'Buffs and auras',
+		summary:
+			'Stats, shields, stacks, an aura, a toggle that drains mana, a bomb on a timer, invulnerable and untargetable, a health floor, walking through units, cleaving blows, overheal and a doom. Your footman fights a pack of training footmen while you buff it.',
+		tags: ['buff', 'debuff', 'aura', 'shield', 'stacks', 'toggle', 'invulnerable', 'untargetable', 'cleave', 'overheal', 'phasing', 'doom'],
+		source: ['examples/abilities/buffs.ts', 'examples/abilities/kit.ts'],
+		map: () => exampleField({ name: 'Buffs', players: 2 }),
+		start: (world) => {
+			put(world, 'abilitiesPaladin', PLAYER, { x: 24, z: 17 }, 'caster')
+			put(world, 'abilitiesSoldier', PLAYER, { x: 24, z: 21 }, 'ally')
+			// the pack the footman fights: close enough for its blows to cleave
+			for (const [i, [x, z]] of [
+				[23, 24],
+				[25, 24],
+				[24, 25.3],
+				[22.4, 25.6],
+				[25.6, 25.6]
+			].entries())
+				put(world, 'abilitiesTarget', ENEMY, { x, z }, `enemy${i + 1}`, Math.PI)
+		}
+	}
+}

package/starters/examples/src/examples/abilities/buffsLooks.ts

@@ -0,0 +1,46 @@
+/** How the buffs example looks, and its card: a button for each buff (`./buffs.ts`) */
+import { sharedLooks } from '../common/looks'
+import { buffsFamily } from './buffs'
+import type { FamilyLooks } from './looks'
+import { castButton, look, readyOn, resetButton } from './lookKit'
+
+/** A buff's look on its carrier: sparks of `shape` in its colour (`glow`) */
+const glow = (color: [number, number, number], shape: string, more: Record<string, unknown> = {}) =>
+	look(color, undefined, { aura: 'glow', options: { shape, ...more } })
+
+export const buffsLooks: FamilyLooks = {
+	units: {
+		abilitiesPaladin: { ...sharedLooks.knight, model: { ...sharedLooks.knight.model!, scale: 0.8 } },
+		abilitiesSoldier: sharedLooks.footman,
+		abilitiesDemon: { ...sharedLooks.knight, model: { ...sharedLooks.knight.model!, scale: 1.25 } }
+	},
+	abilities: {
+		abilitiesCastInnerFire: look([1, 0.55, 0.2], 'burst'),
+		abilitiesCastBarrier: look([0.5, 0.8, 1], 'burst'),
+		abilitiesImmolation: look([1, 0.45, 0.1], 'burst'),
+		abilitiesCastDoom: look([0.6, 0.05, 0.1], 'burst'),
+		abilitiesDefuse: look([1, 1, 1], 'sonar'),
+		abilitiesInnerFire: glow([1, 0.55, 0.2], 'rise'),
+		abilitiesBarrier: glow([0.5, 0.8, 1], 'shell'),
+		abilitiesDevotion: glow([1, 0.85, 0.4], 'ring'),
+		// a pip a stack over the carrier
+		abilitiesRend: look([0.9, 0.1, 0.1], undefined, { counter: { max: 5 }, aura: 'glow', options: { shape: 'fall', solid: true } }),
+		abilitiesRendStun: glow([1, 0.3, 0.3], 'ring', { at: 'head' }),
+		abilitiesImmolating: glow([1, 0.45, 0.1], 'column', { streaks: true }),
+		abilitiesTimeBomb: glow([1, 0.2, 0.1], 'ring', { at: 'head' }),
+		abilitiesDivineShield: glow([1, 0.95, 0.6], 'shell'),
+		abilitiesStasis: glow([0.95, 0.85, 0.3], 'shell'),
+		abilitiesUndying: glow([0.9, 0.2, 0.15], 'rise'),
+		abilitiesGhost: glow([0.7, 0.8, 1], 'dust'),
+		abilitiesCleaving: glow([0.9, 0.9, 0.9], 'about', { streaks: true }),
+		abilitiesMercy: glow([0.6, 1, 0.7], 'rise'),
+		abilitiesEcho: glow([0.6, 1, 0.7], 'shell'),
+		abilitiesDoom: glow([0.7, 0.05, 0.1], 'rise')
+	},
+	examples: {
+		'abilities-buffs': {
+			ready: (client) => readyOn(client, 'abilitiesPaladin', { minX: 18, minZ: 14, maxX: 30, maxZ: 28 }),
+			controls: [...buffsFamily.abilities.map((ability) => castButton(ability)), resetButton('abilities-buffs')]
+		}
+	}
+}

package/starters/examples/src/examples/abilities/changing.ts

@@ -0,0 +1,228 @@
+/**
+ * Changing abilities while the game runs (the ability changes pack, `abilityChangesPack`): one granted for a while,
+ * one swapped for a stronger one for a cast, an enemy's ultimate stolen, an enemy taken over, one upgraded for good;
+ * and forms (`morph`): a demon form for a while, a cougar form turned on and off, each with abilities of its own
+ */
+import { type AbilityDef, type BuffDef, defineCommand, upgradeAbility } from '@v12-engine/engine'
+import { exampleField } from '../define'
+import { ENEMY, PLAYER } from '../common/units'
+import type { Family } from './family'
+import { caster, put, sparring } from './kit'
+
+const buffs: BuffDef[] = [{ id: 'abilitiesSiphoned', name: 'Siphoned', harmful: true, duration: 3, percent: { moveSpeed: -0.5 } }]
+
+const abilities: AbilityDef[] = [
+	{
+		// added after the caster's others, for 20 seconds
+		id: 'abilitiesGift',
+		name: 'Gift',
+		description: 'Holy Nova, added to the card for 20 seconds',
+		hotkey: 'Q',
+		target: 'none',
+		cooldown: 1,
+		effects: [{ type: 'grantAbility', ability: 'abilitiesHolyNova', atLevel: 1, duration: 20, on: 'caster' }]
+	},
+	{
+		// Wildfire gives way to its awakened form for one cast, then comes back
+		id: 'abilitiesAwaken',
+		name: 'Awaken',
+		description: 'Wildfire becomes Wildfire Awakened for one cast',
+		hotkey: 'W',
+		target: 'none',
+		cooldown: 1,
+		effects: [{ type: 'swapAbility', from: 'abilitiesWildfire', ability: 'abilitiesWildfireAwakened', uses: 1, on: 'caster' }]
+	},
+	{
+		id: 'abilitiesWildfire',
+		name: 'Wildfire',
+		description: 'Burns round the nearest enemy for 60',
+		hotkey: 'E',
+		target: 'point',
+		range: 9,
+		cooldown: 0.5,
+		effects: [{ type: 'damage', amount: 60, radius: 1.5 }]
+	},
+	{
+		// the target's ultimate in the place of Hijack, for one cast
+		id: 'abilitiesHijack',
+		name: 'Hijack',
+		description: 'Takes the warlock’s ultimate, Cataclysm, for one cast in its place',
+		hotkey: 'R',
+		target: 'unit',
+		targets: { enemies: true },
+		range: 12,
+		cooldown: 1,
+		effects: [{ type: 'stealAbility', pick: 'ultimate' }]
+	},
+	{
+		id: 'abilitiesTakeOver',
+		name: 'Take over',
+		description: 'An enemy footman is yours for 15 seconds',
+		hotkey: 'T',
+		target: 'unit',
+		targets: { enemies: true },
+		range: 12,
+		cooldown: 1,
+		effects: [{ type: 'convert', duration: 15 }]
+	},
+	{
+		// what it may be made into for good (`upgrades`): the Upgrade button picks it
+		id: 'abilitiesSiphon',
+		name: 'Siphon Power',
+		description: 'A blow of 60; upgraded, it slows and heals the caster too',
+		hotkey: 'D',
+		target: 'unit',
+		targets: { enemies: true },
+		range: 9,
+		cooldown: 0.5,
+		upgrades: ['abilitiesSiphonAugmented'],
+		effects: [{ type: 'damage', amount: 60 }]
+	},
+	{
+		// another unit type where it stands, for 15 seconds: its stats and its abilities
+		id: 'abilitiesMetamorphosis',
+		name: 'Metamorphosis',
+		description: 'A demon for 15 seconds, with a demon’s strength and spells',
+		hotkey: 'F',
+		target: 'none',
+		cooldown: 1,
+		effects: [{ type: 'morph', into: 'abilitiesDemonForm', duration: 15 }]
+	},
+	{
+		// cast again (the cougar has it too) to turn back
+		id: 'abilitiesAspect',
+		name: 'Aspect of the Cougar',
+		description: 'A cougar until cast again, with a pounce of its own',
+		hotkey: 'G',
+		target: 'none',
+		cooldown: 1,
+		effects: [{ type: 'morph', into: 'abilitiesCougar', toggle: true }]
+	}
+]
+
+const more: AbilityDef[] = [
+	{
+		id: 'abilitiesHolyNova',
+		name: 'Holy Nova',
+		description: 'Heals allies and burns enemies within 4',
+		hotkey: 'Z',
+		target: 'none',
+		cooldown: 0.5,
+		effects: [
+			{ type: 'heal', amount: 100, radius: 4 },
+			{ type: 'damage', amount: 60, radius: 4 }
+		]
+	},
+	{
+		id: 'abilitiesWildfireAwakened',
+		name: 'Wildfire Awakened',
+		description: 'Burns round the nearest enemy for 250',
+		hotkey: 'E',
+		target: 'point',
+		range: 9,
+		cooldown: 0.5,
+		effects: [{ type: 'damage', amount: 250, radius: 3 }]
+	},
+	{
+		id: 'abilitiesSiphonAugmented',
+		name: 'Siphon Power+',
+		description: 'A blow of 60 that slows, and heals the caster as much',
+		hotkey: 'D',
+		target: 'unit',
+		targets: { enemies: true },
+		range: 9,
+		cooldown: 0.5,
+		effects: [
+			{ type: 'damage', amount: 60 },
+			{ type: 'buff', buff: 'abilitiesSiphoned' },
+			{ type: 'heal', amount: 60, on: 'caster' }
+		]
+	},
+	{
+		id: 'abilitiesCataclysm',
+		name: 'Cataclysm',
+		description: 'The warlock’s ultimate: fire falls round the spot',
+		target: 'point',
+		range: 12,
+		ultimate: true,
+		cooldown: 30,
+		effects: [{ type: 'after', delay: 0.8, effects: [{ type: 'damage', amount: 200, radius: 3.5 }] }]
+	},
+	{
+		id: 'abilitiesChaosBolt',
+		name: 'Chaos Bolt',
+		description: 'A demon’s bolt for 160',
+		hotkey: 'Q',
+		target: 'unit',
+		targets: { enemies: true },
+		range: 9,
+		cooldown: 0.5,
+		effects: [{ type: 'missile', homing: true, speed: 16, effects: [{ type: 'damage', amount: 160 }] }]
+	},
+	{
+		id: 'abilitiesPounce',
+		name: 'Pounce',
+		description: 'Leaps at the spot, clawing round where it lands',
+		hotkey: 'W',
+		target: 'point',
+		range: 5,
+		cooldown: 0.5,
+		effects: [{ type: 'dash', distance: 5, speed: 16, leap: 1, effects: [{ type: 'damage', amount: 80, radius: 1.5 }] }]
+	}
+]
+
+/** Makes Siphon Power into Siphon Power+ for good: what a player's pick of an upgrade does (`upgradeAbility`) */
+export const upgrade = defineCommand('abilities.upgrade', {}, (world, player) => {
+	const unit = world.named('caster')
+	if (unit && unit.owner === player) upgradeAbility(world, unit, 'abilitiesSiphon', 'abilitiesSiphonAugmented')
+})
+
+export const changing: Family = {
+	abilities,
+	more,
+	buffs,
+	commands: [upgrade],
+	units: [
+		caster(
+			'abilitiesShifter',
+			'Shifter',
+			abilities.map((each) => each.id)
+		),
+		// the forms: unit types of their own, with what they cast
+		caster('abilitiesDemonForm', 'Demon form', ['abilitiesChaosBolt'], {
+			radius: 0.6,
+			stats: {
+				health: 2000,
+				healthRegen: 10,
+				mana: 1000,
+				manaRegen: 60,
+				attackDamage: 60,
+				attackSpeed: 1,
+				attackRange: 0.7,
+				moveSpeed: 4.6,
+				armor: 15
+			}
+		}),
+		caster('abilitiesCougar', 'Cougar', ['abilitiesPounce', 'abilitiesAspect'], {
+			radius: 0.45,
+			stats: { health: 1200, healthRegen: 4, mana: 1000, manaRegen: 60, attackDamage: 45, attackSpeed: 1.4, attackRange: 0.5, moveSpeed: 5.5 }
+		}),
+		// an enemy with an ultimate to steal
+		sparring('abilitiesWarlock', 'Warlock', { abilities: ['abilitiesCataclysm'] })
+	],
+	example: {
+		id: 'abilities-changing',
+		category: 'abilities',
+		title: 'Changing abilities and forms',
+		summary:
+			'An ability granted for a while, one swapped for a stronger cast, the warlock’s ultimate stolen, a footman taken over, an upgrade for good, a demon form and a cougar form. Watch the card below change.',
+		tags: ['grant', 'swap', 'steal', 'convert', 'upgrade', 'morph', 'form', 'transform', 'shapeshift'],
+		source: ['examples/abilities/changing.ts', 'examples/abilities/kit.ts'],
+		map: () => exampleField({ name: 'Changing', players: 2 }),
+		start: (world) => {
+			put(world, 'abilitiesShifter', PLAYER, { x: 24, z: 18 }, 'caster')
+			put(world, 'abilitiesWarlock', ENEMY, { x: 28, z: 25 }, 'warlock', Math.PI)
+			for (const [i, x] of [20, 23].entries()) put(world, 'abilitiesTarget', ENEMY, { x, z: 25 }, `enemy${i + 1}`, Math.PI)
+		}
+	}
+}

package/starters/examples/src/examples/abilities/changingLooks.ts

@@ -0,0 +1,61 @@
+/** How the changing abilities example looks, and its card: what changes the card, and what the changes give */
+import { button } from '../../shell/look'
+import { character, hold, person, sharedLooks, TWO_HANDED } from '../common/looks'
+import { changing, upgrade } from './changing'
+import type { FamilyLooks } from './looks'
+import { castButton, look, readyOn, resetButton } from './lookKit'
+
+/** What the changes put on the card, cast by name: each is refused while the caster does not have it */
+const given = ['abilitiesHolyNova', 'abilitiesWildfireAwakened', 'abilitiesCataclysm', 'abilitiesChaosBolt', 'abilitiesPounce']
+
+export const changingLooks: FamilyLooks = {
+	units: {
+		abilitiesShifter: sharedLooks.mage,
+		abilitiesDemonForm: {
+			height: 2.6,
+			model: character('barbarian', 1.1, { hold: [hold('axe_2handed')] }),
+			attacks: [TWO_HANDED],
+			shapes: person(2.6, [0.5, 0.05, 0.1])
+		},
+		// the shared art has no animals: a cougar of parts, a long body and a head
+		abilitiesCougar: {
+			height: 1,
+			shapes: [
+				{ shape: 'sphere', size: [0.7, 0.6, 1.4], offset: [0, 0.6, 0], color: [0.75, 0.55, 0.3] },
+				{ shape: 'sphere', size: [0.45, 0.45, 0.5], offset: [0, 0.85, 0.75], color: [0.7, 0.5, 0.28] }
+			]
+		},
+		abilitiesWarlock: { ...sharedLooks.mage, model: character('skeleton_mage', 0.72, { hold: [hold('staff')] }) }
+	},
+	abilities: {
+		abilitiesGift: look([1, 0.95, 0.6], 'burst'),
+		abilitiesAwaken: look([1, 0.5, 0.1], 'burst'),
+		abilitiesWildfire: look([1, 0.5, 0.1], 'smash'),
+		abilitiesWildfireAwakened: look([1, 0.3, 0.05], 'smash'),
+		abilitiesHijack: look([0.4, 0.8, 1], 'tether'),
+		abilitiesTakeOver: look([1, 0.4, 0.8], 'tether'),
+		abilitiesSiphon: look([0.5, 0.3, 1], 'burst'),
+		abilitiesSiphonAugmented: look([0.3, 1, 0.8], 'burst'),
+		abilitiesMetamorphosis: look([0.6, 0.05, 0.1], 'tornado'),
+		abilitiesAspect: look([0.9, 0.7, 0.3], 'burst'),
+		abilitiesHolyNova: look([1, 0.95, 0.6], 'slam'),
+		abilitiesCataclysm: look([1, 0.35, 0.1], 'mark', { options: { lasts: 0.8, falls: 16, burst: 40 } }),
+		abilitiesChaosBolt: look([0.5, 1, 0.3], 'missile', { options: { shape: 'ball' } }),
+		abilitiesPounce: look([0.9, 0.7, 0.3], 'slam'),
+		abilitiesSiphoned: look([0.3, 1, 0.8], undefined, { aura: 'glow', options: { shape: 'fall' } })
+	},
+	examples: {
+		'abilities-changing': {
+			ready: (client) => readyOn(client, 'abilitiesShifter'),
+			controls: [
+				...changing.abilities.map((ability) => castButton(ability, ability.id === 'abilitiesHijack' ? { at: 'warlock' } : {})),
+				button('Upgrade Siphon Power', (client) => client.session.send(upgrade.make({})), 'Makes Siphon Power into Siphon Power+ for good'),
+				...given.map((id) => {
+					const ability = changing.more!.find((each) => each.id === id)!
+					return castButton(ability, { label: `${ability.name} (given)` })
+				}),
+				resetButton('abilities-changing')
+			]
+		}
+	}
+}