> ## 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.

# F084 — Multi-level Progressive Jackpots

> Small, medium, and large jackpots that accumulate and pay on operator-configured trigger events

# F084 — Multi-level Progressive Jackpots

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

## Business Rule

When enabled by the operator, three tiers of progressive jackpot accumulate throughout gameplay:

| Tier           | Size       | Trigger frequency |
| -------------- | ---------- | ----------------- |
| Small jackpot  | Low value  | More frequent     |
| Medium jackpot | Mid value  | Moderate          |
| Large jackpot  | High value | Rare              |

Each jackpot accumulates (grows) as players bet. When a configured trigger event occurs, the appropriate jackpot tier is paid to the player. After payment the jackpot resets to a base value and begins accumulating again.

Jackpots are **optional** — the operator enables and configures them at installation. When disabled, gameplay is unaffected.

## Source: Game Concept Document

> "If enabled by the operator during installation, small, medium, and large progressive jackpots accumulate throughout the game. These jackpots are then paid to the player when defined trigger-events occur. The Jackpots add volatility to the game 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."

> "have bonus rounds and progressive jackpots" (Competitive differentiator)

## Design (To Be Specified)

The following design details are **not yet defined**:

* [ ] What are the valid jackpot trigger events?
* [ ] How does jackpot accumulation relate to bet amounts (contribution rate)?
* [ ] Are jackpots local (per terminal) or pooled (network-wide)?
* [ ] What is the base/seed value for each jackpot tier after reset?
* [ ] Is there a jackpot display/meter visible during normal gameplay?
* [ ] Does winning a jackpot affect the session's RTP accounting?
* [ ] Regulatory requirements for jackpot accounting and audit trail

## Competitive Significance

Progressive jackpots are listed as a **key feature** differentiating HedgeEm from similar products:

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

The jackpots are described as adding **volatility** — a deliberate design choice to appeal to players who enjoy high-variance outcomes alongside the game's core probability-based betting.

## Acceptance Criteria

| #   | Criterion                                             | JS | TS | UMA |
| --- | ----------------------------------------------------- | -- | -- | --- |
| AC1 | Three jackpot tiers (small, medium, large) configured | ❌  | ❌  | ❌   |
| AC2 | Jackpots accumulate as bets are placed                | ❌  | ❌  | ❌   |
| AC3 | Jackpot paid on operator-configured trigger event     | ❌  | ❌  | ❌   |
| AC4 | Jackpot resets to base value after payout             | ❌  | ❌  | ❌   |
| AC5 | Jackpots can be disabled per operator config          | ❌  | ❌  | ❌   |
| AC6 | Jackpot values visible to player during gameplay      | ❌  | ❌  | ❌   |

## 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 (jackpot trigger and accumulation configuration)
* F083 — Skill-based Bonus Rounds (may share trigger mechanism)
