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.
| Property | Default | Range | What it does |
|---|---|---|---|
Gauge Speed | 0.8 | 0.1 to 5.0 | Rotation speed in full rotations per second. |
Max Full Rotations | 1 | -1 or more | How 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 Rotation | false | on / off | Speed the gauge up after each completed lap. Only applies when Max Full Rotations is greater than 1. |
Speed Up Multiplier | 1.2 | 1.0 to 3.0 | Speed multiplier compounded per completed lap: speed = Gauge Speed * (multiplier ^ completed laps). Needs Speed Up After Rotation. |
Gauge Direction | Always Clockwise | enum | Direction the gauge sweeps: Always Clockwise, Always Counter-Clockwise, Alternating (flips each check), or Random. |
| Property | Default | Range | What it does |
|---|---|---|---|
Good Zone Size | 0.15 | 0.01 to 0.5 | Width of the good (normal success) zone as a fraction of the dial. |
Great Zone Size | 0.035 | 0.005 to 0.25 | Width of the great (perfect) zone. It sits inside the good zone, at a random offset. |
Gauge Start Distance | 0.2 | 0.05 to 0.5 | How far before the zone the gauge starts, giving the player reaction time. |
Gauge Start Distance Variance | 0.4 | 0.0 to 0.5 | Random extra lead-in added on top of Gauge Start Distance, so the run-up varies. Final distance = Gauge Start Distance + Random(0, variance). |
Position
Section titled “Position”| Property | Default | What it does |
|---|---|---|
Position Mode | Fixed Position | Fixed 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. |
| Property | Default | Range | What it does |
|---|---|---|---|
Skill Check Sound | none | - | A warning sound played before the gauge appears. |
Skill Check Sound Delay | 0.4 | 0.0 to 2.0 | Seconds between the warning sound and the gauge appearing, so the player gets an audio “get ready”. |
Good Success Sound | none | - | Plays on a good hit. |
Great Success Sound | none | - | Plays on a great hit. |
Failure Sound | none | - | Plays on a miss (wrong spot or timeout). |