bet-selection

name

bet-selection

description

EGM bet level selection using direct CustomBet buttons. Use when selecting bet levels, iterating bet/denom combinations, verifying bet changes, pressing bet buttons, or fixing code that uses BetIncrement/BetDecrement. Covers: GetBetButtonName(index), AvailableStakeCombinationIndices, SelectedStakeCombinationIndex, press-poll-repress retry pattern, index mapping rule, TotalBet diagnostic logging. CRITICAL: bet levels use direct selection buttons NOT increment/decrement. stages: test-implementation, test-validation

Bet Level Selection

When to Use

• Selecting or changing bet levels in any test
• Iterating through bet/denomination combinations
• Verifying bet level changes took effect
• Fixing code that incorrectly uses BetIncrement/BetDecrement
• Writing tests that play games at specific bet levels

CRITICAL RULE: Direct Selection Only

Bet levels are selected using direct selection buttons (CustomBet1, CustomBet2, ..., CustomBetN), NOT increment/decrement buttons.

// CORRECT — direct selection
await buttonsFacade.EmulateButtonPressByNameAsync(
    ButtonNames.BetButtons.GetBetButtonName(index)); // index is 1-based

// WRONG — increment/decrement DO NOT EXIST on ButtonNames.BetButtons
await buttonsFacade.EmulateButtonPressByNameAsync("BetIncrement");  // ❌ WRONG
await buttonsFacade.EmulateButtonPressByNameAsync("BetDecrement");  // ❌ WRONG

BetIncrement/BetDecrement exist only on PhysicalButtonIds.BetButtons (physical hardware IDs), not on ButtonNames.BetButtons (UTP button names). Using them causes CS0117 compilation errors.

Index Mapping Rule

CustomBetN (1-based button) selects the Nth entry in AvailableStakeCombinationIndices. The readback from SelectedStakeCombinationIndex equals AvailableStakeCombinationIndices[N-1], not N-1 itself.

Example: If AvailableStakeCombinationIndices is [0, 2, 5, 8]:

• Pressing CustomBet3 sets SelectedStakeCombinationIndex to 5
• Pressing CustomBet1 sets SelectedStakeCombinationIndex to 0

Compute the expected index before pressing:

var indices = await mptStatusProvider.GetAvailableStakeCombinationIndicesAsync();
var expectedIndex = indices[betButtonIndex - 1]!.GetValue<int>();

Available Bet Levels

• Query: StatusDatabasePaths.MptStatus.AvailableStakeCombinationIndices — a JsonArray of integers. Count determines valid CustomBet buttons.
• Current bet level: StatusDatabasePaths.MptStatus.SelectedStakeCombinationIndex — zero-based stake combination index.
• Precondition: Game must be in Active Play Mode (InActivePlayMode is true) and not in a game cycle. Bet buttons are ignored during popups or game cycles.

Press → Poll → Re-Press Retry Pattern

After pressing CustomBetN, the test MUST verify that SelectedStakeCombinationIndex actually changed to the expected value. Button presses on the EGM can be silently swallowed by UI transitions, popups, or animation states.

Anti-Pattern Rule

State verification assertions for bet level changes must never be removed to resolve test failures during automated or manual fix iterations. If a readback mismatch occurs, fix the mapping, timing, or retry logic — do not strip the assertion. A test that plays games without verifying the active bet level is testing nothing.

Canonical Code Template

private const int BetChangePollIntervalMs = 200;
private const int BetChangeTimeoutMs = 5000;
private const int BetChangeMaxRetries = 3;

/// <summary>
/// Selects a bet level by pressing the CustomBet button and
/// verifying the change via SelectedStakeCombinationIndex.
/// Retries the press if the first attempt is swallowed.
/// </summary>
private async Task SelectAndVerifyBetLevelAsync(
    int betButtonIndex,
    int expectedStakeIndex)
{
    for (var attempt = 1;
         attempt <= BetChangeMaxRetries;
         attempt++)
    {
        await buttonsFacade.EmulateButtonPressByNameAsync(
            ButtonNames.BetButtons
                .GetBetButtonName(betButtonIndex));

        var matched = await WaitForConditionAsync(
            async () =>
            {
                var current = await mptStatusProvider
                    .GetSelectedStakeCombinationIndexAsync();
                return current == expectedStakeIndex;
            },
            timeoutMs: BetChangeTimeoutMs,
            pollIntervalMs: BetChangePollIntervalMs);

        if (matched)
        {
            return;
        }

        var actual = await mptStatusProvider
            .GetSelectedStakeCombinationIndexAsync();
        await TestContext.Out.WriteLineAsync(
            $"[Retry] Bet button {betButtonIndex} attempt "
            + $"{attempt}: expected index "
            + $"{expectedStakeIndex}, got {actual}. "
            + "Re-pressing...");
    }

    var finalIndex = await mptStatusProvider
        .GetSelectedStakeCombinationIndexAsync();
    Assert.Fail(
        $"Bet level selection failed after "
        + $"{BetChangeMaxRetries} attempts. "
        + $"Expected SelectedStakeCombinationIndex="
        + $"{expectedStakeIndex}, got {finalIndex}.");
}

Key Rules

• Compute the expected index BEFORE pressing: var indices = await mptStatusProvider.GetAvailableStakeCombinationIndicesAsync(); var expectedIndex = indices[betButtonIndex - 1]!.GetValue<int>();
• Poll SelectedStakeCombinationIndex in a bounded loop — do NOT use a fixed delay
• If the poll times out, re-press the button (the first press was swallowed) — do NOT skip or weaken the assertion
• After exhausting retries, fail explicitly with both expected and actual values
• Log every retry attempt via TestContext.Out.WriteLineAsync for diagnostics

TotalBet Diagnostic Logging

When iterating bet/denom combinations, log StatusDatabaseFacade.GetCurrentTotalBetCreditsAsync() before each game start:

var totalBet = await statusDatabaseFacade
    .GetCurrentTotalBetCreditsAsync();
await TestContext.Out.WriteLineAsync(
    $"  Playing denom {denomAvv} bet {betLevel}: "
    + $"TotalBet={totalBet}");

If consecutive bet levels produce identical TotalBet values, the button presses are not taking effect.

Required Dependencies

Tests that iterate bet levels MUST wire these dependencies in [SetUp]:

• MptStatusProvider — for GetSelectedStakeCombinationIndexAsync() and GetAvailableStakeCombinationIndicesAsync()
• StatusDatabaseFacade — for GetCurrentTotalBetCreditsAsync() (diagnostic logging)
• ButtonsFacade — for EmulateButtonPressByNameAsync()

SelfPlay Warning

SelfPlayFacade.StartSingleGameAsync() uses the SelfPlay UTP module's internal automation, which overrides the currently selected bet level with its own configured wager. Any preceding CustomBet button press is ignored. When a test needs to play at a specific bet level, start the game by pressing ButtonNames.GameplayButtons.StartGame via ButtonsFacade.EmulateButtonPressByNameAsync() instead.