Neon Flamingo Roulette 1.0.0: guia do comprador

Jogo HTML5 de mini roleta em simulação (13 casas), com créditos fictícios gratuitos. Código-fonte editável incluído.

Guia de personalização (receitas)

EnglishPortuguêsEspañol

Visão geral

Neon Flamingo Roulette é um jogo HTML5 de simulação de mini roleta: uma roleta com 13 casas (o 0 verde e os números de 1 a 12), um cassino de praia em Miami nos anos 80, à noite, com neon rosa e ciano, e um flamingo descolado de terno branco e óculos escuros no papel de anfitrião e crupiê. 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: todas as apostas de uma mesa de roleta numa mesa de 13 casas (pleno, cavalo, rua, quadra, seis linhas, colunas, vermelho/preto, par/ímpar, 1-6/7-12), números da sorte com multiplicadores de ×15 a ×100, a regra de metade de volta no 0, uma bolinha que voa e quica de verdade nos separadores, celebrações de BIG WIN, MEGA WIN e EPIC WIN, apostas rápidas (vizinhos na roleta, apostas favoritas, repetir, dobrar), jogo automático e turbo, níveis do jogador, roda diária, moedas grátis por tempo, missões diárias, 14 idiomas na interface, voz de locutor gravada e música.

Somente 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 jogos 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.

Acerto de um número da sorte: EPIC WIN, moedas caem no saldo
Acerto de um número da sorte: EPIC WIN, moedas caem no saldo

Instalar no seu site

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

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

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 ali: 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/neon-flamingo/" 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) 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 TOQUE PARA JOGAR, escolhe uma ficha na bandeja, toca na mesa para colocá-la e toca em GIRAR. O flamingo crupiê lança a bolinha; quando ela para, o número sobe da sua casa, as fichas perdidas são recolhidas com o rodo e as apostas vencedoras são pagas. Todos os valores são créditos de demonstração fictícios.

A mesa com apostas: pleno, cavalo, quadra, coluna e apostas simples 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16
A mesa com apostas: pleno, cavalo, quadra, coluna e apostas simples
  1. Saldo: os créditos de demonstração grátis
  2. Nível: cresce jogando, dá créditos grátis e libera as fichas maiores
  3. Presentes: moedas grátis, a roleta diária e as missões do dia
  4. Menu: INFO, números, apostas favoritas, jogo automático, turbo, som, tela cheia
  5. A roda: 13 casas; toque num número dela para apostar nele e nos dois vizinhos
  6. Últimos resultados (toque: a página NÚMEROS)
  7. APOSTA: o que está na mesa; depois da rodada, GANHO
  8. A mesa: toque num número, numa linha, num canto ou numa casa de fora para pôr a ficha escolhida
  9. Fichas: escolha o valor; as trancadas abrem em níveis mais altos
  10. Desfazer a última ficha
  11. Limpar a mesa
  12. Repetir: as apostas da última rodada
  13. ×2: dobra todas as apostas
  14. GIRAR (segure: jogo automático)
  15. Turbo liga/desliga
  16. O aviso dos créditos (mantenha visível: SCOPE.md)

As apostas e quanto pagam

Uma aposta que "paga 5 para 1" devolve a ficha mais 5 vezes a ficha.

Aposta Números Paga Onde tocar
Pleno 1 11 para 1 (9 para 1 enquanto os números da sorte estão ligados) um número
Cavalo 2 5 para 1 a linha entre dois números
Rua 3 3 para 1 a linha externa de uma fileira de três
Trio 3 (o 0 e dois números) 3 para 1 o canto onde o 0 encontra dois números
Quadra 4 2 para 1 o ponto onde quatro números se encontram
Primeiros quatro 0, 1, 2, 3 2 para 1 o canto externo do 0 com a primeira fileira
Seis linhas 6 1 para 1 a linha externa entre duas fileiras
Coluna 4 2 para 1 uma caixa 2:1
Vermelho / preto, par / ímpar, 1-6 / 7-12 6 1 para 1 as caixas embaixo da mesa

