Saloon Showdown 1.0.0: guia do comprador

Jogo HTML5 de roda da fortuna (simulação) com créditos fictícios gratuitos. Código-fonte editável incluído.

Guia de personalização (receitas)

EnglishPortuguêsEspañol

Visão geral

Saloon Showdown é um jogo HTML5 de roda da fortuna (uma roda de prêmios no estilo "Big Six") num saloon do Velho Oeste, apresentado por uma raposa xerife. O jogador coloca fichas nos números, gira a roda grande e ganha quando ela para num número com aposta. As fatias douradas x2 giram a roda de novo com todo ganho multiplicado, e a fatia BONUS abre uma segunda roda de multiplicadores. Ele vem pronto para hospedar (game/) e com o código-fonte completo e editável (source/). Funciona em qualquer navegador atual, em celulares, tablets e computadores, na vertical e na horizontal, sem servidor, banco de dados ou conta.

Recursos: 6 rodas prontas (de 16 a 54 fatias), novos giros x2/x7 que se acumulam, uma roda de bônus, comemorações BIG/MEGA/EPIC WIN, giro rápido, níveis do jogador que liberam fichas maiores, um giro grátis diário da roda de bônus, moedas grátis a cada 3 horas, jogo pelo teclado, 14 idiomas na interface, voz de locutor gravada, música e efeitos.

Apenas simulação. O jogador recebe créditos de demonstração gratuitos e fictícios. Eles não têm valor monetário e não podem ser comprados, transferidos, vendidos nem resgatados. Não há depósitos, saques, prêmios nem recompensas de valor econômico. O preço da compra é de uma licença de software, não de participação em jogo de azar. A licença não permite o uso em jogo de azar com dinheiro real ou com qualquer outra coisa de valor real. Leia o SCOPE.md (na raiz do pacote e dentro de game/): ele faz parte dos termos da licença.

A mesa com fichas em todas as casas (1280×720).
A mesa com fichas em todas as casas (1280×720).

Instalar no seu site

O jogo pronto para jogar é a pasta game/. É HTML, CSS e JavaScript puros: não precisa de build, de Node.js nem de banco de dados para hospedá-lo.

  1. Abra o gerenciador de arquivos da sua hospedagem ou conecte-se com um programa de FTP (por exemplo, o FileZilla).
  2. Crie uma pasta para o jogo, por exemplo /games/saloon-showdown/.
  3. Envie o conteúdo de game/ para ela: index.html, saloon-showdown.config.js, SCOPE.md, DOCUMENTATION.txt e as pastas art/, audio/, assets/ e modules/.
  4. Abra o endereço no navegador, por exemplo https://your-site.example/games/saloon-showdown/.

