class: SpecterWorld

const world = await SpecterWorld.connect();

await world.joinHost("192.168.1.100", "Arena_P");

await world.close();

await world.cleanup();

await world.loadMap("/Game/Maps/Arena", { listen: true });

await world.waitForMapLoad("Arena");

console.log(world.currentMap);

const status = await world.getNetworkStatus();

const boss = await world.spawnActor('/Game/Blueprints/Enemies/BP_Boss');

await world.evaluate("TakeScreenshot", { fileName: "menu" });

await world.console("cheat god");

// Fast-forward simulation at 2x speed
await world.setTimeScale(2.0);

// Slow down simulation to half speed for physics validation
await world.setTimeDilation(0.5);

// Advance simulation by 1 frame
await world.stepFrame(1);

// Step 5 frames during combat collision resolution
await world.stepFrame(5);

// Fast-forward 60 in-game seconds in ~500ms of real time!
await world.advanceTime(60.0);
await expect(steelActor).not.toHaveGameplayTag("Cooldown.Abilities.R");

// Waits for 5 in-game seconds (takes 500ms if timeDilation is 10.0)
await world.waitForGameSeconds(5.0);

await world.waitForTimeout(1000); // Wait 1 second

const path = await world.takeScreenshot("inventory_open", true);

const matchStateVar = await world.actor('GameStateBase').trackProperty('MatchState');

// Wait for game state to transition to in-progress
const event = await world.waitForVariable(matchStateVar, "InProgress");
console.log(`Match started at engine timestamp: ${event.timestamp}s`);

// Fast-forward or wait until Wave 5 with a custom 10s timeout
const waveVar = await world.actor('BP_WaveSpawner').trackProperty('CurrentWave');
await world.waitForVariable(waveVar, "5", 10000);

// Custom timeout & predicate options
await world.waitForEvent('playerJoined', {
    timeout: 10000,
    predicate: (data) => data.playerName === 'Player_1'
});

// Option 1: Press and hold the key for 2000ms (2 seconds) before releasing
await world.keyboard.press('E', 2000);

// Option 2: Manually hold the key down indefinitely (e.g., walking forward)
await world.keyboard.down('W');
await world.waitForEvent('SomeEvent'); // Wait for something to happen while walking
await world.keyboard.up('W'); // Release it

await world.keyboard.up('W');

// Push the left thumbstick 50% forward for one frame
await world.injectAxis('Gamepad_LeftY', 0.5);

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

const spinAttack = new SpecterInputSequence()
    .addAxisCircle('Gamepad_LeftX', 'Gamepad_LeftY', 0, 1500, 2);

await world.playSequence(spinAttack);

// By Class Name (Default)
const player = world.actor("BP_Hero");

// By Gameplay Tag Prefix Selector (Playwright-style)
const boss = world.actor("Tag:Enemy.Boss");
const bossAlt = world.actor("tag=Enemy.Boss");

const enemy = world.actorByTag("Enemy.Boss");

const inventory = world.widget("WBP_Inventory");

const p1 = world.getByPlayerId(0);

const audio = world.subsystem("AudioSubsystem");

const saveGame = world.uobject("MySaveGame");

const metrics = await world.getPerformanceMetrics();
console.log(`FPS: ${metrics.fps}`);
console.log(`Frame Time: ${metrics.frameTimeMs}ms`);
console.log(`Memory: ${metrics.memoryMb}MB`);

// Assert minimum performance threshold
expect(metrics.fps).toBeGreaterThan(30);

const reachable = await world.isPointReachable(
  { x: 100, y: 200, z: 0 },
  { x: 500, y: 600, z: 0 }
);
expect(reachable).toBe(true);

const playing = await world.isSequencePlaying('IntroSequence');

const pos = await world.getSequencePlaybackPosition('IntroSequence');
console.log(`Cutscene is at ${pos}s`);

// Jump to the 5-second mark of the intro cutscene
await world.scrubSequence('IntroSequence', 5.0);

// Verify the cutscene spawned a specific actor at that moment
await expect(world.actor('BP_CutsceneBoss')).toBeVisible();

await client1.network.setEmulatedLatency(150);

await client1.network.setPacketLoss(5);

await client1.network.resetNetworkEmulation();

// AOE Blast / Capture Zone Sphere
await world.drawDebugSphere({
  center: { x: 0, y: 0, z: 92 },
  radius: 300,
  color: 'orange',
  duration: 8,
  thickness: 2
});

// 3D Trigger Volume Box
await world.drawDebugBox({
  center: { x: 0, y: 300, z: 92 },
  extent: { x: 100, y: 100, z: 50 },
  color: 'magenta',
  duration: 8
});

// Line Trace / Raycast
await world.drawDebugLine({
  start: { x: -250, y: -200, z: 92 },
  end: { x: 0, y: 0, z: 92 },
  color: 'cyan',
  duration: 8,
  thickness: 3
});

await world.clearDebugVisuals();