Mantendo o dedo pressionado na mesa (ou apontando com o mouse), os números que a aposta cobre acendem e aparece uma etiqueta com o nome e o pagamento, antes de a ficha ser colocada. Tocar num número na roleta coloca uma ficha nele e nos seus dois vizinhos na roleta.

  • A regra do 0: quando a bolinha cai no 0, toda aposta perdedora que não cobre o 0 recebe metade das fichas de volta (arredondada para baixo). Essa é a configuração que vem no pacote; rules.zeroRule muda isso.
  • Números da sorte: quando o jogador toca em GIRAR, 2 números acendem com um multiplicador (×15, ×20, ×25, ×50, ×100). Uma ficha em pleno num número da sorte que ganha devolve esse número de vezes a ficha. As outras apostas pagam como sempre.
Depois de GIRAR: dois números da sorte acendem com seus multiplicadores enquanto a bolinha corre
Depois de GIRAR: dois números da sorte acendem com seus multiplicadores enquanto a bolinha corre
O resultado sai da casa da roda; o marcador de cristal pousa no número vencedor
O resultado sai da casa da roda; o marcador de cristal pousa no número vencedor

Apostas rápidas e botões

  • Desfazer, limpar, repetir (as apostas da última rodada) e ×2 (dobra todas as apostas) são os botões redondos ao lado de GIRAR.
  • Apostas favoritas (menu): salve até três arranjos de fichas e coloque um de novo com um toque.
  • Jogo automático: segure GIRAR, ou abra pelo menu, e escolha quantas rodadas. Um toque em GIRAR para o jogo automático.
  • Turbo: o pequeno raio no GIRAR, ou o menu, deixa o lançamento mais curto.

Recompensas fora da mesa

Os níveis (o botão redondo LV) sobem conforme se joga, dão créditos grátis e liberam as fichas maiores. A roda diária dá créditos grátis uma vez por dia (na configuração de demonstração do pacote ela aparece em toda visita). O botão de presente dá moedas grátis a cada poucas horas e mostra três missões diárias sobre experimentar os tipos de aposta. Quando os créditos acabam, é oferecida uma recarga grátis.

A roleta diária (créditos de demonstração grátis) 1 2 3
A roleta diária (créditos de demonstração grátis)
  1. Os prêmios, em créditos de demonstração grátis
  2. Girar a roleta
  3. Depois: volta para a mesa

Informações: PAGAM, REGRAS, NÚMEROS e OPÇÕES

O menu abre a tela de informações com quatro abas: PAGAM (o que cada aposta paga, desenhado numa mesa pequena), REGRAS, NÚMEROS (as estatísticas dos últimos resultados) e OPÇÕES (música, efeitos sonoros, turbo, menos movimento, idioma).

INFO, PAGAM: cada tipo de aposta numa mesinha, com o que paga 1 2 3 4 5 6 7
INFO, PAGAM: cada tipo de aposta numa mesinha, com o que paga
  1. PAGAM
  2. REGRAS
  3. NÚMEROS (estatísticas)
  4. OPÇÕES
  5. Fechar
  6. Onde fica a ficha dessa aposta e os números que ela cobre
  7. O que paga, "para 1" (a ficha também volta)
INFO, NÚMEROS: com que frequência cada número saiu, os últimos resultados, os mais e menos frequentes
INFO, NÚMEROS: com que frequência cada número saiu, os últimos resultados, os mais e menos frequentes
INFO, OPÇÕES: música, efeitos sonoros, turbo, menos movimento e o idioma 1
INFO, OPÇÕES: música, efeitos sonoros, turbo, menos movimento e o idioma
  1. O seletor de idioma
Celular em pé (390 × 844): a roda em cima, a mesa embaixo 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16
Celular em pé (390 × 844): a roda em cima, a mesa embaixo
  1. Saldo: os créditos de demonstração grátis
  2. Nível: cresce jogando, dá créditos grátis e libera as fichas maiores
  3. Presentes: moedas grátis, a roleta diária e as missões do dia
  4. Menu: INFO, números, apostas favoritas, jogo automático, turbo, som, tela cheia
  5. A roda: 13 casas; toque num número dela para apostar nele e nos dois vizinhos
  6. Últimos resultados (toque: a página NÚMEROS)
  7. APOSTA: o que está na mesa; depois da rodada, GANHO
  8. A mesa: toque num número, numa linha, num canto ou numa casa de fora para pôr a ficha escolhida
  9. Fichas: escolha o valor; as trancadas abrem em níveis mais altos
  10. Desfazer a última ficha
  11. Limpar a mesa
  12. Repetir: as apostas da última rodada
  13. ×2: dobra todas as apostas
  14. GIRAR (segure: jogo automático)
  15. Turbo liga/desliga
  16. O aviso dos créditos (mantenha visível: SCOPE.md)

