Skill integration (PulseBuildSkillBridge)

The bridge PulseBuildSkillBridge lets the skill ranks of Pulse Skill unlock building pieces. Enable PulseBuild, PulseSkill and PulseBuildSkillBridge; it needs no setup.

Unlocking pieces with a skill

  1. Open a skill (UPulseSkillDefinition) and add the grant Unlock Build Pieces to a rank (the pieces unlock from that rank on) or to the Grants of the skill (from rank 1 on).
  2. Put pieces into Pieces, or catalogs into Catalogs.
  3. Unlock the rank: the pieces appear in the build menu. A refund or a reset takes them away again, loading the skills brings them back.
Grant property Meaning
Pieces Pieces the player may build
Catalogs Catalogs whose pieces the player may build

A piece can be buildable for several reasons at once: a catalog of the build component, a skill, a build kit. Keep bRequireCatalog on, so locked pieces stay locked.

How it works

  • At startup the bridge registers the piece source Skills (FPulseBuildPieceSource_Skills) for every builder (Pulse::Build::Registry); the build settings stay as they are. Switch that off in Project Settings > Pulse > Build > Skill (bAddSkillPieceSource, applies at once) and add the source yourself, to the build settings or to single build components.
  • The source reads the unlocked ranks from the skill component of the builder’s player (found on any actor of the player) and collects the pieces of every Unlock Build Pieces grant up to those ranks. The build menu (GetAvailablePieces) and the checks on client and server (CanBuildPiece) use it.
  • When a rank changes (unlock, refund, reset, load, on clients after replication), the bridge calls NotifyAvailablePiecesChanged on the build component of the player on the next tick, so an open build menu updates.
  • The grant only holds data. Pulse Skill applies grants to the ability system of the player, but the source does not need one: pieces unlock in projects without ability system too.

Multiplayer

Ranks replicate to the owning client, whose build menu shows the unlocked pieces. The server checks every placement with the same source, so a client cannot build a locked piece.


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