Cyber Sampa — Technical Design Document (TDD)

Versão: 1.0 Data: 2026-04-03 Arquitetura: Pay Anywhere + Nudge/Hold Logic Plataforma: Lottopar

1. Reel Strip Configuration

1.1 Estrutura dos Rolos

Diferente de Megaways, cada rolo tem altura FIXA (5 símbolos vistos) mas com ofertas de Nudge:

python REEL_STRIPS = { "reel_1": [ "7", "BUZINA", "ENGRENAGEM", "NUMERO", "7", "NUMERO", "BUZINA", "ENGRENAGEM", "7", "NUMERO", ... ], # Total 30-40 posições "reel_2": [...], # ... "reel_6": [...] }

2. Nudge Detection Algorithm

2.1 Quando Oferecer Nudge

```python def should_offer_nudge(reel_config, target_prize): """ Determina se oferecerá nudge para um rolo específico """

nudge_offers = []

for reel_idx in range(6):
    current_symbols = reel_config[reel_idx]

    # Contar símbolos iguais no rolo
    for symbol in PAYABLE_SYMBOLS:
        count = current_symbols.count(symbol)

        if count == 7:
            # Se temos 7 símbolos iguais
            # Verificar: empurrando faria 8+?
            next_symbol = get_next_symbol_from_strip(reel_idx)

            if next_symbol == symbol:
                # Sim! Oferecemos nudge
                nudge_offers.append({
                    "reel": reel_idx,
                    "symbol": symbol,
                    "current_count": 7,
                    "after_nudge_count": 8
                })

return nudge_offers

```

3. Nudge Application

3.1 Processamento do Nudge

```python def apply_nudge(reel_idx, current_reel_position): """ Executa o empurrão """

# Deslocar visualmente o rolo (+1 posição)
old_position = current_reel_position
new_position = (old_position + 1) % len(REEL_STRIPS[reel_idx])

# Atualizar reels
REEL_STRIPS[reel_idx][new_position] move up (visualizar)

return new_position

```

4. Hold Logic

4.1 Seleção de Hold

```python class HoldManager: def init(self): self.held_reels = set() # Índices de rolos presos

def toggle_hold(self, reel_idx):
    """Jogador marca rolo para HOLD no próximo giro"""
    if reel_idx in self.held_reels:
        self.held_reels.remove(reel_idx)
    else:
        self.held_reels.add(reel_idx)

def spin_with_holds(self):
    """
    Próximo giro: apenas rolos NÃO em hold giram
    Rolos em hold mantêm símbolos
    """
    new_reel_config = []

    for reel_idx in range(6):
        if reel_idx in self.held_reels:
            # Manter o rolo atual
            new_reel_config.append(CURRENT_REELS[reel_idx])
        else:
            # Girar normalmente
            new_position = random.randint(0, 39)  # 40 posições no strip
            new_reel_config.append(REEL_STRIPS[reel_idx][new_position])

    return new_reel_config

```

5. Pay Anywhere Validation

5.1 Detectar Vitória (Qualquer lugar, não linhas)

```python def find_winning_pay_anywhere(grid): """ grid: 6x5 (6 rolos, 5 posições visíveis) Encontra 8+ símbolos iguais em qualquer lugar """

winning_combos = []

for symbol in PAYABLE_SYMBOLS:
    # Contar todas ocorrências deste símbolo na grade
    positions = []
    for reel in range(6):
        for pos in range(5):
            if grid[reel][pos] == symbol:
                positions.append((reel, pos))

    if len(positions) >= 8:
        payout = PAYTABLE[symbol][len(positions)]
        winning_combos.append({
            "symbol": symbol,
            "count": len(positions),
            "positions": positions,
            "payout": payout
        })

return winning_combos

```

6. Acumulador Multiplicador de Bônus

6.1 Lógica de Bônus

```python class BonusMultiplierAccumulator: def init(self): self.accumulated_multiplier = 0 self.spin_count = 0

def add_multiplier(self, spin_multiplier):
    """Adiciona novo multiplicador ao acumulador"""
    self.accumulated_multiplier += spin_multiplier
    return self.accumulated_multiplier

def apply_to_payout(self, base_payout):
    """Aplica multiplicador acumulado"""
    return base_payout * self.accumulated_multiplier

def process_bonus_spin(self, winning_symbols_count):
    """
    Processa 1 giro do bônus
    """
    # Determinar multiplicador DESTE giro
    spin_mult = self.calculate_spin_multiplier(winning_symbols_count)

    # Adicionar ao acumulador
    total_mult = self.add_multiplier(spin_mult)

    # Próximas vitórias usarão total_mult
    return total_mult

def calculate_spin_multiplier(self, count):
    """Multiplicador baseado no count"""
    if count < 8:
        return 0  # Sem vitória
    elif count <= 9:
        return 2
    elif count <= 10:
        return 3
    elif count <= 11:
        return 4
    elif count <= 12:
        return 5
    else:
        return 10  # 12+ símbolos

```

6.2 Exemplo de Bônus

``` Giro 1: 8 BARs encontrados Spin Multiplier = 2x Accumulated = 0 + 2 = 2x Payout = 50x × 2 = 100x

Giro 2: Sem vitória Spin Multiplier = 0 Accumulated = 2x (não muda)

Giro 3: 10 Buzinas encontradas Spin Multiplier = 3x Accumulated = 2 + 3 = 5x Payout = 100x × 5 = 500x

Giro 4: 8 Engrenagens encontradas Spin Multiplier = 2x Accumulated = 5 + 2 = 7x Payout = 10x × 7 = 70x

Total Bônus = 100 + 0 + 500 + 70 = 670x ```

7. JSON Payloads

7.1 Giro Normal com Nudge Offer

json { "spin_result": { "reel_config": [ ["7", "BUZINA", "ENGRENAGEM", "NUMERO", "7"], ["NUMERO", "NUMERO", "NUMERO", "NUMERO", "NUMERO"], ["7", "7", "7", "7", "BUZINA"], ["ENGRENAGEM", "BUZINA", "ENGRENAGEM", "BUZINA", "ENGRENAGEM"], ["NUMERO", "NUMERO", "NUMERO", "7", "NUMERO"], ["BUZINA", "BUZINA", "BUZINA", "NUMERO", "NUMERO"] ], "pay_anywhere_wins": [ { "symbol": "7", "count": 8, "payout": 100 } ], "nudge_offers": [ { "reel": 2, "symbol": "7", "reason": "7 symbols, nudge would make 8" } ], "total_win": 100, "bonus_triggered": false } }

7.2 Bônus

json { "bonus_session": { "num_spins": 10, "spins": [ { "spin_num": 1, "winning_symbols": {"7": 10}, "spin_multiplier": 3, "accumulated_multiplier": 3, "base_payout": 200, "final_payout": 600 }, { "spin_num": 2, "winning_symbols": {"BUZINA": 9}, "spin_multiplier": 3, "accumulated_multiplier": 6, "base_payout": 50, "final_payout": 300 } ], "total_bonus_win": 2500 } }

8. RTP Validation

```python def validate_rtp_with_holds_and_nudges(num_sessions=10000): """ Simula com Holds e Nudges incluídos """ total_wagered = 0 total_paid = 0

for _ in range(num_sessions):
    # Spin base
    wager = 10.0
    base_payout = run_spin()
    total_wagered += wager
    total_paid += base_payout

    # Jogador aleatoriamente aplica holds
    if random.random() < 0.3:
        # Jogador usa holds
        held_payout = run_spin_with_holds()
        total_paid += held_payout

observed_rtp = total_paid / total_wagered
expected_rtp = 0.94

assert abs(observed_rtp - expected_rtp) < 0.02
print(f"✓ RTP: {observed_rtp:.4f}")

```

9. Reel Strip Definition

```python REEL_1 = [ "7", "BUZINA", "NUMERO", "7", "ENGRENAGEM", "NUMERO", "7", "BUZINA", "NUMERO", "7", "BUZINA", "7", "NUMERO", "ENGRENAGEM", "NUMERO", "7", "BUZINA", "7", "NUMERO", "ENGRENAGEM", "NUMERO", "7", "BUZINA", "NUMERO", "7", "ENGRENAGEM", "NUMERO", "7", "BUZINA", "NUMERO", "7", "NUMERO", "BUZINA", "7", "ENGRENAGEM", "NUMERO", "7", "NUMERO", "BUZINA", "7" ]

Pesos aproximados:

7: ~25% (40 of 160 posições)

BUZINA: ~20%

ENGRENAGEM: ~15%

NUMERO: ~40%

```

10. Hardware & Performance

• 60 FPS smooth
• Nudge animation: 300ms
• Hold toggle: instant
• Total spin duration: 3-5 seconds

Conclusão

Cyber Sampa combina Nudge (pseudo-skill) com Pay Anywhere e multiplicador acumulativo. Implementação relativamente direta mas exige validação cuidadosa de que multiplicador acumulado não exceeds caps.

Data: 2026-04-03 Status: Pronto para Desenvolvimento

Prompts de Geração de Arte IA

Clique em qualquer prompt para copiar. Os prompts abaixo são otimizados para Midjourney v6, DALL-E 3, e Stable Diffusion.