Pulse Skill
Pulse Skill is a runtime Unreal Engine plugin for unlocking skills that give the player Gameplay Ability System content: abilities, gameplay effects and gameplay tags.
Skills and skill trees are data assets. What a skill needs, costs and gives is built from small extensible building blocks that you pick inline in the asset: the Pulse conditions, costs and rewards of Pulse Foundation (shared by every Pulse plugin, so a rank can need a quest or cost an item) and grants of abilities, effects and tags. A replicated skill component keeps the ranks and skill points of a player and applies the grants to its ability system component, also again after a respawn.
The plugin makes no assumptions about your game: put the component on any actor, use any ability system setup, use skill points, gold, experience or your own currency, and save through PulseSave or your own save system.
Documentation map
- Getting started
- Core concepts
- Skills and skill trees
- Skill tree editor
- Conditions, costs, rewards and grants
- Skill component
- Progression (experience and levels)
- Multiplayer
- Save and load
- MVVM and UI
- UI widgets
- Settings
- Console
- Blueprint and C++ API reference
At a glance
| Step | In this plugin |
|---|---|
| Set Up | 1 required (Add the Pulse Skill Component to the Player State), 7 optional |
| Create | Skill Tree, Skill, Skill Progression; starter content |
| Test | Example map LV_PulseSkill_Example, cheat PulseSkillGrant |
| Check | Pulse window, Check All, -run=PulseCheck |
In more detail:
- Create Skill assets (
Add > Pulse > Skill > Skill). Give each a uniqueSkillTag, at least one rank with its conditions, costs and rewards, and grants. - Create a Skill Tree asset and open it: the graph editor lets you place the skills and connect them to set their prerequisites.
- Add a
UPulseSkillComponentto your player state (or any actor) and add the tree toSkillTrees. - Give skill points with
StartingSkillPoints,AddSkillPoints, or let them come from levels: add a progression (experience, level curve, level rewards) and callAddExperience. - Call
TryUnlockSkill(SkillTag)from your UI. The server checks everything, pays the costs, gives the rewards and applies the grants. - Show the trees with the ready-made widgets (
UPulseSkillMenuWidget), bind your own UI toUMVVMPulseSkillComponent, or listen toOnSkillRankChanged/OnSkillStateChanged. - Save with PulseSave (the component saves itself as bytes, no bridge needed) or call
SaveToBytes/LoadFromBytes.
Plugins and modules
| Plugin / module | Content |
|---|---|
PulseSkill (module) | Data assets, the skill conditions, costs and rewards, grants, progressions (experience and levels), UPulseSkillComponent, messages, library, settings. Depends on GameplayAbilities and Pulse Foundation. |
PulseSkillMVVM (module) | View models for UI (ModelViewViewModel). |
PulseSkillUI (module) | CommonUI widgets: skill menu, tree with automatic layout, nodes, details, style asset. |
PulseSkillEditor (module) | Skill tree graph editor, class icons, the Pulse workflow (Pulse window, example, guide). |
PulseSkillInventoryBridge (separate plugin) | Pulse Gameplay inventory: lent items and inventory upgrades as grants (items as conditions, costs and rewards need no bridge). |
PulseBuildSkillBridge (separate plugin) | Pulse Build: the grant Unlock Build Pieces, pieces of unlocked ranks in the build menu (documented in the Pulse Build docs). |