Home

PGX Framework — Professional Game Extensions for Unreal Engine 5

v0.4.0 | UE 5.6.1 | Apache-2.0 | 33 plugin descriptors | 13 production-ready systems

Status: Early Development (0.x). PGX is open source and functional, but APIs may change between releases until the first stable (1.0) version.

---

What Is PGX?

PGX (Professional Game Extensions) is a modular C++ framework for Unreal Engine 5 that provides a complete, production-ready architectural layer between raw UE5 and your game code.

PGX is not a game template. It is middleware — a systematic collection of interconnected subsystems, each wrapping the corresponding UE5 facility with a clean, documented, observable facade. You bring the game design; PGX provides the engineering foundation.

Every UE5 project faces the same architectural challenges: save systems with versioning and migration, audio management with mix layers and ducking, loading screens that survive level transitions, game state machines with validation rules, pipeline state object warm-up to eliminate shader hitches, platform profile management, garbage collection observability. Teams rebuild these from scratch every project, spending months on infrastructure before writing a single line of gameplay code.

PGX solves this by providing battle-tested implementations of these common systems — all following the same patterns, all configurable through Data Assets, all with editor tooling built in.

---

Who Is PGX For?

Audience	Value
Solo developers	Get the architecture of a 20-person studio from day one
Small teams	Shared foundation — same patterns, same conventions, same tools
Studios	Reusable investment that carries across every project
Educators	Complete reference implementation of professional UE5 architecture

---

Quick Navigation

Architecture

• Architecture Overview — Three-layer model, star topology, the numbers
• Data-Driven Design — Config DAs, Object DAs, "the box and the shapes"
• Plugin Topology — Star topology diagram, dependency rules
• Initialization Pipeline — Deterministic boot sequence
• Cross-Plugin Communication — Three-bus model
• Blueprint API Design — Uniform categories, progressive disclosure
• Editor Integration — 25 panels, toolbar, Content Browser

Systems

Each of PGX's 13 production-ready systems follows the same proven architecture with a consistent set of deliverables:

System	Version	Focus
Profile	v2.0	Platform-aware budgets enforced across 11 subsystems
Log	v3.0	Polymorphic observability with 13 domain renderers
Save	v1.0	Context/domain/slot hierarchy with async I/O and migration chains
GameFlow	v1.0	8-channel GameplayTag-driven state machine
PSO	v2.0	Shader precompilation pipeline eliminating first-load hitches
LevelFlow	v1.0	6-state deterministic level transition pipeline
Loading	v1.0	Persistent loading overlays with PSO coordination
MGOS	v1.0	Garbage collection observability with behavioral classification
Audio	v1.1	Dual-backend audio with 5-layer mix model
Data Registry	v2.0	DataTable-first asset registry with O(1) lookups
Construction	v1.3	8 Data Asset types for data-driven actor construction
Message	v1.0	Typed pub/sub bus with tag channels
Event Handler	v1.0	Data-driven behavior resolution with telemetry

Tooling

• Overview — 5 tool plugins
• Editor Tools — Visual Construction System, NomadTabs, Hub
• Simulation Harness — 13-system injection with ~160 API calls
• Project Scaffold — Template-based project setup
• Documentation Viewer — Native Slate Markdown renderer
• Version Control — Git workflow integration

Engineering

• Quality Assurance — 957 static analysis warnings fixed, 13 audit rules
• Visual Construction — Design token system with 11 atomic widgets
• GameplayTag Architecture — 180+ tags with branch ownership
• L1 Integration — 10 base classes wired to 13 subsystems
• Platform-Aware Budgets — Cross-subsystem enforcement

Reference

• Glossary — Key terms and concepts
• Statistics — Hard numbers from the codebase
• FAQ — Common questions and comparisons
• License & Distribution — Apache-2.0, open source

---

The Numbers

Metric	Value
Total plugins	33 (13 production-ready + 19 early-stage)
Tracked source/build files	1,390
Production-ready systems	13
Data Asset types	58
Editor panels (NomadTabs)	25
Console commands	95+
Blueprint nodes	170+
GameplayTags	180+
Test functions	95+
Custom SVG icons	28
Monorepo Markdown files	547
Static analysis warnings fixed	957

File counts were verified on 2026-07-13 against release-candidate commit 098eda4a; see Statistics for the evidence boundary.

---

Design Philosophy

PGX follows five core principles:

1. UE5-First — Never reinvent what Epic provides. Every system wraps and extends the corresponding UE5 facility.
2. Data-Driven — All configuration through Data Assets. No hardcoded values. No recompilation needed for tuning.
3. Zero-Knowledge Usable — Create an asset, fill properties, have a working system. Documentation is a bonus, not a requirement.
4. Observable — Every system has console commands, editor panels, and traceability. Debug anything at runtime without code changes.
5. Decoupled — Systems communicate through message buses, not direct references. Remove any plugin without affecting others.

---

PGX Framework is developed by Platano Games and released as open source under the Apache License 2.0. See License & Distribution.