> ## Documentation Index
> Fetch the complete documentation index at: https://hedgeem-api.qeetoto.com/llms.txt
> Use this file to discover all available pages before exploring further.

# F083 — Skill-based Bonus Rounds

> Occasional skill-based bonus games that add variety and incentivise longer play

# F083 — Skill-based Bonus Rounds

| Field  | Value                          |
| ------ | ------------------------------ |
| ID     | F083                           |
| Phase  | 4 — Config, Navigation & Audio |
| Jira   | TBD                            |
| Status | TS ❌ · JS ❌ · UMA ❌            |

## Business Rule

Occasionally during gameplay, the player is offered a **Bonus Round**. Bonus rounds are:

* **Skill-based** — the player's decisions influence the outcome (not pure RNG)
* **Themed on the main game** — use Texas HoldEm mechanics as their foundation
* **Triggered by operator-configured events** — trigger conditions are set at installation (see F032)
* **Variety mechanism** — add gameplay variety and give players an incentive to continue playing

Bonus rounds are **optional** — the operator can disable them at installation.

## Source: Game Concept Document

> "Occasionally, during game play, the player will be offered a 'Bonus-Round' to play; these bonus rounds are based on the main game and are typically skill-based. The bonus games add variety and give the player an incentive to stay at the table for longer."

> "Configurable 'Jackpot' and 'Bonus' round trigger events: Hedge'Em has multiple operator-configurable mechanisms to trigger the 'Jackpot' and 'Bonus' rounds."

> "Know your stuff? - Then earn your rewards in the skill-based Bonus Rounds."

> "It has skill-based bonus rounds based on the main game." (Listed as a unique selling point)

> "have bonus rounds and progressive jackpots" (Listed as a competitive differentiator)

## Design (To Be Specified)

The following design details are **not yet defined** — they require specification by Qeetoto before implementation:

* [ ] What are the available bonus round types?
* [ ] What decisions does the player make during a bonus round?
* [ ] How is "skill" evaluated and rewarded?
* [ ] What is the payout structure for bonus rounds?
* [ ] What are the valid trigger events (e.g. N consecutive losses, specific hand outcome, time-based)?
* [ ] Does a bonus round replace the main game or play out alongside it?
* [ ] Can the player decline a bonus round offer?

## Competitive Significance

The game concept document lists skill-based bonus rounds as both a **key feature** and a **unique selling point** that differentiates HedgeEm from competitors:

> "There are similar games in the market, but none that... have bonus rounds and progressive jackpots"

## Acceptance Criteria

| #   | Criterion                                              | JS | TS | UMA |
| --- | ------------------------------------------------------ | -- | -- | --- |
| AC1 | Bonus round triggered by operator-configured event     | ❌  | ❌  | ❌   |
| AC2 | Player presented with skill-based choices during bonus | ❌  | ❌  | ❌   |
| AC3 | Bonus payout based on player's skill decisions         | ❌  | ❌  | ❌   |
| AC4 | Bonus rounds can be disabled per operator config       | ❌  | ❌  | ❌   |
| AC5 | Main game state preserved during and after bonus round | ❌  | ❌  | ❌   |

## Version Parity

| Version        | Status            | Notes                            |
| -------------- | ----------------- | -------------------------------- |
| JS (reference) | ❌ Not implemented | Not present in current JS client |
| TS             | ❌ Not implemented | Phase 4                          |
| UMA            | ❌ Not implemented | Phase 5                          |

## Related Features

* F032 — RTP Config (bonus round trigger configuration)
* F084 — Progressive Jackpots (often triggered alongside bonus rounds)
* F040 — Menu Screen (bonus round entry point TBD)