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.
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.
- Abra o gerenciador de arquivos da sua hospedagem ou conecte-se com um programa de FTP (por exemplo, o FileZilla).
- Crie uma pasta para o jogo, por exemplo
/games/saloon-showdown/. -
Envie o conteúdo de
game/para ela:index.html,saloon-showdown.config.js,SCOPE.md,DOCUMENTATION.txte as pastasart/,audio/,assets/emodules/. -
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.
1
2
3
- Logo (
art/logo.webp) - TAP TO PLAY (aparece quando tudo carregou)
- Aviso dos créditos (fictícios e gratuitos, sem prêmios)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
- Saldo de créditos de demonstração (FREE = recarga quando acaba)
- Nível e XP do jogador (toque: próximo presente e próxima ficha)
- Moedas grátis e giro grátis diário (o ponto = algo está pronto)
- Menu: regras e opções, som, tela cheia
- A roda da fortuna (desenhada num canvas)
- Os 10 últimos resultados
- Faixa de estado: aposta total, NO MORE BETS, o prêmio
- A mesa de apostas: uma casa por número e o BONUS
- Fichas (estrela = libera num nível maior)
- UNDO desfaz a última ficha
- CLEAR limpa a mesa
- SPIN (Espaço ou Enter)
- REBET: repete as apostas da última rodada
- DOUBLE dobra todas as apostas da mesa
- 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 (
winTiersnas 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.
1
2
3
4
- Título pintado (
art/title-bonus.webp) - A roda de bônus (multiplicadores)
- A conta: aposta × multiplicador + a aposta de volta
- O que volta para o saldo
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).
1
2
3
4
- Título pintado (
art/title-daily.webp) - A roda de bônus, girada de graça
- O prêmio: multiplicador × a aposta diária (créditos de demonstração gratuitos)
- 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).
1
2
3
4
5
6
7
- Abas: HOW TO PLAY, PAYS, OPTIONS
- Música liga/desliga
- Efeitos sonoros liga/desliga
- Giro rápido (cerca de 2,5 s por giro)
- Idioma (14)
- As seis rodas prontas: escolher uma reinicia o jogo com ela
- Fechar (Esc)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
- Saldo de créditos de demonstração (FREE = recarga quando acaba)
- Nível e XP do jogador (toque: próximo presente e próxima ficha)
- Moedas grátis e giro grátis diário (o ponto = algo está pronto)
- Menu: regras e opções, som, tela cheia
- A roda da fortuna (desenhada num canvas)
- Os 10 últimos resultados
- Faixa de estado: aposta total, NO MORE BETS, o prêmio
- A mesa de apostas: uma casa por número e o BONUS
- Fichas (estrela = libera num nível maior)
- UNDO desfaz a última ficha
- CLEAR limpa a mesa
- SPIN (Espaço ou Enter)
- REBET: repete as apostas da última rodada
- DOUBLE dobra todas as apostas da mesa
- 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% |
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:
-
callbacksnosaloon-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
-
Acesse
https://nodejs.orge 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. - Feche o terminal e abra de novo (Windows: PowerShell ou Prompt de Comando; macOS: Terminal).
- 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 testroda 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 devabre uma prévia local emhttp://localhost:5218/que recarrega quando você salva um arquivo. Aperte Ctrl+C para parar. -
npm run buildgrava o jogo pronto emsource/dist/. Envie o conteúdo dedist/para a sua hospedagem (ele substitui ogame/). O build não é minificado e é formatado com o Prettier, então continua legível.
Outros comandos
-
npm run rtpmostra o RTP de cada aposta para a roda empublic/saloon-showdown.config.js;node tools/rtp.mjs --all, para todas as rodas prontas. npm run localesconfere as traduções.-
node tools/find-seeds.mjslista seeds cuja primeira rodada mostra um ganho, um x2, a roda de bônus ou um grande ganho; abrahttp://localhost:5218/?seed=Ne coloque as mesmas fichas em todas as casas para ver (as seeds funcionam no localhost ou comdebug: true). npm run formatformata o projeto inteiro com o Prettier.
Problemas comuns
-
nodeounpmnã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 rodenpm.cmd ci. ENOENT ... package.json: o terminal não está na pastasource/.EBADENGINE: o seu Node.js é mais antigo que 26.13.0. Instale a LTS atual.-
npm cifalha com erro de rede: confira a conexão ou o proxy da rede da sua empresa e rode de novo. -
npm cidiz que o arquivo de lock está fora de sincronia: você mudou opackage.json; rodenpm installuma vez e onpm civolta 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/(ougame/art/na hospedagem). Troque um arquivo por outro WebP com o mesmo nome e as mesmas proporções. -
Sons:
source/public/audio/(ougame/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 emsource/src/ui/plates.cssesource/src/ui/art.js. -
Textos:
textsnosaloon-showdown.config.jsousource/src/locales/. -
A roda e os pagamentos dela:
mathnosaloon-showdown.config.js(sem refazer o build) ouPRESETSemsource/src/logic/engine.js, depoisnpm 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: trueacrescenta 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/(commodules/,assets/,art/eaudio/) e se está abrindo por http(s), não porfile://. 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.jsnão tem como funcionar (por exemplo, uma ficha acima demaxSpot, 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ópriamath.wheel(fatias e pagamentos) e meça comnpm 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=Ndonode tools/find-seeds.mjs, ou definadebug: truedurante 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).