StateGate is a C++ quality-assurance plugin for Unreal Engine StateTree workflows.

Audit StateTree assets across your project, record explicit runtime state coverage, validate required states and transitions, detect excessive state duration, export reports, and enforce quality rules in automated CI pipelines.

KEY FEATURES

• PROJECT-WIDE STATETREE AUDIT

- Scan StateTree assets under configurable project paths

- Detect missing editor data

- Detect StateTrees with no states

- Detect duplicate state names and IDs

- Detect disabled states

- Detect empty leaf states with no tasks, transitions, or child states

• EXPLICIT RUNTIME COVERAGE

- Includes a StateGate Coverage Marker StateTree task

- Record state entry and exit

- Measure maximum observed state duration

- Infer transitions between sequential state markers

- Separate concurrent StateTree instances with unique Instance Keys

- Export deterministic coverage data as JSON

• STATE AND TRANSITION COVERAGE

- Identify states that were not executed during testing

- Calculate state coverage percentage

- Calculate observed transition coverage

- Configure project-wide minimum coverage thresholds

- Detect states that remain active longer than the configured limit

• REGRESSION CONTRACTS

- Create StateGate Suite Data Assets

- Define required states for important scenarios

- Define required transitions

- Validate coverage files against expected behavior

- Detect previously working behavior that is no longer executed

• REPORTING

- Export CSV reports

- Export structured JSON reports

- Generate standalone HTML reports

- Review severity, category, rule, asset, state, message, and suggested action

• CI AND AUTOMATION

- Includes the StateGateAudit commandlet

- Run StateTree audits without opening the editor

- Load coverage files and StateGate Suite contracts

- Configure CI failure policies

- Use process exit codes as automated quality gates

- Includes an Automation Test for the coverage JSON schema

• EDITOR WORKFLOW

- Slate-based StateGate dashboard

- Choose or clear coverage files

- Configure rules through Project Settings

- Review Errors, Warnings, and Information results

- Export reports directly from the dashboard

IMPORTANT WORKFLOW INFORMATION

StateGate uses explicit coverage instrumentation. Add a StateGate Coverage Marker task to each StateTree state that should be measured.

Each marker uses:

- Suite Key: identifies the logical test suite

- Instance Key: separates concurrently running StateTree instances

- State Key: provides a stable state identifier for coverage and contracts

StateGate does not automatically play the game or generate AI behavior.

STATETREE DEBUGGER COMPATIBILITY

StateGate complements the built-in Unreal Engine StateTree Debugger.

The built-in debugger is intended for live execution and trace inspection. StateGate focuses on repeatable coverage records, regression contracts, reports, and automated CI pass/fail decisions.

TECHNICAL DETAILS

• Unreal Engine 5.8

• Windows development platform

• C++ code plugin

• Runtime coverage module and editor tooling module

• No third-party libraries

• No external services or accounts

• CSV, JSON, and HTML reports

• English and Korean documentation included

GETTING STARTED

1. Enable StateTree and StateGate.

2. Open Tools > StateGate.

3. Run Scan StateTrees for structural checks.

4. Add StateGate Coverage Marker tasks to important states.

5. Exercise the StateTree in PIE or an automated test.

6. Export the coverage JSON.

7. Load the coverage file in StateGate and scan again.

8. Export reports or run StateGateAudit in CI.