class: ActorLocator

const startPos = await enemy.getLocation();

await player.waitForGameplayTag("Status.Stunned");

await player.triggerAbilityByTag("Ability.Slot.Q");

const pos = await player.getLocation();
console.log(pos.x, pos.y, pos.z);

const forward = await player.getForwardVector();

await player.setLocation({ x: 0, y: 0, z: 1000 });

await player.setRotation({ pitch: 0, yaw: 90, roll: 0 });

await player.setTransform({ location: { x: 0, y: 0, z: 0 }, rotation: { pitch: 0, yaw: 0, roll: 0 }, scale: { x: 1, y: 1, z: 1 } });

await boss.highlight("Target Acquired!");

const isVisible = await boss.checkVisibility(true);

const localPlayer = world.actor('BP_Hero_Shooter').isLocallyControlled(true);

const id = await player.getPlayerId();

const skeleton = player.getByComponent("Skeleton");
await expect(skeleton).toHaveBoneRotation("head", { pitch: 0, yaw: 90, roll: 0 });

// Grabs the widget from Steel's UWidgetComponent:
const healthBar = steel.widget();
await expect(healthBar).toBeVisible();

const healthBar = steel.widgetComponent("HealthBarComponent");

const healthImage = steel.getByRole("image", { name: "HealthBarImage" });
await expect(healthImage).toBeVisible();

// 1. Resolve and pin the current last minion in the level:
const targetMinion = await world.actor("BP_MinionRange").last().pin();

// 2. High-frequency polling now executes in O(1) ~0.001ms time:
await expect(targetMinion).toHaveLocation({ x: 100, y: 200, z: 92 });

// 3. Spawning new minions will not hijack targetMinion:
await world.spawnActor("BP_MinionRange");
await targetMinion.highlight("Still Original Minion");

await fireHazard.destroy();
await expect(fireHazard).toBeDestroyed();

const info = await actor.getControllerInfo();
console.log(info.isPossessed);        // true
console.log(info.isPlayerControlled); // false (AI bot)
console.log(info.controllerClass);    // "BP_BossAIController"

const possessed = await minion.isPossessed();

const isHuman = await player.isPlayerControlled();

const health = await player.getAttributeValue("HealthSet", "Health");

const isStunned = await player.hasGameplayTag("Status.Stunned");

const tags = await enemy.getGameplayTags();
console.log(tags); // ['Status.Stunned', 'Status.Burning']

// Wait for the stun tag to be applied
await boss.waitForGameplayTag("Status.Stunned", true);

const result = await player.waitForAttributeValue("HealthSet", "Health", 0);
console.log("Health dropped to 0! History:", result.history);

await player.triggerAbilityByTag("Ability.Attack.Melee");

await player.triggerAbilityWithTarget("Ability.Spell.Fireball", boss);

await player.applyGameplayEffect("/Game/Effects/GE_Damage_Poison.GE_Damage_Poison_C");

const isPoisoned = await player.hasActiveGameplayEffect("/Game/Effects/GE_Damage_Poison.GE_Damage_Poison_C");

import { SpecterInputSequence } from '@specter-automation/test';

const accelerate = new SpecterInputSequence()
    .addAxisSweep('Gamepad_RightTrigger', 0.0, 1.0, 0, 2000);

await playerCar.playSequence(accelerate);

// Quick press
await player.pressKey("SpaceBar");

// Hold the button for 500ms
await player.pressKey("Gamepad_FaceButton_Bottom", { holdMs: 500 });

// Pull the right trigger 10% on a specific player's controller
await playerActor.injectAxis('Gamepad_RightTrigger', 0.1);

await player.type("Hello Specter!");

// Trigger a digital jump action
await player.triggerInputAction('IA_Jump', true);

// Trigger a 2D analog movement vector payload
await player.triggerInputAction('IA_Move', { x: 0.0, y: 1.0, z: 0.0 });

const hasIMC = await player.hasInputMappingContext("IMC_DefaultPlayer");

const info = await player.getInputActionValue("IA_Sprint");
console.log("Bool state:", info.boolValue);

const fov = await player.getCameraFOV(); // default: 90

await player.setCameraFOV(110);

const shaking = await player.isCameraShaking();

const target = await player.getCameraViewTarget();

const navigating = await aiPawn.isAINavigating();

const goal = await aiPawn.getAINavGoal();
console.log(goal.x, goal.y, goal.z);

const teamId = await player.getTeamId(); // 255 = NoTeam

const attitude = await player.getTeamAttitudeTowards(enemy);
// Returns: 'Friendly' | 'Hostile' | 'Neutral'

await player.drawTrail({
  duration: 6,           // How long trail recorder runs (seconds)
  color: 'cyan',         // 'cyan' | 'magenta' | 'yellow' | 'red' | 'green' | hex (#RRGGBB)
  thickness: 4.0,        // Line thickness in viewport
  segmentDuration: 12.0  // Persistence of each drawn ribbon segment
});

// Forward facing vector arrow
await player.drawDirectionArrow({ length: 200, color: 'cyan', duration: 5 });

// Velocity vector arrow
await player.drawDirectionArrow({ length: 200, color: 'yellow', duration: 5, useVelocity: true });

// Live auto-updating stats billboard floating above actor
await marshmallow.showStatsBillboard({
  attributes: ['Health', 'ToastLevel', 'MoveSpeed'],
  properties: ['bCanBeDamaged'],
  duration: 15,
  color: 'yellow'
});

// Reconfigure stats tracked on the fly
await marshmallow.updateStatsBillboard({
  attributes: ['Health', 'ToastLevel'],
  color: 'red'
});

await player.clearDebugVisuals();