Roo Gameplay Framework
Data-driven gameplay systems for Unreal Engine 5
Roo Gameplay Framework is a modular C++ and Blueprint framework for building data-driven gameplay systems in Unreal Engine 5. It provides a shared foundation for stats, attributes, formulas, progression, stat actions, status effects, inventory, equipment, runtime UI, and editor workflows.
Learn How to Build a Complete RPG Game
Follow the complete YouTube tutorial series to create a full RPG game with Unreal Engine 5.7 and RooGameplayFramework.
Start Learning How to Build a Complete RPG Game
Verified Engine Versions
The initial release has been built and validated on Unreal Engine 5.5, 5.6, 5.7, and 5.8 for Win64. Use the plugin package that matches your project's engine version.
The framework is designed so gameplay designers can configure most content with Gameplay Tags and Data Assets, while programmers retain clear C++ and Blueprint APIs for runtime integration.

Start Here
Installation and Setup
Quick Start
Demo Overview
Blueprint Reference
Troubleshooting and Limitations
Documentation
Included Systems
Stats with base values, formulas, progression tables, and runtime modifiers
Attributes with current, minimum, maximum, and normalized values
Gameplay Tag based lookup and organization
Reusable stat actions for damage, healing, resource changes, and other operations
Status effects with duration, periodic execution, stacking, refresh, and display queries
Inventory storage, movement, equipment, modifiers, and Blueprint-ready events
Base UMG widgets for inventory and equipment interfaces
Stats Designer, Setup panel, factories, thumbnails, and custom asset editors
A Blueprint-focused demo that demonstrates the systems working together
Design Philosophy
The framework separates authored configuration from runtime state. Data Assets describe what a stat, item, formula, action, or status effect should do. Components own the live values for each actor. Gameplay Tags provide stable identities across assets, Blueprints, UI, and C++.
This keeps gameplay content reusable and avoids coupling a system to a particular character class or interface.
AI-Friendly
Whenever you want to create a new feature or learn how an existing system works, you can provide the AI with a link to the relevant documentation page. This allows the AI to quickly understand the framework’s structure, APIs, and recommended workflows, and then guide you through the implementation process.
For example, you can ask an AI tool to help you with:
Creating and configuring Buffs
Implementing attack damage calculations
Implementing critical hit calculations
Setting up equipment and item attributes
Connecting Stats, Buffs, Inventory, and Equipment systems
Troubleshooting Blueprint logic or configuration issues
For better results, include the relevant documentation link in your prompt and clearly describe what you want to build.
Example prompt:
I am using Roo Gameplay Framework. Please read the following documentation and help me create a Buff that increases Attack Power by 20% for 10 seconds: [Documentation URL]
By providing the documentation, the AI can understand the framework more accurately and generate instructions that are consistent with its actual design.
Last updated