unreal-best-practices
Comprehensive best practices guide for modern Unreal Engine 5.x development. Covers Epic's strategic direction toward modern systems (GAS, Enhanced Input, StateTree, MetaSounds, Niagara, PCG, CommonUI, World Partition, Game Feature Plugins, Gameplay Tags), the "research first" philosophy of always checking for newer UE systems before implementing, C++ vs Blueprint decision making, data-driven design, asset management, project organization, naming conventions, performance optimization, and debugging with Unreal Insights. Use when the user asks about UE best practices, modern UE5 workflows, which system to use, old vs new UE systems, recommended approaches, project setup, code organization, performance tips, Blueprint vs C++ decisions, naming conventions, or when starting a new feature and needing guidance on the right UE system to use. Also triggers when the user asks whether there is a newer/better way to do something in Unreal Engine, or when comparing legacy systems against modern re
maystudios · 已有静态检查记录
安装与使用
运行命令前先阅读来源与依赖说明。复制命令不会自动安装或执行。
npx skills add maystudios/claude-skills --skill unreal-best-practices技能说明
name: unreal-best-practices description: > Comprehensive best practices guide for modern Unreal Engine 5.x development. Covers Epic's strategic direction toward modern systems (GAS, Enhanced Input, StateTree, MetaSounds, Niagara, PCG, CommonUI, World Partition, Game Feature Plugins, Gameplay Tags), the "research first" philosophy of always checking for newer UE systems before implementing, C++ vs Blueprint decision making, data-driven design, asset management, project organization, naming conventions, performance optimization, and debugging with Unreal Insights. Use when the user asks about UE best practices, modern UE5 workflows, which system to use, old vs new UE systems, recommended approaches, project setup, code organization, performance tips, Blueprint vs C++ decisions, naming conventions, or when starting a new feature and needing guidance on the right UE system to use. Also triggers when the user asks whether there is a newer/better way to do something in Unreal Engine, or when comparing legacy systems against modern replacements. Covers deprecated systems and their migration paths.
Unreal Engine 5.x Best Practices Guide
The "Research First" Principle
Before implementing any gameplay system, always investigate whether Epic provides a newer, purpose-built system for it. Epic Games continuously introduces modern frameworks that replace ad-hoc solutions. Using the latest recommended system yields better performance, easier networking, designer-friendly workflows, and future compatibility.
Workflow:
- Identify the problem domain (input, abilities, audio, particles, AI, UI, movement, etc.)
- Check the Modern Systems Quick Reference below
- If uncertain, search Epic's documentation and the UE Public Roadmap for the latest system status
- Prefer production-ready modern systems over legacy approaches
- For experimental systems: evaluate maturity before committing -- use them in prototypes, not shipping builds
Why this matters: Epic signals their direction through actions, not just announcements. When they rebuild the First/Third Person templates to use GAS and Enhanced Input, or when Fortnite ships with Game Feature Plugins and CommonUI, that is the clearest indicator of where the ecosystem is heading.
Official Documentation (always consult for latest details)
| Source | URL |
|---|---|
| Epic Documentation Hub | https://dev.epicgames.com/documentation/en-us/unreal-engine |
| UE Public Roadmap | https://portal.productboard.com/epicgames/1-unreal-engine-public-roadmap |
| Lyra Sample Project | https://dev.epicgames.com/documentation/en-us/unreal-engine/lyra-sample-game-in-unreal-engine |
| UE Release Notes | https://dev.epicgames.com/documentation/en-us/unreal-engine/unreal-engine-release-notes |
| Epic Community Tutorials | https://dev.epicgames.com/community/learning |
| Experimental Features List | https://dev.epicgames.com/documentation/en-us/unreal-engine/experimental-features |
| Allar's UE5 Style Guide | https://github.com/Allar/ue5-style-guide |
| Tom Looman's UE5 Guides | https://tomlooman.com |
| X157 Dev Notes (Lyra) | https://x157.github.io/UE5/ |
The Lyra Starter Game is Epic's canonical reference implementation for modern UE5 architecture. It demonstrates GAS, Enhanced Input, Game Feature Plugins, CommonUI, GameplayMessageSubsystem, Gameplay Tags, and modular gameplay patterns -- all derived from Fortnite's production codebase.
Modern Systems Quick Reference
See references/modern-systems.md for detailed information on each system, migration paths, and documentation links.
System status as of UE 5.7:
| Domain | Legacy/Old System | Modern System | Status |
|---|---|---|---|
| Input | BindAction/BindAxis | Enhanced Input | Production -- legacy deprecated since 5.1 |
| Abilities | Ad-hoc booleans/timers | Gameplay Ability System (GAS) | Production -- recommended for ability-driven games |
| State/Classification | Enums, booleans, strings | Gameplay Tags | Production -- foundation of modern UE |
| AI Behavior | Behavior Trees | StateTree | Production since 5.1 -- alternative, BTs still supported |
| AI Interaction | Manual scripting | Smart Objects | Production since 5.1 |
| Particles/VFX | Cascade | Niagara | Production -- Cascade deprecated since 5.0 |
| Audio | SoundCue | MetaSounds | Production (core) -- SoundCue not yet deprecated |
| Audio Mixing | Static config | Audio Modulation | Production |
| Rendering (Geometry) | Manual LODs | Nanite | Production since 5.0 |
| Rendering (Lighting) | Baked lightmaps | Lumen | Production since 5.0 |
| Level Streaming | World Composition / Level Streaming | World Partition | Production -- World Composition deprecated |
| UI (Multiplatform) | Raw UMG | CommonUI + UMG | Beta (used in Fortnite) |
| Movement | CharacterMovementComponent | Mover 2.0 | Experimental -- CMC still recommended |
| Procedural Content | Manual/Blueprint scripting | PCG Framework | Production since 5.7 |
| Architecture | Monolithic modules | Game Feature Plugins | Production (Lyra/Fortnite) |
| Messaging | Direct delegates/casting | GameplayMessageSubsystem | Production (Lyra) |
| Animation (Locomotion) | State machines/blend trees | Motion Matching (PoseSearch) | Experimental |
| Animation (Interaction) | Manual montage sync | Motion Warping | Production-usable |
| Animation (Rigging) | External DCC only | Control Rig | Production (core) |
| Asset Selection | Hardcoded switch/if chains | Chooser Tables | Beta since 5.4 |
| Networking (Large-scale) | Default replication | Iris | Beta since 5.7 |
| Dialogue | Third-party plugins | CommonConversation | Experimental (not r |