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

  1. Getting started
  2. Core concepts
  3. Skills and skill trees
  4. Skill tree editor
  5. Conditions, costs, rewards and grants
  6. Skill component
  7. Progression (experience and levels)
  8. Multiplayer
  9. Save and load
  10. MVVM and UI
  11. UI widgets
  12. Settings
  13. Console
  14. 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:

  1. Create Skill assets (Add > Pulse > Skill > Skill). Give each a unique SkillTag, at least one rank with its conditions, costs and rewards, and grants.
  2. Create a Skill Tree asset and open it: the graph editor lets you place the skills and connect them to set their prerequisites.
  3. Add a UPulseSkillComponent to your player state (or any actor) and add the tree to SkillTrees.
  4. Give skill points with StartingSkillPoints, AddSkillPoints, or let them come from levels: add a progression (experience, level curve, level rewards) and call AddExperience.
  5. Call TryUnlockSkill(SkillTag) from your UI. The server checks everything, pays the costs, gives the rewards and applies the grants.
  6. Show the trees with the ready-made widgets (UPulseSkillMenuWidget), bind your own UI to UMVVMPulseSkillComponent, or listen to OnSkillRankChanged / OnSkillStateChanged.
  7. 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).

This site uses Just the Docs, a documentation theme for Jekyll.