Teclado

Space ou Enter gira. Backspace ou Z tira a última ficha, R coloca as últimas apostas de novo, T liga e desliga o turbo, M liga e desliga o som, e Escape fecha uma janela aberta.

O que vem no pacote

neon-flamingo-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
    neon-flamingo.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           start-up, the round, lucky numbers, the daily wheel and gifts
    src/table/            hud.js, betting.js, celebration.js, input.js (parts of main.js)
    src/config.js         defaults, events, save key
    src/logic/            rules.js (the table), engine.js (bets, credits, return), progress.js, missions.js
    src/ui/               roulette.js (the wheel), spin-sim.js (the ball), board.js (the table), fx, sheets, feel.js, theme.js, styles.css, game.css, i18n.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/, neon-flamingo.config.js (copied to the build as they are)
    tests/                npm test
    tools/                return of every bet, translation check, in-page text check, build formatter
    package.json, package-lock.json, vite.config.js, .prettierrc, README.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 neon-flamingo.config.js na hospedagem.

Configurações (neon-flamingo.config.js)

O game/neon-flamingo.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 com uma mensagem dizendo o que corrigir.

window.NEON_FLAMINGO_CONFIG = {
  brand: { name: 'Neon Flamingo Roulette', storageKey: 'mysite.neon-flamingo' },
  language: 'auto',
  languages: ['en', 'pt', 'es'],
  texts: { tapToPlay: 'PLAY NOW', de: { tapToPlay: 'LOS!' } },
  audio: { volume: 0.8, muted: false },
  ageGate: true,
  notice: true,
  showRtp: true,
  rules: { zeroRule: 'half', lucky: { enabled: true }, chips: [10, 50, 100, 500, 1000], startBalance: 50000, limits: { spot: 5000, table: 25000 } },
  progress: { wheel: { alwaysReady: false, everyHours: 24 }, coins: { everyHours: 3, amount: 50 } },
  winTiers: { big: 5, mega: 12, epic: 25 },
};
Opção O que faz
brand.name nome do jogo usado na página e nas mensagens
brand.storageKey prefixo dos dados salvos no navegador (padrão neon-flamingo.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 OPÇÕES e ?lang=xx no endereço têm prioridade
languages os idiomas oferecidos em OPÇÕES (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
notice o aviso de créditos de uma linha embaixo da mesa. Deixe ligado: o SCOPE.md exige isso em publicações para o público
showRtp mostra o retorno das apostas na aba de regras
debug só para testes: permite ?seed=123 (as mesmas rodadas toda vez) e ?result=7 (a bolinha cai no 7) em qualquer hospedagem
rules a mesa: zeroRule ('half' retorno de cerca de 96,15%, 'evenHalf' só as apostas de 1:1 recebem metade de volta, 'none' a mesa clássica com 92,31%), pays, lucky (enabled, count, straight, mults, weights), chips, startBalance, limits, wheel (a ordem das casas), red. Um pagamento que devolveria mais de 100% é recusado com uma mensagem. Rode npm run rtp depois de mudar
progress níveis (levels.enabled, need, reward, unlock), a roda diária (enabled, alwaysReady, everyHours, prizes, weights), moedas grátis (enabled, everyHours, amount) e missões (enabled, perDay, reward). Os valores são múltiplos da menor ficha
winTiers a partir de quantas vezes os créditos apostados começam as celebrações de BIG WIN, MEGA WIN e EPIC WIN
integration, callbacks eventos para a sua própria página, veja "Eventos"

O arquivo do pacote lista todas as opções com um comentário. Os padrões completos estão em source/src/config.js, source/src/logic/rules.js e source/src/logic/progress.js.

A matemática da mesa

Com as regras que vêm no pacote, o retorno ao jogador de cada aposta fica entre 92,31% (apostas que cobrem o 0) e 96,15% (as outras, graças à regra de metade de volta no 0). Os números da sorte não mudam isso: enquanto estão ligados, uma aposta em pleno paga 9 para 1 em vez de 11 para 1, e os multiplicadores devolvem essa diferença na média. O npm run rtp (em source/) calcula o retorno exato de cada aposta a partir das suas configurações e confere com uma simulação de milhões de rodadas.

As casas em sentido horário na roleta: 0, 7, 2, 9, 4, 12, 6, 1, 8, 3, 10, 5, 11. Vermelhos: 1, 3, 5, 7, 9, 12; os outros seis são pretos e o 0 é verde. A ficha mínima é o primeiro valor de rules.chips (10, 50, 100, 500, 1000 na configuração do pacote); o máximo numa casa é 5.000 e na mesa inteira 25.000 por rodada. Um jogador novo começa com 50.000 créditos de demonstração grátis.

O número é sorteado quando GIRAR é tocado, cada um dos 13 com a mesma chance (ou por ?seed= / ?result= durante os testes). O voo da bolinha é simulado depois, para que ela pare nessa casa: ele só mostra o resultado.

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 (o flamingo anfitrião) e os títulos pintados (BIG WIN, MEGA WIN, EPIC WIN, DAILY WHEEL) ficam em inglês em todos os idiomas. O jogo abre no idioma do aparelho; o jogador pode mudar em OPÇÕES, 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. Uma chave que falta volta para o inglês. Para mudar alguns textos sem refazer o build, use texts no neon-flamingo.config.js. Depois de editar os arquivos de idioma, rode npm run locales para conferir que nenhuma tradução perdeu um marcador {value}.

A mesma rodada em português
A mesma rodada em português

Dados salvos

O jogo guarda o saldo, as apostas na mesa, os últimos resultados, o nível, as missões, as apostas favoritas, as configurações e os contadores de recompensas no localStorage do navegador, com chaves que começam com neon-flamingo.template.save.v1. (por exemplo, neon-flamingo.template.save.v1.balance). Nada é enviado para lugar nenhum. Cada rodada é resolvida no momento em que GIRAR é tocado, então fechar a página no meio de uma rodada não perde nada: a próxima visita mostra quanto ela pagou. 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.

  • callbacks no neon-flamingo.config.js: onReady, onBet({ spot, amount, total }), onSpin(round), onWin(round), onBalance({ balance }), onBonus({ kind, amount, balance }).
  • window.NeonFlamingo.on('spin', fn), window.NeonFlamingo.getBalance(), window.NeonFlamingo.version.
  • Eventos DOM em window: neonflamingo:spin, neonflamingo:win...
  • Com integration: { postMessage: true, targetOrigin: 'https://your-site.example' }, o jogo também envia { source: 'neon-flamingo', type, payload } para a página pai quando roda dentro de um iframe.

round.result é o número, round.spent os créditos de demonstração colocados na rodada, round.payout os créditos de demonstração que ela devolveu, round.lucky os números da sorte da rodada ([{ n, x }]).

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 neon-flamingo.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 e abra de novo o seu terminal (Windows: PowerShell ou Prompt de Comando; macOS: Terminal).
  3. Confira as versões: os dois comandos devem mostrar um número, e o Node deve 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 Explorer, clique na barra de endereço, digite powershell e aperte Enter; macOS: arraste a pasta para 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 testes do motor (apostas, pagamentos, a regra do 0, números da sorte, créditos, retorno) e confere que a bolinha sempre cai onde a rodada diz. Todos devem passar.
  • npm run dev abre uma prévia local em http://localhost:5220/ que recarrega quando você salva um arquivo. Aperte Ctrl+C para parar. Na prévia, ?result=7 faz a bolinha cair no 7 e ?lucky=7x50 escolhe os números da sorte.
  • 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 retorno exato de cada aposta da sua mesa (src/logic/rules.js mais as rules do public/neon-flamingo.config.js) e uma simulação de milhões de rodadas.
  • npm run locales confere as traduções.
  • npm run format formata o projeto inteiro com o Prettier.
  • tools/qa-fit.js é uma verificação dentro da página para a prévia: no console do navegador, (await import('/tools/qa-fit.js')).check() lista todo texto que não cabe na sua placa.

Problemas comuns

  • node ou npm não é reconhecido: o Node.js não está instalado ou o terminal foi aberto antes da instalação. Instale de novo e abra um terminal novo.
  • O Windows diz que a execução de scripts está desativada (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 depois o npm ci volta a funcionar.
  • A porta 5220 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: trocar o fundo, o logo, o crupiê, as fichas, os sons e a música, as cores, os textos, as regras da mesa e as recompensas. Em resumo:

  • Arte: source/public/art/ (ou game/art/ na hospedagem). Troque um arquivo por outro WebP com o mesmo nome e o mesmo tamanho.
  • Sons: source/public/audio/ (ou game/audio/). Troque um MP3 por outro com o mesmo nome.
  • A roleta: as casas e os números são desenhados por código (source/src/ui/roulette.js), então sempre seguem rules.wheel e rules.red; o aro dourado e a torre do centro são arte (rim.webp 900 × 900, hub.webp 420 × 420).
  • Tempos e efeitos: source/src/ui/feel.js (quanto dura cada parte de uma rodada, câmera lenta, tremidas, moedas) e source/src/ui/theme.js (cores do brilho e dos raios). Só apresentação: nada ali muda um resultado.
  • Layout e estilos: source/src/ui/styles.css (a estrutura comum) e game.css (a mesa da roleta).
  • Textos: texts no neon-flamingo.config.js ou source/src/locales/.
  • Regras da mesa: rules no neon-flamingo.config.js ou source/src/logic/rules.js, depois npm run rtp.

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

Nomes internos

Parte do código é compartilhada com outros jogos da mesma família, então alguns nomes descrevem outra coisa do que dizem. São apenas nomes:

Nome no código O que é
SLOTS, slot, slotOf() uma casa da roda: SLOTS = 13 casas, slot = a posição de uma casa na roda, no sentido horário (não é máquina caça-níquel)
jackpot (src/ui/wheel.js) a fatia dourada da roleta diária: o prêmio maior dela, em créditos de demonstração grátis
fx.snow, THEME.ambient as partículas de neon ciano que sobem no ar da noite (THEME.ambient.rise = true)
fx.frost() um efeito do código compartilhado que este jogo não usa
.entry-cta, .entry-logo, .entry-mascot a tela de abertura: TAP TO PLAY, o logo e o flamingo anfitrião
CreditBank, round.spent, round.payout os créditos fictícios de demonstração: o que uma rodada recebeu e devolveu (sem dinheiro)

Atualizar o jogo e limpar o cache

Depois de enviar uma versão nova, navegadores e hospedagens podem manter 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 não ser que queira zerar o jogo salvo.
  • Teste numa janela anônima.
  • Se a sua hospedagem ou CDN (por exemplo, a Cloudflare) tem cache, limpe-o.
  • 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 é)

  • Somente créditos de demonstração gratuitos e fictícios, sem valor monetário. Eles não podem ser comprados, transferidos, vendidos nem resgatados. Nenhum tipo de prêmio.
  • Nenhum sistema de pagamento, depósito, saque, conta ou carteira: nenhum está escondido, desligado ou incluído no pacote.
  • A licença padrão não permite usar este jogo, nem qualquer versão modificada dele, para jogos de azar com dinheiro real ou com qualquer coisa de valor real: nada de comprar créditos, nada de sacar, nada de prêmios baseados em resultados, nenhuma conexão com carteira de apostas, sistema de pagamento ou operador de dinheiro real, nenhuma publicidade de jogos 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 é o SCOPE.md.

Perguntas e problemas

  • A página fica em branco. Confira se você enviou o conteúdo de game/ (com modules/ e assets/) e se está abrindo por http(s), não por file://. O console do navegador (F12) mostra o arquivo que falta.
  • Sem som. Os navegadores só permitem som depois de um toque: o jogo liga o som em TOQUE PARA JOGAR. Confira o menu (botão de som), as OPÇÕES (música, efeitos sonoros) e o volume do aparelho. Se o celular cortar o som (uma ligação, outro app), o próximo toque traz o som de volta.
  • Posso mudar o retorno? Sim: rules.zeroRule, rules.pays e rules.lucky; o npm run rtp mede a sua mesa, e uma configuração que devolveria mais de 100% é recusada.
  • Posso jogar a mesa clássica sem números da sorte? Sim: rules: { lucky: { enabled: false } } (o pleno paga 11 para 1). zeroRule: 'none' tira a regra de metade de volta.
  • 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 sem internet? Depois de carregado, sim; ele não precisa de nenhum outro site.
  • Posso tirar o aviso de créditos? Numa publicação para o público ele precisa continuar visível (veja o SCOPE.md).
  • A roda diária abre em toda visita. Essa é a configuração de demonstração alwaysReady: true; defina progress: { wheel: { alwaysReady: false } }.
  • Como mostro um resultado escolhido? Na prévia local, ou com debug: true durante os testes, acrescente ?result=7 (e ?lucky=7x50) ao endereço.

Suporte e créditos

E-mail de suporte: willian@polargames.com.br (erros, 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 de terceiros vai em game/. Arte, música, voz e efeitos fazem parte do jogo e estão cobertos pela licença da sua compra.