F049 — Win Level System

Field	Value
ID	F049
Phase	3 — UI
Jira	HEDGE-227
Status	TS ✅ · JS ⬜ · UMA ✅

Business Rule

When a player wins, the duration of the win-screen sound (ramp_loop) and the title label shown on the win panel are determined by the win-to-total-bet multiplier. Small wins play a short sound and show “YOU WON”. Large wins play progressively longer sounds and escalate through “BIG WIN”, “SUPER WIN”, “GIGANTIC WIN”, and “EPIC WIN”. The win label and sound duration are determined at river resolution and cannot be changed once set.

Win Level Table

Win / Total Bet	Sound duration	Label
0 – 1×	1 s	YOU WON
1 – 3×	1 s	YOU WON
3 – 5×	1.5 s	YOU WON
5 – 7×	2 s	YOU WON
7 – 12×	2.5 s	YOU WON
12 – 20×	3 s	YOU WON
20 – 50×	4 s	BIG WIN
50 – 100×	6 s	SUPER WIN
100 – 250×	8 s	GIGANTIC WIN
250×+	10 s	EPIC WIN

Coin emission and auto-hide timer both scale to the same collectTime — the win screen stays visible for soundMs + 3 000 ms after the sound ends.

V5 Source References

File	Lines	Purpose
`source/client_source/src/js/GameConfig/fugaGaming/game/collectRule.json`	1–42	Win level table (identical in leander/ and gameIOM/)
`source/client_source/src/js/Engine/modules/wins/totalWinManager.js`	245–266	`getWinLevel()` — lookup by win/totalBet multiplier
`source/client_source/src/js/Engine/modules/framework/UGame.js`	57–59	`U.Game.getWinSummary()` — public wrapper
`source/client_source/src/js/Game/gameTypes/collectPlate.js`	1–11	Uses `collectTime * 1000` as duration; level label via locale key
`source/client_source/src/js/Game/gameTypes/baseGameScene.js`	560–590	`_collectWin()` starts `ramp_loop`; `_onWinCollectEnd()` stops it then plays `ramp_loop_end`
`source/client_source/src/locale/en_GB/locale.json`	`g_you_won`, `g_bigwin_header_level1–4`	Labels: Big Win / Super Win / Gigantic Win / Epic Win

V6 Implementation

Files

File	Location	Purpose
`GameScene.ts`	`hedgeem-v6-client/src/scenes/GameScene.ts`	COLLECT_RULES table, `_getWinLevel()`, `_showWinnerScreen()`

Key Locations in GameScene.ts

Symbol	~Line	Description
`COLLECT_RULES` static array	~1593	10-entry table mirroring `collectRule.json`
`_getWinLevel(winPence, totalBetPence)`	~1609	Iterates table top-down; returns matching rule + `levelIndex` (0–9)
`_winLevelTimers` property	~240	`Phaser.Time.TimerEvent[]` — holds in-flight progressive label timers
`_showWinnerScreen(winAmountPence, totalBetPence)`	~1618	Starts “YOU WON”; schedules `maxCollectLevel` label-step timers + bounce tweens
`_hideWinnerScreen()`	~1672	Destroys all `_winLevelTimers` on early dismiss
`rampLoopSound` class property	~239	Stores `sound.add('ramp_loop')` ref so it can be `.stop()`-ped explicitly
Call site	~942	`_showWinnerScreen(snap.winAmount, snap.totalBet)`

Progressive Label Animation

Mirrors v5 collectPlate._onShowEnd() / _updatePlate() / _bonuce(). The win screen always opens with “YOU WON”, then escalates through the label tiers at evenly-spaced intervals. Formula (matches v5 exactly):

maxCollectLevel = levelIndex - 5   (levels 0–5 stay "YOU WON", no timers)
delay(i) = (i + 1) × soundMs / (maxCollectLevel + 1)

Label step-up sequence per level:

Win level	Labels in order	Transition times
YOU WON (levels 0–5)	YOU WON only	—
BIG WIN (level 6, 4 s)	YOU WON → BIG WIN	2 000 ms
SUPER WIN (level 7, 6 s)	YOU WON → BIG WIN → SUPER WIN	2 000 ms, 4 000 ms
GIGANTIC WIN (level 8, 8 s)	YOU WON → BIG WIN → SUPER WIN → GIGANTIC WIN	2 000 ms, 4 000 ms, 6 000 ms
EPIC WIN (level 9, 10 s)	YOU WON → BIG WIN → SUPER WIN → GIGANTIC WIN → EPIC WIN	2 000 ms, 4 000 ms, 6 000 ms, 8 000 ms

