unreal-packaging
Packages and ships Unreal Engine 5 (UE 5.8) projects: Shipping builds, cooking, pak/IoStore and RunUAT BuildCookRun with UAT and cook log reading. Use for a packaged game with a black screen, a map missing in the build, "BUILD FAILED" or an AutomationTool exit code.
Install / Use
npx skills add gamedev-skills/awesome-gamedev-agent-skills --skill unreal-packagingInstalls into whichever agent you are using.
SKILL.md
Installable skill definition
Quality Score
Category
AutomationSupported Platforms
Tags
Our assessment of unreal-packaging
unreal-packaging scores 91/100 on our quality scale, 941st of 2,780 Automation skills we index (top 34%).
Its SKILL.md is 4.9 KB long, well organised into 11 sections with 3 code examples: a solid amount of guidance for an agent.
With 8,904 GitHub stars, it is one of the more widely adopted skills in the catalogue.
Maintenance, license and trust
- The repository was last updated 4 days ago, so unreal-packaging is actively maintained.
- Our last check on 2026-11-01 found the source still online.
- It is released under the Apache-2.0 license, a permissive license that allows use, modification and commercial use with attribution.
- Its trust signals score 100/100, with no cautions. These come from repository metadata, not a code audit — read the skill file before letting an agent act on it.
Safety scan
No issues foundOur scan of the whole file found no instruction hijacking, hidden characters, credential access, data exfiltration or destructive commands. An AI review of the same text found nothing harmful.
AI review by kimi-k2.7-code on 2026-10-07. Automated pattern scan on 2026-10-07. It catches known dangerous patterns, not every risk — read a skill before letting an agent act on it.
unreal-packaging compared with similar skills
All 4 of these similar skills score higher than unreal-packaging; compare them before choosing.
| Skill | Score | Stars | Updated | Format |
|---|---|---|---|---|
| unreal-packaging (this skill)by gamedev-skills | 91 | 8.9k | 4d ago | SKILL.md |
| Agent-Reachby Panniantong | 100 | 112.3k | 8d ago | CLAUDE.md |
| rufloby ruvnet | 100 | 81.9k | today | CLAUDE.md |
| Claude-Code-Game-Studiosby Donchitos | 100 | 39.7k | 7d ago | CLAUDE.md |
| Scraplingby D4Vinci | 100 | 103.6k | 2d ago | MCP Server |
Frequently asked questions
- How do I install unreal-packaging?
- Run
npx skills add gamedev-skills/awesome-gamedev-agent-skills --skill unreal-packaging. The install tabs above show the steps for each supported agent. - Which AI agents does unreal-packaging work with?
- It is written for Universal, as a SKILL.md file. Other agents that read the same format can often use it too.
- Is unreal-packaging safe to use?
- Our scan of the whole file found no instruction hijacking, hidden characters, credential access, data exfiltration or destructive commands. An AI review of the same text found nothing harmful. It is Apache-2.0-licensed and scores 100/100 on trust signals. Skills are instructions an agent will follow, so read the file before installing it and do not approve commands you do not understand.
- Is unreal-packaging still maintained?
- The repository was last updated 4 days ago, so unreal-packaging is actively maintained.
Skill content
View source on GitHubname: unreal-packaging description: > Package and ship an Unreal Engine 5 project: the Platforms menu Package Project flow, build configurations (Development vs Shipping), cooking content, packaging settings and the Game Default Map, and command-line builds with RunUAT BuildCookRun. Use when packaging a build, making a shipping build, cooking content, configuring packaging settings, or when the user mentions package Unreal, cook content, shipping build, or BuildCookRun.
Unreal Packaging & Cooking
Turn a UE5 project into a runnable, distributable build: choose the right build configuration, cook content, set the launch map, and package — from the editor or the command line. Targets UE 5.8.
When to use
- Use when producing a build (test or release), choosing Development vs Shipping, cooking
content, configuring Packaging / Maps & Modes settings, or automating builds with
RunUAT BuildCookRunfor CI. - Use when the project has a
*.uprojectandConfig/Default*.ini, and the goal is a packaged player rather than running in-editor.
When not to use: storefront submission/release process → steam-publish / itch-publish.
Editor-time gameplay/iteration is not packaging.
Core workflow
- Set the launch map. Project Settings → Maps & Modes → Game Default Map is what a packaged build loads first. Wrong/empty here is the most common "packaged game is black" cause.
- Pick the build configuration: Development (default; optimized but keeps logging/
stats/console for testing) vs Shipping (all optimizations, debugging tools stripped — for
release).
DebugGame/Debugare for debugging engine/game code and aren't for distribution;DebugGameisn't available for Blueprint-only projects. - Understand cook vs package. Cooking converts assets to the target platform's format
and packs them into
.pakfiles. Packaging bundles the compiled executable + cooked content into a standalone, distributable set of files. Packaging runs a cook as part of it. - Package from the editor: the Platforms menu → choose the platform (e.g. Windows) → set the Binary Configuration → Package Project → pick an output folder.
- Or build from the command line with the Unreal Automation Tool (
RunUAT BuildCookRun) for repeatable/CI builds. - Tune Packaging settings (Project Settings → Packaging): which maps/directories to cook, full-rebuild, compression, and whether to build all maps.
- Verify by running the packaged build, not just by a successful cook — launch the executable and confirm it loads the right map and runs.
Patterns
1. Editor packaging (the menu path)
Platforms (toolbar)
-> Windows
-> Binary Configuration -> Development | Shipping
-> Content Management -> Package Project
-> choose/confirm the staging output folder
2. Command-line build with UAT (CI-friendly)
# Cook + build + stage + pak + archive a Shipping Windows build.
RunUAT BuildCookRun \
-project="C:/Path/MyGame.uproject" \
-noP4 -platform=Win64 -clientconfig=Shipping \
-cook -allmaps -build -stage -pak -archive \
-archivedirectory="C:/Builds/MyGame"
RunUAT lives in Engine/Build/BatchFiles/ (RunUAT.bat on Windows, RunUAT.sh on
macOS/Linux). Drop -allmaps and pass -map=Map1+Map2 to cook a subset.
3. Cook only (no packaging), e.g. to refresh content
RunUAT BuildCookRun -project="C:/Path/MyGame.uproject" -noP4 \
-platform=Win64 -clientconfig=Development -cook -skipstage
Pitfalls
- Packaged build loads a black/empty level — Game Default Map isn't set (or that map wasn't cooked). Set it in Maps & Modes and ensure it's included in the cook.
- Shipping a Development build — Development keeps logging/console/stats and is slower; ship
Shipping. Conversely, Shipping strips
UE_LOG/console, so debugging a Shipping-only issue needs Development orTest. - A referenced map/asset is missing at runtime — it wasn't cooked. Add it to the Packaging settings' maps/directories to cook, or cook all maps.
- Build fails on the platform — the platform SDK/toolchain isn't installed (Windows build tools, Android SDK/NDK, console SDKs). Install the platform's prerequisites.
- Expecting Blueprint Nativization — it was removed in UE5; don't rely on it for
performance. Profile and move hot logic to C++ (
unreal-cpp-gameplay) instead. - First cook is very slow — shaders and all assets cook from scratch; subsequent cooks are incremental. Don't mistake a slow first cook for a hang.
References
- Primary docs: "Packaging Your Project"
(
https://dev.epicgames.com/documentation/en-us/unreal-engine/packaging-your-project) and the Build Configurations /BuildCookRunreferences.
Related skills
steam-publish/itch-publish— distributing the packaged build to a storefront.unreal-cpp-gameplay— moving hot logic to C++ now that BP nativization is gone.
Related Skills
Agent-Reach
112.3kGive your AI agent eyes to see the entire internet. Read & search Twitter, Reddit, YouTube, GitHub, Bilibili, XiaoHongShu — one CLI, zero API fees.
ruflo
81.9k🌊 The original agent harness. Deploy intelligent multi-player swarms, coordinate autonomous workflows, and build conversational AI systems. Features adaptive memory, self-learning intelligence, federation, vector RAG integration, and native Claude Code / Codex / Hermes and many more Integrated
Claude-Code-Game-Studios
39.7kTurn Claude Code into a full game dev studio — 49 AI agents, 72 workflow skills, and a complete coordination system mirroring real studio hierarchy.
Scrapling
103.6k🕷️ The BEST Web Scraping framework that handles everything from a single request to a full-scale crawl! Don't be shy, join here: https://discord.gg/EMgGbDceNQ and follow here for daily tips and tricks: https://x.com/Scrapling_dev
Languages
Trust signals
From repository metadata: license, adoption, age and documentation. Not a code audit — see the Safety scan above for what the skill file itself contains.
