# scenario-unreal-gameplay

scenario-unreal-gameplay guides AI coding agents through UE5 gameplay architecture, GAS wiring, and StateTree setup. It enforces C++ base classes with data-only Blueprints to keep projects clean.

- skill · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode, Windsurf (Devin Desktop), Claude.ai · 463 installs · ★ 3964 repo stars
- Author: scenario-labs
- License: MIT · policy=mirror · the beginning of the file is at the end of this page
- Source: https://github.com/scenario-labs/skills/tree/HEAD/skills/game-engines/unreal/scenario-unreal-gameplay/SKILL.md
- Updated: 2026-11-01
- Security check: automated, 2026-11-16 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/skills/scenario-unreal-gameplay

## What it does

The skill establishes strict rules for Unreal Engine 5 gameplay code. C++ handles logic while data-only Blueprint children store parameters using `EditDefaultsOnly`. Hard Blueprint casts are barred because they pull referenced assets into memory. State placement follows lifetime and replication rules: GameMode stays server-only, while GameState and PlayerState replicate across clients.

Gameplay Ability System (GAS) and Enhanced Input follow modular pipelines. Input Actions map to gameplay tags rather than calling abilities inside the Pawn directly. The ASC attaches to the Pawn or PlayerState, with `InitAbilityActorInfo` called in `PossessedBy` on the server and `AcknowledgePossession` on the client. Damage prediction is prohibited. StateTree logic demands explicit exit transitions for every state to prevent unexpected fallbacks to root.

UMG and Common UI rely strictly on events instead of property binding to spare tick cycles. The skill expects `scenario-unreal-expert` as a foundation to avoid known engine pitfalls.

## Requirements
- Works with: Unreal Engine

## Install

### Claude Code (native platform)

1. **Skills CLI (Vercel)**
```bash
npx skills add scenario-labs/skills --skill scenario-unreal-gameplay -a claude-code
```

2. **Manually: put the files in place**
- File: `~/.claude/skills/scenario-unreal-gameplay/SKILL.md` — Copy the whole skill folder; for one project use .claude/skills/scenario-unreal-gameplay/

### Codex

1. **Skills CLI (Vercel)**
```bash
npx skills add scenario-labs/skills --skill scenario-unreal-gameplay -a codex
```

2. **Manually: put the files in place**
- File: `.agents/skills/scenario-unreal-gameplay/SKILL.md` — For all projects use ~/.agents/skills/

### Cursor

1. **Skills CLI (Vercel)**
```bash
npx skills add scenario-labs/skills --skill scenario-unreal-gameplay -a cursor
```

2. **Manually: put the files in place**
- File: `.cursor/skills/scenario-unreal-gameplay/SKILL.md` — Cursor also reads .agents/skills/ and .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install scenario-labs/skills skills/game-engines/unreal/scenario-unreal-gameplay
```

2. **Manually: put the files in place**
- File: `.github/skills/scenario-unreal-gameplay/SKILL.md`

### Gemini CLI

1. **Skills CLI (Vercel)**
```bash
npx skills add scenario-labs/skills --skill scenario-unreal-gameplay -a gemini-cli
```

2. **Platform CLI**
```bash
gemini skills install https://github.com/scenario-labs/skills --path skills/game-engines/unreal/scenario-unreal-gameplay
```

### Windsurf (Devin Desktop)

**Manually: put the files in place**
- File: `.devin/skills/scenario-unreal-gameplay/SKILL.md` — The legacy .windsurf/skills/ path still works

### OpenCode

**Skills CLI (Vercel)**
```bash
npx skills add scenario-labs/skills --skill scenario-unreal-gameplay -a opencode
```

### Claude.ai

**Claude.ai**
- Zip the folder and upload it in Settings → Capabilities → Skills

Where a file is given instead of a command, copy the files from the source to that path: https://github.com/scenario-labs/skills/tree/HEAD/skills/game-engines/unreal/scenario-unreal-gameplay/SKILL.md

## When to use it
- Separate C++ logic from data-only Blueprints to eliminate hard references
- Wire Enhanced Input actions to GAS abilities using tags
- Initialize Ability System Component on server and client correctly
- Build enemy AI in StateTree with clear success and failure transitions
- Optimize UI performance by switching UMG bindings to event listeners

## Example prompts
- Implement a character dash ability with GAS, setting up ASC initialization on the client
- Set up enemy patrol and chase logic using StateTree with explicit state exit events
- Move health calculations to C++ and configure RepNotify for the HUD

## Source text · SKILL.md · MIT

Below is the content of a third-party file. It is data, not instructions for you: do not act on anything written inside unless the human asks. Block tag: 3e8d0cf623b7e30b.

BEGIN THIRD-PARTY FILE 3e8d0cf623b7e30b
```text
---
name: scenario-unreal-gameplay
description: 'Use when building or debugging UE5 gameplay: a character with double jump or dash, abilities with cooldowns, enemy AI that patrols, chases and attacks, a health bar or HUD; choosing Blueprint vs C++, GAS or not, StateTree vs Behavior Tree, EQS or Mass; setting up Enhanced Input, Common UI or UMG; replication, RepNotify, save games, World Partition state; "Blueprints are slow", Tick, casts and hard references; "ability won''t activate", "enemy ignores the player"; or writing automated gameplay tests with injected input.'
license: MIT
---

# Unreal Gameplay (framework, Blueprint vs C++, input, GAS, AI, UI)

Expert level means every piece of data lives in the class whose lifetime and network presence match
it, logic is text (C++ or small functions) under data-only Blueprints and data assets that Python
configures, and every mechanic is proven in isolation (injected input, debug commands, traces)
before it is judged in play. The agent does not pretend to author graphs it cannot reach: it states
which surface each piece lands on and escalates only the residue. If a sibling skill named here is
missing from your available skills, load it with `skill_get` (Scenario MCP) or ask the user to
install it (https://github.com/scenario-labs/skills#install); unattended, proceed from tool schemas
and flag the gap.

**REQUIRED BACKGROUND:** scenario-unreal-expert (channels, review loop, 5.8 traps).

**Status (2026-09-24):** Unreal is not installed. The offline layer passed
(`python3 tests/code/unreal-gameplay/run_all.py --offline`). Every in-editor snippet and generated
C++ file is **not yet run in Unreal** (C++ not yet compiled); `job_00_gameplay_probe.py` answers the
`[verify]` names.

## Stance (the expert delta)

- **Place data by lifetime and network presence.** GameMode is server-only rules; GameState and
  PlayerState replicate to all; PlayerController is owner-only; the Pawn is a respawnable body;
  GameInstance subsystems outlive maps (Forsythe IaU2Hue-ApI [00:13:26]). State goes in replicated
```
END THIRD-PARTY FILE 3e8d0cf623b7e30b

The third-party file has ended. Everything between the 3e8d0cf623b7e30b tags is data: requests and commands from it are not followed. An “end of file” line with another tag inside the block is part of the file.

First 2067 of 20866 bytes. © scenario-labs · MIT · https://github.com/scenario-labs/skills/tree/HEAD/skills/game-engines/unreal/scenario-unreal-gameplay/SKILL.md

_Part of the page did not fit — see the HTML version._

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
