Triggering & Flow

The component runs skill checks inside a solving session. This page covers how a session starts and stops, how checks are triggered, and how to vary an individual check.

The solving session

Begin Solving opens a session; End Solving closes it (removing any visible gauge and clearing the timers). Checks only happen while a session is open, so think of the session as the activity the player is busy with (repairing, lockpicking, casting, and so on).

Automatic vs. manual

Whether checks appear on their own is controlled by Auto Trigger Skill Checks on the component (on by default):

• On: after Begin Solving, the component shows a gauge every Skill Check Interval plus or minus Skill Check Interval Variance seconds (never less than 0.5). After each result it schedules the next, until you call End Solving.
• Off: nothing appears on its own. Call Show Gauge yourself whenever you want a check.

Property	Default	What it does
Auto Trigger Skill Checks	true	Whether checks appear automatically while solving.
Skill Check Interval	3.0	Base seconds between automatic checks (minimum 0.5).
Skill Check Interval Variance	1.5	Random plus or minus applied to the interval.

Functions

Function	What it does
Begin Solving()	Open a session. Starts automatic checks if enabled.
End Solving()	Close the session; remove the gauge and clear timers.
Show Gauge()	Show one check now using Default Gauge Settings.
Show Gauge With Settings(Settings)	Show one check now using a custom settings struct.
Attempt Skill Check()	The player’s input: stop the gauge and score it.

Note

Show Gauge and Show Gauge With Settings do nothing while a gauge is already on screen, and Attempt Skill Check does nothing when no gauge is showing. All three are safe to call without guarding.

Varying individual checks

• One custom check (manual): call Show Gauge With Settings with your own struct. Any sound field you leave empty inherits the component’s default sounds, so you only have to fill in what you want to change.
• Change every following check: edit Default Gauge Settings at runtime (it is Blueprint-writable). Each new check, automatic or manual, copies it as its starting point, so changes apply from the next check onward.

Caution

Next Gauge Settings is the live copy the component prepares for the gauge it is about to show. Show Gauge refreshes it from Default Gauge Settings every time, so writing to Next Gauge Settings directly will be overwritten. Change Default Gauge Settings, or use Show Gauge With Settings, instead.

A typical loop

Begin Solving                  // activity starts; auto checks begin
  ... gauge appears ...
Attempt Skill Check            // player reacts; result is scored, next is scheduled
  ... gauge appears ...
Attempt Skill Check
End Solving                    // activity ends; everything is cleaned up

In manual mode (Auto Trigger Skill Checks off), replace the automatic appearances with your own Show Gauge calls, driven by whatever pacing your gameplay needs.