Skip to content
TECHNICALLYARTIST
FAB

Gauge Settings

Every skill check is described by a Gauge Settings struct. The component holds a Default Gauge Settings that is used as the base for each check, and you can override it per check (see Triggering & Flow).

All zone and angle values are normalized 0 to 1, where 1 is one full trip around the dial.

PropertyDefaultRangeWhat it does
Gauge Speed0.80.1 to 5.0Rotation speed in full rotations per second.
Max Full Rotations1-1 or moreHow many full laps the gauge may travel before an unanswered check auto-fails. Set to -1 for an infinite gauge that never times out (it then relies only on Attempt Skill Check).
Speed Up After Rotationfalseon / offSpeed the gauge up after each completed lap. Only applies when Max Full Rotations is greater than 1.
Speed Up Multiplier1.21.0 to 3.0Speed multiplier compounded per completed lap: speed = Gauge Speed * (multiplier ^ completed laps). Needs Speed Up After Rotation.
Gauge DirectionAlways ClockwiseenumDirection the gauge sweeps: Always Clockwise, Always Counter-Clockwise, Alternating (flips each check), or Random.
PropertyDefaultRangeWhat it does
Good Zone Size0.150.01 to 0.5Width of the good (normal success) zone as a fraction of the dial.
Great Zone Size0.0350.005 to 0.25Width of the great (perfect) zone. It sits inside the good zone, at a random offset.
Gauge Start Distance0.20.05 to 0.5How far before the zone the gauge starts, giving the player reaction time.
Gauge Start Distance Variance0.40.0 to 0.5Random extra lead-in added on top of Gauge Start Distance, so the run-up varies. Final distance = Gauge Start Distance + Random(0, variance).
PropertyDefaultWhat it does
Position ModeFixed PositionFixed Position uses the layout baked into the widget (centered by default). Random Position scatters the gauge around the screen each check.
Random Position Margins(0.15, 0.15, 0.15, 0.25)Keep-out margins from the screen edges, normalized: X left, Y top, Z right, W bottom. Used only in Random Position mode.
PropertyDefaultRangeWhat it does
Skill Check Soundnone-A warning sound played before the gauge appears.
Skill Check Sound Delay0.40.0 to 2.0Seconds between the warning sound and the gauge appearing, so the player gets an audio “get ready”.
Good Success Soundnone-Plays on a good hit.
Great Success Soundnone-Plays on a great hit.
Failure Soundnone-Plays on a miss (wrong spot or timeout).