Skip to content

ericrisco/rsc-harness / skills/unreal

unreal

Verified

Use when building, scripting or debugging a game in Unreal Engine 5 with Blueprint or C++ — the gameplay framework (Actor, Pawn, Character, GameMode, PlayerController), Actor lifecycle and tick, the reflection macros and garbage collection, Enhanced Input, multicast delegates, UMG widgets, Paper2D, and Blueprint-to-C++ parity in both directions. NOT Godot (that is `godot`), NOT Unity or MonoBehaviour (that is `unity`), NOT language-only C++ memory and RAII questions with no Unreal types (that is `cpp`).

FileKindSize
SKILL.mdskill md15.6 KB
evals/README.mdmarkdown916 B
evals/cases.yamlconfig4.1 KB
references/blueprint-cpp-parity.mdmarkdown5.9 KB
references/gameplay-framework.mdmarkdown4.8 KB
references/packaging.mdmarkdown3.8 KB

references/packaging.md

View on GitHub
# UE5 packaging & build config (overview)

Enough to configure a build correctly. Deep shipping (cook tuning, pak/IoStore, on-disk size,
platform certification, CI/CD, LTO, encryption) belongs to `gamedev-shipping`.

## Build configurations

| Config | Engine code | Game code | Logging | Use for |
| --- | --- | --- | --- | --- |
| `Debug` | debug | debug | full | stepping through engine internals |
| `DebugGame` | optimized | debug | full | debugging **your** game code with fast engine |
| `Development` | optimized | optimized | full | day-to-day iteration in editor & standalone (default) |
| `Test` | optimized | optimized | full-ish | profiling a near-shipping build with stats/console |
| `Shipping` | optimized | optimized | **stripped** | the build you release — no console, `check()` compiled out |

`Development` is what you run while making the game. Package **`Shipping`** for release; verify
it separately because stripped logging/asserts change behavior (never rely on `check()`
side effects — they vanish in Shipping).

## Targets and modules

- **`Source/<Project>.Target.cs`** and **`<Project>Editor.Target.cs`** — one per output kind
  (Game, Editor, and optionally Client/Server for networked titles). They set `Type`,
  `DefaultBuildSettings`, and `IncludeOrderVersion`.
- **`Source/<Module>/<Module>.Build.cs`** — per-module rules. Declare dependencies here; a
  missing module = unresolved-symbol linker errors even though the header compiles.

Starter module rules for a Blueprint+C++ game using Enhanced Input, UMG, and Paper2D:

```csharp
using UnrealBuildTool;

public class MyGame : ModuleRules
{
    public MyGame(ReadOnlyTargetRules Target) : base(Target)
    {
        PCHUsage = PCHUsageMode.UseExplicitOrSharedPCHs;

        PublicDependencyModuleNames.AddRange(new string[] {
            "Core", "CoreUObject", "Engine", "InputCore",
            "EnhancedInput",     // Enhanced Input (required — legacy input is deprecated)
            "UMG", "Slate", "SlateCore",   // UMG UI
            "Paper2D"            // 2D sprites/flipbooks/tilemaps
        });

        // PrivateDependencyModuleNames.AddRange(new string[] { "AIModule", "GameplayTasks" });
    }
}
```

After editing `.Build.cs` or adding C++ classes, **regenerate project files** (right-click the
`.uproject` → *Generate … project files*, or `GenerateProjectFiles`) and rebuild from the IDE.

## Packaging the build

- **Editor**: *Platforms ▸ \<Platform\> ▸ Package Project* (set the config in
  *Packaging* settings). Choose the maps to cook and the `Shipping` config for release.
- **Command line** (CI-friendly): Unreal Automation Tool runs cook → stage → package in one go:

```bash
RunUAT BuildCookRun \
  -project="/path/MyGame.uproject" \
  -noP4 -platform=Win64 -clientconfig=Shipping \
  -cook -allmaps -build -stage -pak -archive \
  -archivedirectory="/path/Builds"
```

## Config files

Per-project defaults live in `Config/`: `DefaultEngine.ini`, `DefaultGame.ini` (project
name/version, maps), `DefaultInput.ini`, and platform overrides like `Windows/WindowsEngine.ini`,
`Android/AndroidEngine.ini`. Packaging options (maps to cook, build config, compression,
Blueprint nativization off in UE5) are under *Project Settings ▸ Packaging*, persisted to these
`.ini` files — commit them so builds are reproducible.

## Common failure modes

- **"Module could not be loaded"** at launch → the module isn't in `.Build.cs`'s dependency list,
  or it's an editor-only module referenced by a runtime build.
- **Cooks fine, crashes packaged only** → usually a hard reference to an editor-only asset, or
  code depending on a `check()`/`ensure()` side effect that Shipping stripped.
- **Asset not in the build** → not reachable from a cooked map or an asset directory; add it to
  *Packaging ▸ Additional Asset Directories to Cook*.
add-product-e2e-evalpaperclipai/paperclipAdd or extend a Paperclip full-stack runner E2E workflow, fixture, matcher, or report evidence path for local or Daytona execution.Stars: 115kUpdated Claude CodeCodexVerifiedInstall
add-runner-evalpaperclipai/paperclipAdd or extend a Paperclip Runner protocol evaluation definition, roster, assertion, or report fixture with provenance and narrow validation.Stars: 115kUpdated Claude CodeCodexVerifiedInstall
diagnose-why-work-stoppedpaperclipai/paperclipCompatibility entry point for failed, stalled, looping, or over-recovered Paperclip work. Use fix-failed-paperclip-run for the full diagnosis, regression, repair, real verification, and green-PR workflow; honor an explicitly requested diagnosis-only scope.Stars: 115kUpdated Claude CodeCodexVerifiedInstall
fix-failed-paperclip-runpaperclipai/paperclipDiagnose and fix failed, stuck, slow, or incorrectly blocked Paperclip tasks and runs. Use with a task/run URL or failure report to trace the root cause, prove a regression red then green, check second-order effects, verify the real workflow, and deliver a PR with passing checks.Stars: 115kUpdated Claude CodeCodexVerifiedInstall