@vibemancer/core 0.1.3 → 0.1.5

package/src/bots/homing/01_Bonemancer.ts

@@ -1,13 +1,13 @@
-import {WizardFunction, MissileAIFunction} from '../../types.js';
+import type {FinalAction, MissileFunction} from '../../hooks/index.js';
+import {usePosition, useEnemy, useStatus, idle, missile, move, getMissileContext, turnToward, flyStraight} from '../../hooks/index.js';
 import {angleTo} from '../../utils/angles.js';
+import {keepOffWalls} from '../shared.js';
 
-const SimpleHoming: MissileAIFunction = ({worldState}) => 
+const SimpleHoming: MissileFunction = () =>
 {
-	// Note: random is available but not used by this simple homing AI
-	const enemy = worldState.enemies[0];
-	return {
-		turnToward: enemy?.position,
-	};
+	const ctx = getMissileContext();
+	const enemy = ctx.worldState.enemies[0];
+	return enemy ? turnToward(enemy.position.x, enemy.position.y) : flyStraight();
 };
 
 /**
@@ -35,33 +35,21 @@ const SimpleHoming: MissileAIFunction = ({worldState}) =>
  *
  * TIER: 1 (base)
  */
-export const Bonemancer: WizardFunction = ({state}) => 
+export function Bonemancer(): FinalAction
 {
-	const enemy = state.enemies[0];
-	if (!enemy) 
-	{
-		return {move: {x: 0, y: 0}};
-	}
+	const position = usePosition();
+	const enemy = useEnemy();
+	const status = useStatus();
 
-	if (state.state === 'idle') 
+
+	if (status === 'idle') 
 	{
-		return {
-			move: {x: 0, y: 0},
-			startCast: {
-				spell: 'missile',
-				config: {
-					damage: 12,
-					speed: 3,
-					turnRate: 2,
-					duration: 300,
-				},
-				missileAI: SimpleHoming,
-				direction: angleTo(state.position, enemy.position),
-			},
-		};
+		return missile(
+			{damage: 12, speed: 3, turnRate: 2, duration: 300},
+			SimpleHoming,
+			angleTo(position, enemy.position),
+		).move(keepOffWalls(position).x, keepOffWalls(position).y);
 	}
 
-	return {
-		move: {x: 0, y: 0},
-	};
-};
+	{ const h = keepOffWalls(position); return (h.x !== 0 || h.y !== 0) ? move(h.x, h.y) : idle(); }
+}

package/src/bots/homing/02_Lich.ts

@@ -1,9 +1,9 @@
-import {WizardFunction, MissileAIFunction} from '../../types.js';
+import type {FinalAction, MissileFunction} from '../../hooks/index.js';
+import {usePosition, useEnemy, useStatus, useBlinkCooldown, useHealth, useTick, useThreats, useProjectiles, useMyProjectiles, useLastMissileConfig, useCastingSpell, useCastProgress, idle, move as moveAction, missile, shield, blink, cancel, getMissileContext, turnToward, flyStraight} from '../../hooks/index.js';
 import {angleTo} from '../../utils/angles.js';
 import {distanceTo} from '../../utils/distance.js';
-import {ARENA_SIZE, GCD_DURATION, SHIELD_CAST_TIME} from '../../rules.js';
+import {RULES, ARENA_MIN, ARENA_MAX} from '../../rules.js';
 import {
-	getThreats,
 	getMostUrgentThreat,
 	getDodgeDirectionForMovement,
 	getBlinkToCenter,
@@ -11,6 +11,8 @@ import {
 	shouldForceShield,
 	MAX_CAST_BUDGET,
 	MIN_USEFUL_DAMAGE,
+	keepOffWalls,
+	getPreCastReposition,
 } from '../shared.js';
 import {useParam} from '../../engine/params-runtime.js';
 
@@ -18,19 +20,20 @@ const WALL_BUFFER = 60;
 
 const SHIELD_BUFFER = 3;
 
-const HomingAI: MissileAIFunction = ({worldState}) => 
+const HomingAI: MissileFunction = () =>
 {
-	const enemy = worldState.enemies[0];
-	return {turnToward: enemy?.position};
+	const ctx = getMissileContext();
+	const enemy = ctx.worldState.enemies[0];
+	return enemy ? turnToward(enemy.position.x, enemy.position.y) : flyStraight();
 };
 
 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
+		position.x < ARENA_MIN + WALL_BUFFER ||
+    position.x > ARENA_MAX - WALL_BUFFER ||
+    position.y < ARENA_MIN + WALL_BUFFER ||
+    position.y > ARENA_MAX - WALL_BUFFER
 	);
 }
 