O jogo usa caminhos relativos, então funciona em qualquer pasta ou subdomínio. Abrir o index.html direto do seu disco (file://) não funciona, porque os navegadores bloqueiam módulos JavaScript nesse caso: teste numa hospedagem web ou com a prévia local descrita em "Editar o código-fonte".

Colocar dentro de uma página (iframe)

<iframe src="/games/saloon-showdown/" style="width:100%;aspect-ratio:16/9;border:0" allow="fullscreen; autoplay"></iframe>

Deixe visível o aviso de créditos na tela e mantenha o SCOPE.md junto com o jogo quando publicá-lo para o público.

Requisitos

  • Qualquer hospedagem web estática, HTTP ou HTTPS (hospedagem compartilhada, uma CDN, GitHub Pages, Netlify...). Sem PHP, banco de dados ou código de servidor.
  • Um navegador atual: Chrome, Edge, Firefox, Safari (macOS e iOS), Samsung Internet ou Opera.
  • Só para editar o código-fonte: Node.js 26 LTS (a linha LTS atual, 26.13.0 ou mais nova) e npm, veja "Editar o código-fonte".
  • Não é preciso internet para jogar: arte, sons e código estão todos dentro de game/. O jogo não faz requisições a outros sites.

Como jogar e as telas

O jogador toca em TAP TO PLAY (tocar para jogar), escolhe uma ficha e toca nas casas dos números em que a roda pode parar (várias de uma vez), e depois toca em SPIN (girar). Todas as fatias têm o mesmo tamanho, então todas têm a mesma chance: um número que está em mais fatias ganha com mais frequência e paga menos. Uma aposta num número paga o valor dele para 1 (uma aposta no 5 paga 5 vezes a aposta) e a aposta também volta. Todos os valores são créditos de demonstração fictícios.

A tela de entrada com o aviso dos créditos. 1 2 3
A tela de entrada com o aviso dos créditos.
  1. Logo (art/logo.webp)
  2. TAP TO PLAY (aparece quando tudo carregou)
  3. Aviso dos créditos (fictícios e gratuitos, sem prêmios)
A mesa com fichas em todas as casas (1280×720). 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15
A mesa com fichas em todas as casas (1280×720).
  1. Saldo de créditos de demonstração (FREE = recarga quando acaba)
  2. Nível e XP do jogador (toque: próximo presente e próxima ficha)
  3. Moedas grátis e giro grátis diário (o ponto = algo está pronto)
  4. Menu: regras e opções, som, tela cheia
  5. A roda da fortuna (desenhada num canvas)
  6. Os 10 últimos resultados
  7. Faixa de estado: aposta total, NO MORE BETS, o prêmio
  8. A mesa de apostas: uma casa por número e o BONUS
  9. Fichas (estrela = libera num nível maior)
  10. UNDO desfaz a última ficha
  11. CLEAR limpa a mesa
  12. SPIN (Espaço ou Enter)
  13. REBET: repete as apostas da última rodada
  14. DOUBLE dobra todas as apostas da mesa
  15. Aviso dos créditos, sempre visível durante o jogo
  • As fatias x2 / x7 não recebem apostas: a roda gira de novo com todas as apostas ainda na mesa, e o próximo ganho é multiplicado. Elas se acumulam (x2 e depois x7 = x14), até 9 vezes seguidas na roda padrão; o último novo giro permitido só pode cair nas outras fatias.
  • BONUS: uma aposta em BONUS gira a roda de bônus e ganha o multiplicador dela (vezes qualquer x2/x7 que tenha vindo antes).
  • Nenhuma rodada paga mais de 5.000× a aposta total. As comemorações BIG, MEGA e EPIC WIN começam em 10×, 25× e 50× a aposta total (winTiers nas configurações).
  • Um toque na roda (ou Espaço) enquanto ela gira faz a roda frear no resultado que já tem; um toque pula uma comemoração.
A roda girando: as apostas ficam fechadas até ela parar.
A roda girando: as apostas ficam fechadas até ela parar.
Um prêmio: a casa vencedora acende e paga; as outras fichas são recolhidas.
Um prêmio: a casa vencedora acende e paga; as outras fichas são recolhidas.
x2: a roda gira de novo e o próximo prêmio sai dobrado.
x2: a roda gira de novo e o próximo prêmio sai dobrado.
A roda de bônus: uma aposta no BONUS ganha o multiplicador dela. 1 2 3 4
A roda de bônus: uma aposta no BONUS ganha o multiplicador dela.
  1. Título pintado (art/title-bonus.webp)
  2. A roda de bônus (multiplicadores)
  3. A conta: aposta × multiplicador + a aposta de volta
  4. O que volta para o saldo
Comemoração de BIG WIN (valores em créditos fictícios de demonstração).
Comemoração de BIG WIN (valores em créditos fictícios de demonstração).

Recompensas fora da roda

  • Níveis: jogar dá XP; cada nível novo dá um presente (250 créditos × o nível novo) e libera fichas maiores: 500 (nível 3), 1.000 (nível 6).
  • Giro grátis diário: uma vez a cada 24 horas, o jogo abre a roda de bônus para um giro grátis: o prêmio é o multiplicador dela × 100 créditos. LATER (depois) guarda o giro para outra hora (o botão de presente abre de novo).
  • Moedas grátis: o botão de presente dá 500 créditos grátis a cada 3 horas.
  • Quando os créditos acabam, o botão FREE (grátis) no saldo recarrega os créditos (até os 100.000 iniciais).
O giro grátis diário da roda de bônus, depois do giro (créditos de demonstração gratuitos). 1 2 3 4
O giro grátis diário da roda de bônus, depois do giro (créditos de demonstração gratuitos).
  1. Título pintado (art/title-daily.webp)
  2. A roda de bônus, girada de graça
  3. O prêmio: multiplicador × a aposta diária (créditos de demonstração gratuitos)
  4. SPIN, depois COLLECT (LATER guarda para outra hora)

Menu, regras e opções

O botão de menu abre o painel de regras (HOW TO PLAY, PAYS e OPTIONS: como jogar, pagamentos e opções), o botão de liga e desliga do som e a tela cheia. Os textos das regras e a tabela PAYS são escritos pelo jogo para a roda em uso. OPTIONS tem música, efeitos sonoros, giro rápido, o idioma e as 6 rodas prontas: escolher uma roda reinicia o jogo com ela (o saldo e o nível do jogador continuam; o histórico da roda antiga é apagado).

OPÇÕES: música, efeitos, giro rápido, idioma e as seis rodas prontas. 1 2 3 4 5 6 7
OPÇÕES: música, efeitos, giro rápido, idioma e as seis rodas prontas.
  1. Abas: HOW TO PLAY, PAYS, OPTIONS
  2. Música liga/desliga
  3. Efeitos sonoros liga/desliga
  4. Giro rápido (cerca de 2,5 s por giro)
  5. Idioma (14)
  6. As seis rodas prontas: escolher uma reinicia o jogo com ela
  7. Fechar (Esc)
COMO JOGAR: as regras, escritas para a roda em uso.
COMO JOGAR: as regras, escritas para a roda em uso.
PAGAMENTOS: fatias e pagamento de cada aposta da roda em uso.
PAGAMENTOS: fatias e pagamento de cada aposta da roda em uso.
Celular em pé (390×844): o mesmo jogo, reorganizado. 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15
Celular em pé (390×844): o mesmo jogo, reorganizado.
  1. Saldo de créditos de demonstração (FREE = recarga quando acaba)
  2. Nível e XP do jogador (toque: próximo presente e próxima ficha)
  3. Moedas grátis e giro grátis diário (o ponto = algo está pronto)
  4. Menu: regras e opções, som, tela cheia
  5. A roda da fortuna (desenhada num canvas)
  6. Os 10 últimos resultados
  7. Faixa de estado: aposta total, NO MORE BETS, o prêmio
  8. A mesa de apostas: uma casa por número e o BONUS
  9. Fichas (estrela = libera num nível maior)
  10. UNDO desfaz a última ficha
  11. CLEAR limpa a mesa
  12. SPIN (Espaço ou Enter)
  13. REBET: repete as apostas da última rodada
  14. DOUBLE dobra todas as apostas da mesa
  15. Aviso dos créditos, sempre visível durante o jogo

Teclado

Tab passa pelas casas de aposta e pelos botões, e Enter ou Espaço aperta o que estiver em foco. Espaço ou Enter em qualquer outro lugar gira; enquanto a roda gira, isso a apressa, e na roda de bônus ou num grande ganho, pula para a frente. M liga e desliga o som. Escape fecha o painel de regras. Menos movimento segue a configuração do aparelho (prefers-reduced-motion): giros mais curtos, sem tremida na tela, sem fichas voando.

As 6 rodas prontas e o RTP delas

Escolha a roda com math.preset no saloon-showdown.config.js (padrão studio), ou deixe os jogadores escolherem em OPTIONS (wheelChoice). Cada número abaixo é lido de source/src/logic/engine.js (PRESETS e a fórmula exata rtpOf(), que o npm test confere com uma simulação longa) quando este guia é gerado.

math.preset Fatias Apostas Multiplicadores (fatias) Roda de bônus RTP por aposta
studio (padrão) 16 1, 2, 5, 10, BONUS x2 (2) 2x … 50x (média 10,42x) 90,5 – 97,6%
party 24 1, 2, 6, 20, BONUS x2 (1) 4x … 100x (média 19,33x) 92,2 – 97,8%
grand 36 1, 2, 7, 10, BONUS x2 (1) 6x … 150x (média 31,17x) 92,8 – 96,8%
polar 54 1, 2, 5, 10, 20, 40, BONUS x2 (1), x7 (1) 5x … 250x (média 41,67x) 90,8 – 96,6%
show 54 1, 2, 5, 10, 20, 40 x2 (1), x7 (1) — 90,8 – 96,6%
classic 54 1, 2, 5, 10, 20, @crown, @star — — 75,9 – 88,9%
As seis rodas prontas no computador e no celular, da esquerda para a direita e de cima para baixo: studio, party, grand, polar, show, classic.
As seis rodas prontas no computador e no celular, da esquerda para a direita e de cima para baixo: studio, party, grand, polar, show, classic.
A roda `polar` de 54 fatias com apostas nas sete casas.
A roda polar de 54 fatias com apostas nas sete casas.

RTP de cada aposta

RTP = quanto de cada 100 créditos apostados volta em média, no longo prazo. Ele descreve só o ritmo da simulação: os créditos são fictícios.

Roda Aposta: fatias, pagamento → RTP
studio 1: 6, 1:1 → 92,86% · 2: 4, 2:1 → 95,24% · 5: 2, 5:1 → 97,62% · 10: 1, 10:1 → 90,48% · BONUS: 1, roda de bônus → 93,95%
party 1: 11, 1:1 → 97,83% · 2: 7, 2:1 → 94,07% · 6: 3, 6:1 → 94,86% · 20: 1, 20:1 → 95,26% · BONUS: 1, roda de bônus → 92,23%
grand 1: 16, 1:1 → 92,77% · 2: 11, 2:1 → 96,13% · 7: 4, 7:1 → 93,78% · 10: 3, 10:1 → 96,81% · BONUS: 1, roda de bônus → 94,52%
polar 1: 22, 1:1 → 91,20% · 2: 15, 2:1 → 95,51% · 5: 7, 5:1 → 91,24% · 10: 4, 10:1 → 96,58% · 20: 2, 20:1 → 92,74% · 40: 1, 40:1 → 90,81% · BONUS: 1, roda de bônus → 94,52%
show 1: 23, 1:1 → 95,34% · 2: 15, 2:1 → 95,51% · 5: 7, 5:1 → 91,24% · 10: 4, 10:1 → 96,58% · 20: 2, 20:1 → 92,74% · 40: 1, 40:1 → 90,81%
classic 1: 24, 1:1 → 88,89% · 2: 15, 2:1 → 83,33% · 5: 7, 5:1 → 77,78% · 10: 4, 10:1 → 81,48% · 20: 2, 20:1 → 77,78% · @crown: 1, 40:1 → 75,93% · @star: 1, 40:1 → 75,93%

showRtp: true mostra a coluna de RTP na aba PAYS do jogo. Depois de mudar uma roda, rode npm run rtp em source/ (ele lê public/saloon-showdown.config.js; node tools/rtp.mjs --all lista todas as rodas prontas).

O que vem no pacote

saloon-showdown-static-1.0.0/
  START-HERE.txt          first steps
  DOCUMENTATION.html      opens this guide
  CUSTOMIZATION.html      opens the customization guide (recipes, no coding)
  CHANGELOG.txt
  SCOPE.md                what the product is and what the licence does not allow
  documentation/          this guide and the customization guide (EN/PT/ES), screenshots
  game/                   UPLOAD THE CONTENTS OF THIS FOLDER
    index.html            the page
    saloon-showdown.config.js  your settings (edit on the host, no rebuild)
    modules/              the JavaScript, one readable file per source module
    assets/ui/            the stylesheets
    art/                  images (WebP)
    audio/                sounds, voice and music (MP3)
    SCOPE.md, DOCUMENTATION.txt
  source/                 the complete editable project
    index.html            the page (development version)
    src/main.js           round flow (spin, respins, bonus wheel, payouts), celebrations, daily spin, input
    src/config.js         defaults, events, save key
    src/logic/            engine.js (wheels, limits, round draw, RTP, credits), progress.js (levels, daily spin, coins)
    src/ui/               money-wheel.js, wheel-fit.js, sheets.js, fx.js, theme.js, feel.js, art.js, styles.css, plates.css...
    src/locales/          the 14 languages (en.js is the reference)
    src/audio/audio.js    the list of sounds, music and voices
    public/               art/, audio/, saloon-showdown.config.js (copied to the build as they are)
    tests/                npm test
    tools/                RTP report, translation check, seed finder, in-page label check, build formatter
    package.json, package-lock.json, vite.config.js, .prettierrc, README.md, CREDITS.md
    licenses/             licences of the development tools
  THIRD-PARTY-LICENSES/   the same licence texts

game/ é exatamente o que o npm run build gera a partir de source/ (conferido arquivo por arquivo antes de empacotar). Edite source/ e gere o build de novo, ou edite só o saloon-showdown.config.js na hospedagem.

Configurações (saloon-showdown.config.js)

O game/saloon-showdown.config.js é lido toda vez que o jogo abre, então você pode mudar estas configurações na sua hospedagem com um editor de texto, sem refazer o build. Todos os campos são opcionais: tire o // da frente de uma linha para usá-la. Um valor errado interrompe o jogo na primeira tela com uma mensagem dizendo o que corrigir.

window.SALOON_SHOWDOWN_CONFIG = {
  brand: { name: 'Saloon Showdown', storageKey: 'mysite.saloon-showdown' },
  language: 'auto',
  languages: ['en', 'pt', 'es'],
  texts: { tapToPlay: 'PLAY NOW', de: { tapToPlay: 'LOS!' } },
  audio: { volume: 0.8, muted: false },
  ageGate: true,
  showRtp: true,
  quickSpin: false,
  wheelChoice: true,
  math: { preset: 'polar', startBalance: 100000, chips: [10, 50, 100, 500, 1000], maxTotal: 20000 },
  progress: { daily: { everyHours: 24 }, coins: { everyHours: 3, amount: 50 } },
  winTiers: { big: 10, mega: 25, epic: 50 },
};
Opção O que faz
brand.name nome do jogo usado nas mensagens (o título da página fica no index.html)
brand.storageKey prefixo dos dados salvos no navegador (padrão saloon-showdown.template.save.v1); mude-o para começar com dados salvos novos
language 'auto' = o idioma do aparelho (inglês quando ele não é oferecido), ou um código: en pt es fr de it nl pl tr ru id ja ko zh. A escolha do jogador em OPTIONS e ?lang=xx no endereço têm prioridade
languages os idiomas oferecidos em OPTIONS (padrão: todos os 14). Com um só idioma, o seletor some
texts substitui qualquer texto de src/locales/en.js em todos os idiomas, ou em um só (texts: { pt: {...} })
audio volume inicial (0 a 1) e se começa sem som
ageGate true mostra o selo 18+ e o aviso de cassino social
showRtp mostra o RTP de cada aposta na aba PAYS (calculado a partir da roda, nunca digitado)
quickSpin a opção de giro rápido já começa ligada (cerca de 2,5 s por giro). Os jogadores mudam isso em OPTIONS
wheelChoice true (padrão): OPTIONS lista as 6 rodas prontas, e escolher uma reinicia o jogo com ela. false esconde a lista. Ela fica escondida de qualquer jeito quando você define a sua própria math.wheel
pegHang false (padrão): a roda sempre freia direto na fatia sorteada. true: às vezes ela fica presa um instante num pino antes (só aparência: o resultado é sorteado antes de a roda se mexer)
debug só para testes: permite ?seed=123 no endereço (as mesmas rodadas toda vez) em qualquer hospedagem
math preset (veja "As rodas prontas"), startBalance (100.000), chips (10, 50, 100, 500, 1.000, no máximo 5, a menor primeiro), minTotal (10), maxSpot (5.000 numa casa), maxTotal (20.000 na mesa), maxWin (5.000× a aposta total) e wheel para a sua própria roda (veja o guia de personalização). Rode npm run rtp depois de mudar
progress levels (enabled, need, reward, unlock), daily (enabled, alwaysReady, everyHours, stake) e coins (enabled, everyHours, amount). Os valores são múltiplos da menor ficha
winTiers a partir de quantas vezes a aposta total começam as comemorações BIG, MEGA e EPIC
integration, callbacks eventos para a sua própria página, veja "Eventos"

O arquivo do pacote lista cada opção com um comentário. Os valores padrão completos estão em source/src/config.js, source/src/logic/engine.js (MATH, PRESETS) e source/src/logic/progress.js (PROGRESS).

Idiomas

A interface está traduzida para 14 idiomas: inglês, português, espanhol, francês, alemão, italiano, holandês, polonês, turco, russo, indonésio, japonês, coreano e chinês (simplificado). A voz do locutor e os títulos pintados (BONUS ROUND, FREE SPIN, BIG/MEGA/EPIC WIN) são imagens e sons em inglês em todos os idiomas. O jogo abre no idioma do aparelho; o jogador pode mudar em OPTIONS, e ?lang=pt no endereço força um idioma.

Os textos ficam em source/src/locales/<code>.js, um arquivo por idioma, com as mesmas chaves do en.js. Quando falta uma chave, o jogo usa o texto em inglês. Para mudar alguns textos sem refazer o build, use texts no saloon-showdown.config.js. Depois de editar os arquivos de idioma, rode npm run locales para conferir se nenhuma tradução perdeu um marcador {value}. Para conferir se cada rótulo ainda cabe na sua placa, abra o jogo com npm run dev, cole tools/qa-fit.js no console do navegador (F12) e rode __qaFit(): uma lista vazia quer dizer que todos os rótulos cabem.

Dados salvos

O jogo guarda o saldo, o nível, o histórico, a roda escolhida, as opções e os temporizadores das recompensas no localStorage do navegador, em chaves que começam com saloon-showdown.template.save.v1. (por exemplo saloon-showdown.template.save.v1.balance). Nada é enviado para lugar nenhum. Uma rodada é decidida no momento em que SPIN é apertado, então recarregar a página no meio de um giro não muda nada. Limpar os dados do site no navegador zera o jogo. Se você publicar duas cópias do jogo no mesmo domínio, dê a cada uma o seu próprio brand.storageKey.

Eventos para a sua página

O jogo envia eventos para que a sua página possa mostrar estatísticas, conquistas ou um ranking de pontuações fictícias. Eles não são uma interface de contabilidade ou de pagamento e não devem ser usados como tal. Há quatro formas; use qualquer uma:

  • callbacks no saloon-showdown.config.js: onReady, onSpin, onWin, onBalance, onBonus, onError.
  • window.SaloonShowdown.on('win', fn) a partir de um script na mesma página; window.SaloonShowdown.getBalance() lê o saldo.
  • Eventos DOM em window: saloonshowdown:ready, saloonshowdown:spin, saloonshowdown:win, saloonshowdown:balance, saloonshowdown:bonus, saloonshowdown:error.
  • Dentro de um iframe, com integration: { postMessage: true, targetOrigin: 'https://your-site.example' }, a página pai recebe { source: 'saloon-showdown', type: 'win', payload: {...} }.
Evento Dados enviados
ready { version, rulesVersion, preset, locale }
spin a rodada: { bets, spent, chain, key, mult, bonus, pays, payout, capped, balanceBefore, balanceAfter } (sorteada antes de a roda se mexer)
win a mesma rodada, depois que o ganho foi mostrado
balance { balance }
bonus uma recompensa de demonstração grátis: { kind: 'daily' / 'coins' / 'level', amount, balance }
error { message } (um valor errado na configuração, ou uma rodada que não pôde ser jogada)

round.spent são os créditos de demonstração colocados numa rodada e round.payout, os créditos de demonstração que ela devolveu (com a aposta incluída).

<script>
  addEventListener('saloonshowdown:win', (e) => console.log('won', e.detail.payout));
</script>

Editar o código-fonte (Node.js para iniciantes)

Você só precisa disto para mudar código, estilos, arte ou sons e gerar um novo game/. Para mudar configurações, edite o saloon-showdown.config.js.

1. Instalar o Node.js

  1. Acesse https://nodejs.org e baixe a versão LTS (Node.js 26 LTS). Windows e macOS: rode o instalador com as opções padrão. Linux: use o gerenciador de pacotes ou os binários oficiais.
  2. Feche o terminal e abra de novo (Windows: PowerShell ou Prompt de Comando; macOS: Terminal).
  3. Confira as versões: os dois comandos precisam mostrar um número, e o Node precisa ser 26.13.0 ou mais novo.
node --version
npm --version

2. Instalar as ferramentas do projeto

Abra o terminal na pasta source/ (Windows: abra a pasta no Explorador de Arquivos, clique na barra de endereço, digite powershell e aperte Enter; macOS: arraste a pasta até o ícone do Terminal). Depois rode:

npm ci

Isso instala as versões exatas do package-lock.json (Vite e Prettier) em node_modules/. Precisa de internet uma vez.

3. Testar, ver a prévia e gerar o build

npm test
npm run dev
npm run build
  • npm test roda os 16 testes das regras (sorteio da rodada, fórmula do RTP comparada com uma simulação longa, recusas da configuração, números cabendo nas fatias). Todos precisam passar.
  • npm run dev abre uma prévia local em http://localhost:5218/ que recarrega quando você salva um arquivo. Aperte Ctrl+C para parar.
  • npm run build grava o jogo pronto em source/dist/. Envie o conteúdo de dist/ para a sua hospedagem (ele substitui o game/). O build não é minificado e é formatado com o Prettier, então continua legível.

Outros comandos

  • npm run rtp mostra o RTP de cada aposta para a roda em public/saloon-showdown.config.js; node tools/rtp.mjs --all, para todas as rodas prontas.
  • npm run locales confere as traduções.
  • node tools/find-seeds.mjs lista seeds cuja primeira rodada mostra um ganho, um x2, a roda de bônus ou um grande ganho; abra http://localhost:5218/?seed=N e coloque as mesmas fichas em todas as casas para ver (as seeds funcionam no localhost ou com debug: true).
  • npm run format formata o projeto inteiro com o Prettier.

Problemas comuns

  • node ou npm não é reconhecido: o Node.js não está instalado ou o terminal foi aberto antes da instalação. Reinstale e abra um terminal novo.
  • O Windows diz que a execução de scripts está desabilitada (npm.ps1): use o Prompt de Comando ou rode npm.cmd ci.
  • ENOENT ... package.json: o terminal não está na pasta source/.
  • EBADENGINE: o seu Node.js é mais antigo que 26.13.0. Instale a LTS atual.
  • npm ci falha com erro de rede: confira a conexão ou o proxy da rede da sua empresa e rode de novo.
  • npm ci diz que o arquivo de lock está fora de sincronia: você mudou o package.json; rode npm install uma vez e o npm ci volta a funcionar.
  • A porta 5218 está ocupada: o Vite escolhe a próxima porta livre e mostra qual é.

Personalizar e trocar o visual

O guia de personalização (CUSTOMIZATION.html) tem receitas passo a passo para quem não programa: os fundos, o logo, o apresentador, as peças da roda, as placas e as fichas, sons e música, cores, textos, a roda e os pagamentos dela, fichas e limites. Em resumo:

  • Arte: source/public/art/ (ou game/art/ na hospedagem). Troque um arquivo por outro WebP com o mesmo nome e as mesmas proporções.
  • Sons: source/public/audio/ (ou game/audio/). Troque um MP3 por outro com o mesmo nome.
  • Cores e materiais das fatias: source/src/ui/theme.js. Tempos (tempo de giro, a mola do ponteiro, as comemorações): source/src/ui/feel.js. Só aparência: nada ali muda um resultado.
  • Layout e estilos: source/src/ui/styles.css; os cortes das placas estão em source/src/ui/plates.css e source/src/ui/art.js.
  • Textos: texts no saloon-showdown.config.js ou source/src/locales/.
  • A roda e os pagamentos dela: math no saloon-showdown.config.js (sem refazer o build) ou PRESETS em source/src/logic/engine.js, depois npm run rtp.

Mudanças em source/ precisam de npm run build. Mudanças em arquivos de game/ na hospedagem (arte, áudio, saloon-showdown.config.js) não precisam de build.

Nomes internos

Alguns nomes no código vêm dos módulos compartilhados de efeitos e do motor, ou são nomes curtos de coisas na tela. São só nomes:

Nome no código O que é
CreditBank, round.spent, round.payout the fictional demo credits: credits put into one round and credits it returned (no money)
fx.snow, FEEL.ambient.snowTouch / snowDesktop the drifting-flake layer of the shared effects module; off in this game (both counts are 0 in src/ui/feel.js)
fx.frost(), fx.shards(), fx.crack() ice-burst effects of the shared effects module; this game does not call them (kept so the module stays complete)
'@crown', '@star' the two picture wedges of the classic Big Six wheel (plain bets with their own payout, art emblem-crown.webp and emblem-star.webp)
'polar' preset the 54-wedge wheel with x2/x7 respins and the bonus wheel (named after the theme, not a place)
rulesVersion 'ppshow-1' a label sent with every round event so your statistics can tell rule versions apart
host, mascot-*.webp the fox sheriff presenter ("host" in the code)
mat-blue.webp, tile-blue.webp, pill-blue.webp, mat-ruby.webp, tile-ruby.webp, token-blue.webp file names kept from the shared wheel template: in this theme "blue" is teal and "ruby" is western red

Atualizar o jogo e limpar o cache

Depois de enviar uma versão nova, navegadores e hospedagens podem guardar os arquivos antigos por um tempo. Se uma mudança não aparecer:

  • Recarregue sem o cache: Ctrl+F5 ou Ctrl+Shift+R (Windows/Linux), Cmd+Shift+R (macOS). No celular, feche a aba e abra de novo.
  • Limpe os arquivos em cache do site nas configurações do navegador ("Imagens e arquivos armazenados em cache"). Não limpe "cookies e dados do site", a menos que queira zerar o jogo salvo.
  • Teste numa janela anônima (privada).
  • Se a sua hospedagem ou CDN (por exemplo, a Cloudflare) tiver cache, limpe esse cache (purge).
  • Acrescente uma versão ao endereço uma vez, por exemplo index.html?v=2.

Os dados salvos continuam depois de uma atualização, desde que o brand.storageKey não mude.

O que o produto é (e o que não é)

  • Só créditos de demonstração gratuitos e fictícios, sem valor monetário. Eles não podem ser comprados, transferidos, vendidos nem resgatados. Não há prêmios de nenhum tipo.
  • Não há sistema de pagamento, depósito, saque, conta ou carteira: nenhum está escondido, desligado ou incluído no pacote.
  • As fichas na mesa são os mesmos créditos de demonstração gratuitos: colocá-las não é uma compra nem uma aposta de nada de valor.
  • A licença padrão não permite usar este jogo, ou qualquer versão modificada dele, para jogo de azar com dinheiro real ou com qualquer coisa de valor real: nada de compra de créditos, nada de saque, nada de prêmios baseados em resultados, nenhuma conexão com carteira de jogo de azar, sistema de pagamento ou operador de dinheiro real, nenhuma publicidade de jogo de azar com dinheiro real.
  • Você deve seguir as leis de todos os lugares onde publicar o jogo (classificação etária, menores de idade, defesa do consumidor). Mantenha o aviso de créditos visível; ageGate: true acrescenta um aviso de 18+.
  • O suporte não cobre carteira, depósito, saque nem qualquer integração com dinheiro real; esses pedidos são recusados.

O texto completo está no SCOPE.md.

Perguntas e problemas

  • A página fica em branco ou parada na barra de carregamento. Confira se você enviou o conteúdo de game/ (com modules/, assets/, art/ e audio/) e se está abrindo por http(s), não por file://. O console do navegador (F12) mostra o arquivo que falta.
  • O jogo mostra uma mensagem vermelha na primeira tela. Um valor no saloon-showdown.config.js não tem como funcionar (por exemplo, uma ficha acima de maxSpot, ou uma roda em que uma aposta devolveria 100% ou mais). A mensagem diz o que corrigir.
  • Sem som. Os navegadores só liberam som depois de um toque: o jogo liga o som no TAP TO PLAY. Confira o menu (botão de som), OPTIONS (música, efeitos) e o volume do aparelho.
  • Posso mudar o RTP? Sim: escolha outro math.preset, ou defina a sua própria math.wheel (fatias e pagamentos) e meça com npm run rtp.
  • Os jogadores podem comprar créditos ou ganhar prêmios? Não. O jogo não tem sistema de pagamento nem de prêmios, e a licença não permite acrescentar um.
  • Funciona offline? Depois de carregado, sim; não precisa de nenhum outro site.
  • Posso tirar o aviso de créditos? Numa publicação para o público ele precisa ficar visível (veja o SCOPE.md).
  • O giro grátis diário não abriu. Ele abre uma vez a cada 24 horas por navegador, e só com uma roda que tenha roda de bônus (studio, party, grand, polar). progress: { daily: { alwaysReady: true } } oferece o giro em toda visita (para uma página de demonstração).
  • Como testo a roda de bônus? No localhost, use ?seed=N do node tools/find-seeds.mjs, ou defina debug: true durante os testes.

Suporte e créditos

E-mail de suporte: willian@polargames.com.br (bugs, instalação, layout nos navegadores suportados, traduções, personalização visual e de áudio e as configurações deste guia). Inclua o seu código de compra ou de licença, o navegador e o aparelho, e uma captura de tela.

Ferramentas de desenvolvimento: Vite e Prettier (licenças MIT em THIRD-PARTY-LICENSES/). Nenhum código ou fonte de terceiros vai em game/: os números usam uma fonte pintada em imagem, feita para este jogo, e os outros textos usam as fontes do sistema do jogador. Arte, música, voz e efeitos foram feitos para este jogo e estão cobertos pela licença da sua compra (source/CREDITS.md).