unreal-testing-sops

Executes standard operating procedures for testing game functionality in Unreal Engine.

Updated May 29, 2026
One-click install
npx skills add https://github.com/JanVogelsang/UE-AgentFramework --skill unreal-testing-sops-janvogelsang
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: unreal-testing-sops
Source: https://github.com/JanVogelsang/UE-AgentFramework/tree/main/UnrealEngine/skills/unreal-testing-sops
Command: npx skills add https://github.com/JanVogelsang/UE-AgentFramework --skill unreal-testing-sops-janvogelsang

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Testing Unreal Engine gameplay flows through an AI agent often wastes tokens on viewport screenshots, blind retries, and full log reads, while flaky PIE sessions and race conditions produce unreliable results. This Skill provides token-efficient Standard Operating Procedures for running repeatable in-editor game tests. ## Core Features & Use Cases - Gameplay Flow SOPs: Step-by-step procedures for PvP matchmaking, singleplayer progression, and end-to-end combat simulation using PIE sessions, simulated input, and console commands. - Performance Benchmarking: Runs automation tests with configurable entity counts, then parses results via a Python script into a JSON bottleneck report covering game thread, render thread, and GPU timings. - Stability Guardrails: Enforces run isolation with the -Nomessaging flag, loading-screen race condition checks, and defensive null-safety patterns to prevent access violation crashes. - Use Case: Ask the agent to verify the PvP matchmaking flow; it starts a PIE session, triggers debug console commands like TauDebugGoToPvP and TauDebugStartRound, and confirms the round starts by reading the message log. ## Quick Start Test the PvP matchmaking flow in the open Unreal Editor session and verify the combat round starts successfully.

Frequently Asked Questions about unreal-testing-sops

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I test Unreal Engine gameplay with an AI agent?▼

Start a PIE session, then navigate UI using simulated keyboard or gamepad input, or trigger debug console commands to jump directly to target screens. Verify results by reading the message log rather than capturing viewport images, which keeps token usage low.

How to run automated performance benchmarks in Unreal Engine?▼

Configure entity count and duration via CVars like Tau.Test.BenchmarkEntities, then run the Tau.Performance.Benchmark automation test. Parse the output with a Python script to generate a JSON report identifying the primary bottleneck across game thread, render thread, and GPU.

Why do Unreal automation tests deadlock when multiple editors run?▼

Unreal's automation system uses UDP messaging to discover peer test workers, causing port conflicts and deadlocks in latent commands when multiple instances run concurrently. Always add the -Nomessaging flag to command-line test invocations to isolate each run.

Why do widget checks fail after loading a map in Unreal?▼

Map transitions are asynchronous, so widget queries can match stale instances before teardown and garbage collection complete. Verify the loading screen subsystem reports the loading screen fully closed before accepting any widget references.

Should I use viewport captures to verify Unreal UI tests?▼

Avoid viewport captures unless verifying visual output, since multimodal image analysis consumes significant tokens. Prefer keystroke simulation, direct input action bindings, console commands, or programmatic widget delegate invocation for navigation and verification.