@vibemancer/core 0.1.0

package/src/bots/berserker/02_Stormcaller.ts

@@ -0,0 +1,417 @@
+import {
+	WizardFunction,
+	MissileAIFunction,
+	MissileActions,
+} from '../../types.js';
+import {angleTo} from '../../utils/angles.js';
+import {distanceTo} from '../../utils/distance.js';
+import {interceptAngle, moveInDirection} from '../../utils/movement.js';
+import {ARENA_SIZE, GCD_DURATION, SHIELD_CAST_TIME} from '../../rules.js';
+import {
+	getThreats,
+	getMostUrgentThreat,
+	getDodgeDirectionForMovement,
+	getBlinkToCenter,
+	fitMissileToBudget,
+	shouldForceShield,
+	MAX_CAST_BUDGET,
+	MIN_USEFUL_DAMAGE,
+} from '../shared.js';
+import {useParam} from '../../engine/params-runtime.js';
+const WALL_BUFFER = 80;
+
+const SHIELD_BUFFER = 3;
+
+/**
+ * Predictive homing missile AI - leads the target.
+ */
+const StormcallerMissileAI: MissileAIFunction = ({
+	worldState,
+	missileState,
+}) => 
+{
+	const enemy = worldState.enemies[0];
+	if (!enemy) return {};
+
+	const angle = interceptAngle(
+		missileState.position,
+		enemy.position,
+		enemy.velocity,
+		missileState.speed,
+	);
+	if (angle !== null) 
+	{
+		return {turnToward: moveInDirection(missileState.position, angle, 100)};
+	}
+	return {turnToward: enemy.position};
+};
+
+/**
+ * Check if position is near a wall.
+ */
+function isNearWall(position: {x: number; y: number}): boolean 
+{
+	return (
+		position.x < WALL_BUFFER ||
+    position.x > ARENA_SIZE - WALL_BUFFER ||
+    position.y < WALL_BUFFER ||
+    position.y > ARENA_SIZE - WALL_BUFFER
+	);
+}
+
+/**
+ * Smart combat movement with threat-aware dodging.
+ */
+function combatMove(
+	position: {x: number; y: number},
+	enemy: {position: {x: number; y: number}},
+	currentDistance: number,
+	targetDistance: number,
+	dodgeDirection: {x: number; y: number} | null,
+	tick: number,
+	strafeCyclePeriod: number,
+	strafeIntensity: number,
+	approachSpeed: number,
+	distanceDeadZone: number,
+): {x: number; y: number} 
+{
+	const deltaX = enemy.position.x - position.x;
+	const deltaY = enemy.position.y - position.y;
+	const normalizedDistance = currentDistance > 0 ? currentDistance : 1;
+
+	const strafeClockwise = {
+		x: -deltaY / normalizedDistance,
+		y: deltaX / normalizedDistance,
+	};
+	const strafeCounterClockwise = {
+		x: deltaY / normalizedDistance,
+		y: -deltaX / normalizedDistance,
+	};
+
+	let strafeDirection: {x: number; y: number};
+
+	if (dodgeDirection) 
+	{
+		strafeDirection = dodgeDirection;
+	}
+	else if (isNearWall(position)) 
+	{
+		const futureClockwise = {
+			x: position.x + strafeClockwise.x * 100,
+			y: position.y + strafeClockwise.y * 100,
+		};
+		const futureCounterClockwise = {
+			x: position.x + strafeCounterClockwise.x * 100,
+			y: position.y + strafeCounterClockwise.y * 100,
+		};
+		const scoreClockwise = Math.min(
+			futureClockwise.x,
+			ARENA_SIZE - futureClockwise.x,
+			futureClockwise.y,
+			ARENA_SIZE - futureClockwise.y,
+		);
+		const scoreCounterClockwise = Math.min(
+			futureCounterClockwise.x,
+			ARENA_SIZE - futureCounterClockwise.x,
+			futureCounterClockwise.y,
+			ARENA_SIZE - futureCounterClockwise.y,
+		);
+		strafeDirection =
+			scoreClockwise > scoreCounterClockwise
+				? strafeClockwise
+				: strafeCounterClockwise;
+	}
+	else 
+	{
+		const cycle = Math.floor(tick / strafeCyclePeriod) % 2;
+		strafeDirection = cycle === 0 ? strafeClockwise : strafeCounterClockwise;
+	}
+
+	if (dodgeDirection) 
+	{
+		return {x: strafeDirection.x * 100, y: strafeDirection.y * 100};
+	}
+
+	let moveX = strafeDirection.x * strafeIntensity;
+	let moveY = strafeDirection.y * strafeIntensity;
+
+	if (currentDistance > targetDistance + distanceDeadZone) 
+	{
+		moveX += (deltaX / normalizedDistance) * approachSpeed;
+		moveY += (deltaY / normalizedDistance) * approachSpeed;
+	}
+	else if (currentDistance < targetDistance - distanceDeadZone) 
+	{
+		let retreatX = -(deltaX / normalizedDistance) * approachSpeed;
+		let retreatY = -(deltaY / normalizedDistance) * approachSpeed;
+		if (position.x < WALL_BUFFER && retreatX < 0) retreatX = 0;
+		if (position.x > ARENA_SIZE - WALL_BUFFER && retreatX > 0) retreatX = 0;
+		if (position.y < WALL_BUFFER && retreatY < 0) retreatY = 0;
+		if (position.y > ARENA_SIZE - WALL_BUFFER && retreatY > 0) retreatY = 0;
+		moveX += retreatX;
+		moveY += retreatY;
+	}
+
+	const magnitude = Math.sqrt(moveX * moveX + moveY * moveY);
+	if (magnitude > 100) 
+	{
+		moveX = (moveX / magnitude) * 100;
+		moveY = (moveY / magnitude) * 100;
+	}
+
+	return {x: moveX, y: moveY};
+}
+
+/**
+ * Bot: Stormcaller
+ *
+ * BEHAVIOR: Enhanced Stormchaser with adaptive missile fitting (fitMissileToBudget)
+ * AND predictive homing missiles. Combines aggressive fighting philosophy with
+ * optimized damage output. Uses budget-based missile fitting to maximize damage
+ * within safe windows. Falls back to quick missiles under pressure. Same smart
+ * trade/shield decisions as Stormchaser but with better resource usage.
+ *
+ * PROGRESSION LINE: Stormchaser → Stormcaller → Stormforger
+ * - Stormchaser (tier 1): Adaptive missiles, smart trading, aggressive defense
+ * - Stormcaller (tier 2): + fitMissileToBudget, predictive homing, optimized damage
+ * - Stormforger (tier 3): Future — supreme berserker, perfect aggression
+ *
+ * TIER: 2 (enhanced Stormchaser)
+ */
+export const Stormcaller: WizardFunction = ({state}) => 
+{
+	// Tunable parameters (run optimizer script to find optimal values)
+	const targetDistance = useParam('targetDistance', 129, {
+		range: 200,
+		min: 0,
+	});
+	const minTurnRate = useParam('minTurnRate', 0.5, {range: 1.5, steps: 5});
+	const shieldHealthThreshold = useParam('shieldHealthThreshold', 20, {
+		range: 23,
+		min: 1,
+		steps: 7,
+	});
+	const strafeCyclePeriod = useParam('strafeCyclePeriod', 281, {
+		range: 75,
+		min: 80,
+		max: 300,
+	});
+	const strafeIntensity = useParam('strafeIntensity', 69, {
+		range: 40,
+		min: 20,
+		max: 100,
+		steps: 7,
+	});
+	const approachSpeed = useParam('approachSpeed', 69, {
+		range: 30,
+		min: 10,
+		max: 70,
+		steps: 7,
+	});
+	const distanceDeadZone = useParam('distanceDeadZone', 18, {
+		range: 25,
+		min: 10,
+		max: 60,
+		steps: 7,
+	});
+	const shieldCancelThreshold = useParam('shieldCancelThreshold', 150, {
+		range: 75,
+		min: 50,
+		max: 300,
+	});
+	const blinkWindowMax = useParam('blinkWindowMax', 70, {
+		range: 40,
+		min: 20,
+		max: 120,
+		steps: 7,
+	});
+	const attackRange = useParam('attackRange', 430, {
+		range: 200,
+		min: 300,
+		max: 800,
+	});
+	const flightTimeDivisor = useParam('flightTimeDivisor', 10.8, {
+		range: 4,
+		min: 2,
+		max: 12,
+		steps: 5,
+	});
+
+	const enemy = state.enemies[0];
+	if (!enemy) 
+	{
+		return {move: {x: 0, y: 0}};
+	}
+
+	const distance = distanceTo(state.position, enemy.position);
+
+	// Analyze threats using simulation
+	const threats = getThreats(state);
+	const urgentThreat = getMostUrgentThreat(threats);
+
+	// === DEFENSE: Handle channeling state ===
+	if (state.state === 'channeling') 
+	{
+		if (!urgentThreat || urgentThreat.ticksToImpact > shieldCancelThreshold) 
+		{
+			return {move: {x: 0, y: 0}, cancel: true};
+		}
+		return {move: {x: 0, y: 0}};
+	}
+
+	// === DEFENSE: Cancel missile cast only for LETHAL incoming damage ===
+	// DPS trade: we accepted the hit when we started casting. Only cancel to survive.
+	if (
+		state.state === 'casting' &&
+    state.castingSpell === 'missile' &&
+    urgentThreat &&
+    urgentThreat.projectile.damage >= state.health
+	) 
+	{
+		const remainingCast = (state.castDuration ?? 0) - (state.castProgress ?? 0);
+		if (
+			urgentThreat.ticksToImpact <=
+      remainingCast + GCD_DURATION + SHIELD_CAST_TIME + 1
+		) 
+		{
+			const dodgeDirection = getDodgeDirectionForMovement(
+				threats,
+				state.position,
+			);
+			const move = combatMove(
+				state.position,
+				enemy,
+				distance,
+				targetDistance,
+				dodgeDirection,
+				state.tick,
+				strafeCyclePeriod,
+				strafeIntensity,
+				approachSpeed,
+				distanceDeadZone,
+			);
+			return {move, cancel: true};
+		}
+	}
+
+	// === BLINK: Dodge missile + reposition (first priority) ===
+	// Blink dodges the incoming missile — no GCD after, so can immediately fire back.
+	// Only shield when blink is on cooldown.
+	if (
+		state.state === 'idle' &&
+    urgentThreat &&
+    state.blinkCooldown === 0 &&
+    urgentThreat.ticksToImpact >= 10 &&
+    urgentThreat.ticksToImpact <= blinkWindowMax
+	) 
+	{
+		return {
+			move: {x: 0, y: 0},
+			startCast: {spell: 'blink', target: getBlinkToCenter(state.position)},
+		};
+	}
+
+	// === DEFENSE: Shield threats (when blink is on cooldown) ===
+	if (state.state === 'idle' && urgentThreat) 
+	{
+		const forceShield = shouldForceShield(urgentThreat);
+		const undodgeable = !urgentThreat.bestDodgeDirection;
+		const healthLow = state.health < shieldHealthThreshold;
+		const healthCritical =
+			state.health <= urgentThreat.projectile.damage * 2 + 1;
+		const doShield =
+			forceShield || (undodgeable && healthLow) || healthCritical;
+
+		if (doShield && urgentThreat.canBlockInTime) 
+		{
+			if (urgentThreat.ticksToStartShield <= 3) 
+			{
+				return {
+					move: {x: 0, y: 0},
+					startCast: {spell: 'shield'},
+				};
+			}
+		}
+	}
+
+	// === MOVEMENT: Smart combat movement ===
+	const dodgeDirection = getDodgeDirectionForMovement(threats, state.position);
+	const move = combatMove(
+		state.position,
+		enemy,
+		distance,
+		targetDistance,
+		dodgeDirection,
+		state.tick,
+		strafeCyclePeriod,
+		strafeIntensity,
+		approachSpeed,
+		distanceDeadZone,
+	);
+
+	// === OFFENSE: Adaptive missile fitting with predictive homing ===
+	if (state.state === 'idle' && distance < attackRange) 
+	{
+		let nextThreatTime = urgentThreat?.ticksToImpact ?? Infinity;
+
+		// Account for enemy's active cast — their missile will arrive after cast completes + flight time
+		if (enemy.state === 'casting' && enemy.castingSpell === 'missile') 
+		{
+			const remainingEnemyCast =
+				(enemy.castDuration ?? 0) - (enemy.castProgress ?? 0);
+			const estimatedFlightTime = distance / flightTimeDivisor;
+			nextThreatTime = Math.min(
+				nextThreatTime,
+				remainingEnemyCast + estimatedFlightTime,
+			);
+		}
+
+		const safeBudget =
+			nextThreatTime - GCD_DURATION - SHIELD_CAST_TIME - SHIELD_BUFFER;
+		const budgetTicks = Math.min(safeBudget, MAX_CAST_BUDGET);
+
+		// Predictive homing compensates for movement during cast
+		const enemyHP = Math.ceil(enemy.health);
+		const minDmg = Math.min(MIN_USEFUL_DAMAGE, enemyHP);
+		const config = fitMissileToBudget(budgetTicks, distance, {
+			minTurnRate,
+			maxDamage: enemyHP,
+			lastMissileConfig: state.lastMissileConfig,
+		});
+
+		if (config && config.damage >= minDmg) 
+		{
+			return {
+				move,
+				startCast: {
+					spell: 'missile',
+					config,
+					missileAI:
+            config.turnRate > 0
+            	? StormcallerMissileAI
+            	: (): MissileActions => ({}),
+					direction: angleTo(state.position, enemy.position),
+				},
+			};
+		}
+
+		// Budget too small for useful missile — wait for threat to pass, then fire
+	}
+
+	// === FALLBACK DEFENSE: Shield when no attack window exists ===
+	if (
+		state.state === 'idle' &&
+    urgentThreat &&
+    !urgentThreat.bestDodgeDirection &&
+    urgentThreat.canBlockInTime &&
+    urgentThreat.ticksToStartShield <= 3
+	) 
+	{
+		return {
+			move: {x: 0, y: 0},
+			startCast: {spell: 'shield'},
+		};
+	}
+
+	return {move};
+};