Each step-up fires a bounce tween on the label text: scale 1.0 → 1.3 → 1.0, 150 ms, Back.easeOut — mirrors v5 _bonuce().

Sound Fix (also in this commit)

Prior to this feature, ramp_loop was started via this.sound.play() which returns boolean and discards the sound reference. This meant ramp_loop kept playing after ramp_loop_end fired. Fixed by storing the reference via this.sound.add('ramp_loop').play() and calling .stop() in the delayed callback.

Old behaviour	Fixed behaviour
`_sfx('ramp_loop')` — reference discarded	`this.rampLoopSound = this.sound.add('ramp_loop'); this.rampLoopSound.play()`
`ramp_loop` never stopped	`this.rampLoopSound?.stop()` called before `ramp_loop_end`

Timing (example: 25× win → BIG WIN)

Time	Event
0 ms	`ramp_loop` starts, coin emitter starts, label = “YOU WON”
2 000 ms	Label → “BIG WIN” + bounce tween
4 000 ms	`ramp_loop` stopped; `ramp_loop_end` plays; coin emitter stops
7 000 ms	`_hideWinnerScreen()` — panel hidden

Acceptance Criteria

ID	Criterion
AC-F049-01	A win of 5× total bet plays `ramp_loop` for 2 s and shows “YOU WON” throughout
AC-F049-02	A win of 25× total bet plays `ramp_loop` for 4 s; starts “YOU WON”, transitions to “BIG WIN” at 2 s
AC-F049-03	A win of 60× total bet plays `ramp_loop` for 6 s; YOU WON → BIG WIN at 2 s → SUPER WIN at 4 s
AC-F049-04	A win of 150× total bet plays `ramp_loop` for 8 s; YOU WON → BIG WIN at 2 s → SUPER WIN at 4 s → GIGANTIC WIN at 6 s
AC-F049-05	A win of 300× total bet plays `ramp_loop` for 10 s; YOU WON → BIG WIN at 2 s → SUPER WIN at 4 s → GIGANTIC WIN at 6 s → EPIC WIN at 8 s
AC-F049-06	Each label transition fires a bounce scale tween (1.0 → 1.3 → 1.0, 150 ms)
AC-F049-07	`ramp_loop` always stops cleanly before `ramp_loop_end` plays
AC-F049-08	Auto-hide fires at `soundMs + 3 000 ms` after deal resolution
AC-F049-09	Dismissing the win screen early (next deal) cancels all pending label timers

Version Parity

Version	Status	Notes
JS (v4)	⬜ Not yet audited	`ShowWinner()` pattern — likely fixed 2 s
TypeScript (v6)	✅ Implemented	`COLLECT_RULES` table + `_getWinLevel()`, HEDGE-227
UMA (v5)	✅ Implemented	`collectRule.json` + `TotalWinManager.getWinLevel()`

Overview

Game Engine

Betting

UI

Config

Bonus

V7 Horse Race

Platform

Lobby

F049 — Win Level System (Scaled Sound & Title)

F049 — Win Level System

Business Rule

Win Level Table

V5 Source References

V6 Implementation

Files

Key Locations in GameScene.ts

Progressive Label Animation

Sound Fix (also in this commit)

Timing (example: 25× win → BIG WIN)

Acceptance Criteria

Version Parity

​F049 — Win Level System

​Business Rule

​Win Level Table

​V5 Source References

​V6 Implementation

​Files

​Key Locations in GameScene.ts

​Progressive Label Animation

​Sound Fix (also in this commit)

​Timing (example: 25× win → BIG WIN)

​Acceptance Criteria

​Version Parity

F049 — Win Level System

Business Rule

Win Level Table

V5 Source References

V6 Implementation

Files

Key Locations in GameScene.ts

Progressive Label Animation

Sound Fix (also in this commit)

Timing (example: 25× win → BIG WIN)

Acceptance Criteria

Version Parity