@@ -74,16 +77,16 @@ function smartStrafe(
 			y: position.y + strafeCounterClockwise.y * 100,
 		};
 		const scoreClockwise = Math.min(
-			futureClockwise.x,
-			ARENA_SIZE - futureClockwise.x,
-			futureClockwise.y,
-			ARENA_SIZE - futureClockwise.y,
+			futureClockwise.x - ARENA_MIN,
+			ARENA_MAX - futureClockwise.x,
+			futureClockwise.y - ARENA_MIN,
+			ARENA_MAX - futureClockwise.y,
 		);
 		const scoreCounterClockwise = Math.min(
-			futureCounterClockwise.x,
-			ARENA_SIZE - futureCounterClockwise.x,
-			futureCounterClockwise.y,
-			ARENA_SIZE - futureCounterClockwise.y,
+			futureCounterClockwise.x - ARENA_MIN,
+			ARENA_MAX - futureCounterClockwise.x,
+			futureCounterClockwise.y - ARENA_MIN,
+			ARENA_MAX - futureCounterClockwise.y,
 		);
 		strafeDir =
 			scoreClockwise > scoreCounterClockwise
@@ -96,7 +99,7 @@ function smartStrafe(
 		strafeDir = cycle === 0 ? strafeClockwise : strafeCounterClockwise;
 	}
 
-	const intensity = dodgeDirection ? 100 : strafeIntensity;
+	const intensity = dodgeDirection ? 1 : strafeIntensity;
 	return {x: strafeDir.x * intensity, y: strafeDir.y * intensity};
 }
 
