FWSkillSystem Plugin¶
Version: 1.0 | Module: FWSkillSystem | Type: Runtime
A skill progression plugin for Unreal Engine 5 that provides 15 distinct skills across three categories, configurable XP curves, milestone rewards, combat XP distribution, and a skill requirement system for gating content behind skill levels.
The 15 Skills¶
FWSkillSystem ships with 15 skills organized into three categories:
Combat¶
Skills that advance through direct combat encounters.
| Skill | Description |
|---|---|
| Warfare | Melee combat proficiency |
| Marksmanship | Ranged combat proficiency |
| Magic | Magical combat proficiency |
| Bounty | Hunting and bounty contract proficiency |
Gathering¶
Skills that advance through resource collection activities.
| Skill | Description |
|---|---|
| Woodcutting | Harvesting timber from trees |
| Mining | Extracting ore and minerals |
| Fishing | Catching fish and aquatic resources |
| Husbandry | Taming, breeding, and managing animals |
Artisan¶
Skills that advance through crafting and construction activities.
| Skill | Description |
|---|---|
| Cooking | Preparing food and consumables |
| Woodworking | Crafting wooden items and furniture |
| Crafting | General-purpose item creation |
| Smithing | Forging metal weapons and armor |
| Alchemy | Brewing potions and transmuting materials |
| Construction | Building structures and fortifications |
| Artifice | Creating enchanted and magical items |
Key Features¶
| Feature | Description |
|---|---|
| XP Curve System | Data-driven XP requirements per level via UFWSkillXPCurve assets |
| Skill Leveling | Track XP, compute levels, and broadcast events on level-up |
| Combat XP Integration | Automatically distribute XP to combat skills from gameplay events |
| Milestone Rewards | Define rewards triggered at specific skill levels |
| Skill-Gated Content | Gate abilities, items, quests, and areas behind skill requirements via UFWSkillRequirement |
| Skill Database | Centralized UFWSkillDatabase asset containing all skill definitions |
| Blueprint Support | All progression, querying, and gating functions exposed to Blueprints |
| Project Settings | Global configuration via UFWSkillSystemSettings in Project Settings |
Dependencies¶
| Dependency | Type | Notes |
|---|---|---|
GameplayAbilities |
Required | Used for skill-gated ability activation and attribute integration |
Required Dependency
Unlike some FrostWeb plugins with optional dependencies, FWSkillSystem requires the Gameplay Ability System module. Your project must have GameplayAbilities enabled before activating this plugin.
Plugin Architecture¶
FWSkillSystem
+-- Components/
| +-- UFWSkillProgressionComponent // Primary XP and leveling API
| +-- UFWSkillMilestoneComponent // Tracks and awards milestone rewards
+-- Data/
| +-- UFWSkillDefinition // Per-skill configuration (PrimaryDataAsset)
| +-- UFWSkillDatabase // Collection of all skill definitions
| +-- UFWSkillXPCurve // XP-per-level curve definition
| +-- UFWSkillMilestoneDefinition // Milestone reward definitions
| +-- UFWSkillMilestoneReward // Individual milestone reward payloads
+-- Requirements/
| +-- UFWSkillRequirement // Base class for skill-gated content checks
+-- Settings/
| +-- UFWSkillSystemSettings // Global project settings
+-- Utils/
| +-- UFWSkillTypeLibrary // Static Blueprint helper functions
+-- Types/
+-- FWSkillTypes.h // Enums, structs, event types
Quick Navigation¶
| Page | Description |
|---|---|
| Installation | Enable the plugin and configure dependencies |
| Quick Start | Get skill progression running in 10 minutes |
| API Reference | Full C++ API for all classes, methods, structs, and enums |
| Blueprints | Blueprint node reference for all exposed functions and events |
| Configuration | Set up SkillDatabase, XP curves, milestones, and project settings |
| Tutorials | Building a Skill Progression UI |
| FAQ | Common questions about XP formulas, max levels, and combat XP |
| Migration Guide | Upgrading between versions |
| Changelog | Version history and release notes |
Compatibility¶
| Engine Version | Status |
|---|---|
| UE 5.4+ | Supported |
| UE 5.3 | Supported |
| UE 5.2 and below | Not tested |
Dedicated Server
Skill XP mutations should only execute on the server or in a server-authoritative context. The UFWSkillProgressionComponent performs authority checks internally when used on replicated actors. Client-side calls to AwardSkillXP and AwardCombatXP are ignored unless the owning actor has authority.