@@ -122,36 +125,50 @@ function smartStrafe(
  *
  * TIER: 2 (enhanced Bonemancer)
  */
-export const Lich: WizardFunction = ({state}) => 
+export function Lich(): FinalAction
 {
-	const targetDistance = useParam('targetDistance', 768, {
+	const position = usePosition();
+	const enemy = useEnemy();
+	const status = useStatus();
+	const blinkCooldown = useBlinkCooldown();
+	const health = useHealth();
+	const tick = useTick();
+	const threats = useThreats();
+	const projectiles = useProjectiles();
+	const myProjectiles = useMyProjectiles();
+	const lastMissileConfig = useLastMissileConfig();
+	const castingSpell = useCastingSpell();
+	const castProgressData = useCastProgress();
+
+
+	const targetDistance = useParam('targetDistance', 254, {
 		range: 175,
 		min: 0,
 	});
-	const minTurnRate = useParam('minTurnRate', 0.4, {range: 1.5, steps: 5});
+	const minTurnRate = useParam('minTurnRate', 0.2, {range: 1.5, steps: 5});
 	const shieldHealthThreshold = useParam('shieldHealthThreshold', 99, {
 		range: 23,
 		min: 1,
 		steps: 7,
 	});
-	const strafeCyclePeriod = useParam('strafeCyclePeriod', 138, {
+	const strafeCyclePeriod = useParam('strafeCyclePeriod', 132, {
 		range: 75,
 		min: 80,
 		max: 300,
 	});
-	const strafeIntensity = useParam('strafeIntensity', 100, {
-		range: 40,
-		min: 20,
-		max: 100,
+	const strafeIntensity = useParam('strafeIntensity', 0.78, {
+		range: 0.4,
+		min: 0.2,
+		max: 1,
 		steps: 7,
 	});
-	const approachSpeed = useParam('approachSpeed', 62, {
-		range: 30,
-		min: 10,
-		max: 70,
+	const approachSpeed = useParam('approachSpeed', 0.7, {
+		range: 0.3,
+		min: 0.1,
+		max: 0.7,
 		steps: 7,
 	});
-	const distanceDeadZone = useParam('distanceDeadZone', 7, {
+	const distanceDeadZone = useParam('distanceDeadZone', 6, {
 		range: 30,
 		min: 5,
 		max: 80,
@@ -162,36 +179,51 @@ export const Lich: WizardFunction = ({state}) =>
 		min: 50,
 		max: 300,
 	});
-	const blinkWindowMax = useParam('blinkWindowMax', 27, {
+	const blinkWindowMax = useParam('blinkWindowMax', 35, {
 		range: 30,
 		min: 15,
 		max: 80,
 		steps: 7,
 	});
-	const flightTimeDivisor = useParam('flightTimeDivisor', 5.8, {
+	const flightTimeDivisor = useParam('flightTimeDivisor', 12, {
 		range: 4,
 		min: 2,
 		max: 12,
 		steps: 5,
 	});
+	const centerBias = useParam('centerBias', 0.22, {
+		range: 0.4,
+		min: 0,
+		max: 0.8,
+		steps: 5,
+	});
+	const maxBlinkDistance = useParam('maxBlinkDistance', 244, {
+		range: 100,
+		min: 50,
+		max: 300,
+		steps: 7,
+	});
+
+	const distance = distanceTo(position, enemy.position);
 
-	const enemy = state.enemies[0];
-	if (!enemy) 
+	function capBlinkDistance(target: {x: number; y: number}): {x: number; y: number}
 	{
-		return {move: {x: 0, y: 0}};
+		const dx = target.x - position.x;
+		const dy = target.y - position.y;
+		const dist = Math.sqrt(dx * dx + dy * dy);
+		if (dist <= maxBlinkDistance) return target;
+		const scale = maxBlinkDistance / dist;
+		return {x: position.x + dx * scale, y: position.y + dy * scale};
 	}
 
-	const distance = distanceTo(state.position, enemy.position);
-
-	const threats = getThreats(state);
 	const urgentThreat = getMostUrgentThreat(threats);
 
-	const dodgeDirection = getDodgeDirectionForMovement(threats, state.position);
+	const dodgeDirection = getDodgeDirectionForMovement(threats, position);
 	const strafe = smartStrafe(
-		state.position,
+		position,
 		enemy,
 		dodgeDirection,
-		state.tick,
+		tick,
 		strafeCyclePeriod,
 		strafeIntensity,
 	);
@@ -202,14 +234,22 @@ export const Lich: WizardFunction = ({state}) =>
 
 	if (!dodgeDirection) 
 	{
-		const deltaX = enemy.position.x - state.position.x;
-		const deltaY = enemy.position.y - state.position.y;
+		const deltaX = enemy.position.x - position.x;
+		const deltaY = enemy.position.y - position.y;
 		const normalizedDistance = distance > 0 ? distance : 1;
 
-		if (distance > targetDistance + distanceDeadZone) 
+		if (distance > targetDistance + distanceDeadZone)
 		{
-			moveX += (deltaX / normalizedDistance) * approachSpeed;
-			moveY += (deltaY / normalizedDistance) * approachSpeed;
+			// Approach the center-side of the enemy so knockback pushes toward center, not lava.
+			const center = (ARENA_MIN + ARENA_MAX) / 2;
+			const toCenterX = center - enemy.position.x;
+			const toCenterY = center - enemy.position.y;
+			const toCenterDist = Math.sqrt(toCenterX * toCenterX + toCenterY * toCenterY) || 1;
+			const approachDirX = deltaX / normalizedDistance + (toCenterX / toCenterDist) * centerBias;
+			const approachDirY = deltaY / normalizedDistance + (toCenterY / toCenterDist) * centerBias;
+			const approachMag = Math.sqrt(approachDirX * approachDirX + approachDirY * approachDirY) || 1;
+			moveX += (approachDirX / approachMag) * approachSpeed;
+			moveY += (approachDirY / approachMag) * approachSpeed;
 		}
 		else if (distance < targetDistance - distanceDeadZone) 
 		{
@@ -219,39 +259,40 @@ export const Lich: WizardFunction = ({state}) =>
 	}
 
 	const magnitude = Math.sqrt(moveX * moveX + moveY * moveY);
-	if (magnitude > 100) 
+	if (magnitude > 1)
 	{
-		moveX = (moveX / magnitude) * 100;
-		moveY = (moveY / magnitude) * 100;
+		moveX = moveX / magnitude;
+		moveY = moveY / magnitude;
 	}
 
 	const move = {x: moveX, y: moveY};
+	const safeMove = keepOffWalls(position, move);
 
 	// === DEFENSE: Handle channeling ===
-	if (state.state === 'channeling') 
+	if (status === 'channeling') 
 	{
 		if (!urgentThreat || urgentThreat.ticksToImpact > shieldCancelThreshold) 
 		{
-			return {move, cancel: true};
+			return cancel().move(safeMove.x, safeMove.y);
 		}
-		return {move: {x: 0, y: 0}};
+		return idle();
 	}
 
 	// === DEFENSE: Cancel missile cast only for LETHAL incoming damage ===
 	if (
-		state.state === 'casting' &&
-    state.castingSpell === 'missile' &&
+		status === 'casting' &&
+    castingSpell === 'missile' &&
     urgentThreat &&
-    urgentThreat.projectile.damage >= state.health
+    urgentThreat.projectile.damage >= health
 	) 
 	{
-		const remainingCast = (state.castDuration ?? 0) - (state.castProgress ?? 0);
+		const remainingCast = ((castProgressData?.total) ?? 0) - ((castProgressData?.current) ?? 0);
 		if (
 			urgentThreat.ticksToImpact <=
-      remainingCast + GCD_DURATION + SHIELD_CAST_TIME + SHIELD_BUFFER
+      remainingCast + RULES.GCD_DURATION + RULES.SHIELD_CAST_TIME + SHIELD_BUFFER
 		) 
 		{
-			return {move, cancel: true};
+			return cancel().move(safeMove.x, safeMove.y);
 		}
 	}
 
@@ -259,28 +300,26 @@ export const Lich: WizardFunction = ({state}) =>
 	// Blink dodges the incoming missile — no GCD after, so can immediately resume casting.
 	// Only shield when blink is on cooldown.
 	if (
-		state.state === 'idle' &&
+		status === 'idle' &&
     urgentThreat &&
-    state.blinkCooldown === 0 &&
+    blinkCooldown === 0 &&
     urgentThreat.ticksToImpact >= 10 &&
     urgentThreat.ticksToImpact <= blinkWindowMax
 	) 
 	{
-		return {
-			move: {x: 0, y: 0},
-			startCast: {spell: 'blink', target: getBlinkToCenter(state.position)},
-		};
+		const blinkTarget = capBlinkDistance(getBlinkToCenter(position));
+		return blink(blinkTarget.x, blinkTarget.y);
 	}
 
 	// === DEFENSE: Shield threats (when blink on cooldown) ===
 	// Shield undodgeable, high-damage homing, or when health is critical
-	if (state.state === 'idle' && urgentThreat) 
+	if (status === 'idle' && urgentThreat) 
 	{
 		const forceShield = shouldForceShield(urgentThreat);
 		const undodgeable = !urgentThreat.bestDodgeDirection;
-		const healthLow = state.health < shieldHealthThreshold;
+		const healthLow = health < shieldHealthThreshold;
 		const healthCritical =
-			state.health <= urgentThreat.projectile.damage * 2 + 1;
+			health <= urgentThreat.projectile.damage * 2 + 1;
 		const doShield =
 			forceShield || (undodgeable && healthLow) || healthCritical;
 
@@ -290,30 +329,51 @@ export const Lich: WizardFunction = ({state}) =>
       urgentThreat.ticksToStartShield <= SHIELD_BUFFER
 		) 
 		{
-			return {
-				move: {x: 0, y: 0},
-				startCast: {spell: 'shield'},
-			};
+			return shield();
+		}
+	}
+
+	// === Preemptive shield — shield when enemy is casting a missile at close range ===
+	if (
+		status === 'idle' &&
+		distance < 300 &&
+		enemy.status === 'casting' &&
+		enemy.castingSpell === 'missile'
+	)
+	{
+		const remainingCast = (enemy.castDuration ?? 0) - (enemy.castProgress ?? 0);
+		const estimatedFlightTicks = distance / 8;
+		const ticksUntilHit = remainingCast + estimatedFlightTicks;
+
+		if (
+			ticksUntilHit >= RULES.SHIELD_CAST_TIME &&
+			ticksUntilHit < RULES.SHIELD_CAST_TIME + 15
+		)
+		{
+			return shield();
 		}
 	}
 
 	// === OFFENSE: Adaptive strong-tracking homing missiles ===
 	// minTurnRate 1.0 gives better tracking than other bots (0.5) at the cost of damage/speed.
 	// Skip offense when a lethal missile could reach us during cast+GCD — dodge at full speed instead
-	const myProjectileIds = new Set(state.myProjectiles.map((p) => p.id));
-	const hasNearbyLethalMissile = state.projectiles.some(
+	const myProjectileIds = new Set(myProjectiles.map((p) => p.id));
+	const hasNearbyLethalMissile = projectiles.some(
 		(p) =>
 			!myProjectileIds.has(p.id) &&
-      p.damage >= state.health &&
-      distanceTo(state.position, p.position) / p.speed <
-        MAX_CAST_BUDGET + GCD_DURATION,
+      p.damage >= health &&
+      distanceTo(position, p.position) / p.speed <
+        MAX_CAST_BUDGET + RULES.GCD_DURATION,
 	);
-	if (state.state === 'idle' && !hasNearbyLethalMissile) 
+	if (status === 'idle' && !hasNearbyLethalMissile)
 	{
+		const reposition = getPreCastReposition(position, enemy.position);
+		if (reposition) return moveAction(reposition.x, reposition.y);
+
 		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') 
+		if (enemy.status === 'casting' && enemy.castingSpell === 'missile')
 		{
 			const remainingEnemyCast =
 				(enemy.castDuration ?? 0) - (enemy.castProgress ?? 0);
@@ -325,7 +385,7 @@ export const Lich: WizardFunction = ({state}) =>
 		}
 
 		const safeBudget =
-			nextThreatTime - GCD_DURATION - SHIELD_CAST_TIME - SHIELD_BUFFER;
+			nextThreatTime - RULES.GCD_DURATION - RULES.SHIELD_CAST_TIME - SHIELD_BUFFER;
 		const budgetTicks = Math.min(safeBudget, MAX_CAST_BUDGET);
 
 		// Lich specializes in strong tracking (minTurnRate 1.0 vs typical 0.5)
@@ -333,24 +393,16 @@ export const Lich: WizardFunction = ({state}) =>
 		const minDmg = Math.min(MIN_USEFUL_DAMAGE, enemyHP);
 		const config = fitMissileToBudget(budgetTicks, distance, {
 			minTurnRate,
-			lastMissileConfig: state.lastMissileConfig,
+			lastMissileConfig: lastMissileConfig,
 		});
 
 		if (config && config.damage >= minDmg) 
 		{
-			return {
-				move,
-				startCast: {
-					spell: 'missile',
-					config,
-					missileAI: HomingAI,
-					direction: angleTo(state.position, enemy.position),
-				},
-			};
+			return missile(config, HomingAI, angleTo(position, enemy.position)).move(safeMove.x, safeMove.y);
 		}
 
 		// Budget too small for useful missile — wait for threat to pass, then fire
 	}
 
-	return {move};
-};
+	return moveAction(safeMove.x, safeMove.y);
+}