Saloon Showdown 1.0.0: guia de personalização

Receitas passo a passo para trocar arte, sons, textos, a roda e os ajustes, sem programar.

Guia principal do comprador

EnglishPortuguêsEspañol

Antes de começar

Este guia é para quem não programa. Cada receita diz qual arquivo abrir e o que mudar. Você precisa de:

  • um editor de texto (Visual Studio Code, Notepad++, TextEdit no modo de texto simples) para os arquivos .js e .css;
  • um editor de imagem que salve em WebP (GIMP, Photopea no navegador, Krita) para a arte;
  • um editor de áudio que salve em MP3 (Audacity) para os sons.

Faça um backup antes: copie a pasta inteira do pacote antes de mudar qualquer coisa.

Há duas formas de mudar o jogo:

  1. Direto na hospedagem (sem ferramentas): substitua arquivos na pasta game/ que você enviou (arte, áudio, saloon-showdown.config.js). É rápido, mas essas mudanças ficam só na hospedagem.
  2. Em source/ e com build (precisa do Node.js, veja o guia principal): mude arquivos em source/, rode npm run build e envie source/dist/. Use esta forma para código, estilos, theme.js, engine.js e traduções.

Depois de cada envio, recarregue o jogo sem o cache (Ctrl+F5, ou Cmd+Shift+R no Mac).

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

Qual arquivo é cada parte da tela

Os tamanhos são medidos nos arquivos do pacote (largura × altura em pixels).

Na tela Arquivo (em game/art/, com o mesmo nome em source/public/art/) Tamanho
Fundo: computador e celular deitado / celular em pé bg-landscape.webp / bg-portrait.webp 1672 × 940 / 941 × 1672
Fundo da tela de abertura, deitado / em pé, e o palco do bônus bg-entry-wide.webp / bg-entry.webp 1672 × 941 / 941 × 1672
O apresentador na abertura (inteiro, do chapéu às botas) mascot-entry.webp 586 × 1100
Moldura da barra de carregamento load-bar.webp 900 × 134
Aro da roda de bônus (lâmpadas acesas) wheel-rim-bonus.webp 1024 × 1024
Janela de regras: moldura / placa do título / cartões das opções / corda / deserto / enfeite do rodapé sheet-frame.webp / header-plaque.webp / opt-card.webp / rope-divider.webp / desert.webp / ornament.webp 900 × 1364 / 900 × 220 / 900 × 214
Logo (tela de título e pódio) logo.webp 1000 × 554
As cinco poses do apresentador mascot-idle.webp, mascot-hope.webp, mascot-pull.webp, mascot-cheer.webp, mascot-aww.webp 670 × 900 cada
O pódio do apresentador (computador) podium.webp 600 × 501
Aro da roda com lâmpadas / centro / pinos wheel-rim.webp / wheel-hub.webp / wheel-peg.webp 1024 × 1024 / 320 × 320 / 96 × 96
Ponteiro da roda (lingueta) / base wheel-pointer.webp / wheel-stand.webp 151 × 260 / 900 × 248
Materiais das fatias (texturas contínuas) mat-cream.webp, mat-blue.webp, mat-ruby.webp, mat-gold.webp 1024 × 1024 cada
Fatia BONUS e apostas com figura emblem-bonus.webp, emblem-crown.webp, emblem-star.webp / palavra pintada word-bonus.webp 192 × 192 / 640 × 159
Números pintados (roda, mesa, prêmios) font-gold.webp + font-gold.json 1609 × 128
Moldura da mesa de apostas / casas de aposta board.webp / tile-cream.webp, tile-blue.webp, tile-ruby.webp, tile-gold.webp 1200 × 683 / 520 × 153
Faixa de status / placas de saldo e de nível ribbon.webp / plaque.webp 900 × 278 / 560 × 124
Botões verde-água em forma de pílula (arquivo chamado blue) / botões dourados / placa de prêmio pill-blue.webp / btn-gold.webp / prize-plate.webp 520 × 214 / 700 × 193 / 900 × 259
Botão SPIN / botão redondo btn-spin.webp / btn-round.webp 360 × 360 / 160 × 160
Fichas (da menor para a maior) chip-0.webp ... chip-4.webp 160 × 160 cada
Moedas / selo do resultado / marcadores do histórico coin.webp / seal.webp / token-cream.webp, token-blue.webp, token-ruby.webp, token-gold.webp 128 × 128 / 320 × 320 / 96 × 96
Ícones (presente, menu, regras, som, mudo, tela cheia, estrela) icon-*.webp 128 × 128
Títulos pintados (BONUS ROUND, FREE SPIN, BIG/MEGA/EPIC WIN) title-bonus.webp, title-daily.webp, title-big.webp, title-mega.webp, title-epic.webp 1000 × 305 (bônus)
Textos source/src/locales/*.js ou texts no saloon-showdown.config.js
Cores, materiais das fatias, raios de luz source/src/ui/theme.js
Layout, tamanhos, paleta source/src/ui/styles.css (variáveis da paleta no topo)
A roda, os pagamentos dela, fichas e limites math no saloon-showdown.config.js, ou source/src/logic/engine.js
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

Receita 1: trocar os fundos

  1. bg-landscape.webp (1672 × 940) é usado em computadores, tablets e celulares deitados; bg-portrait.webp (941 × 1672), em celulares em pé.
  2. Deixe a parte importante da imagem no meio: as bordas são cortadas em telas de outros formatos. Deixe o centro calmo para a roda se destacar.
  3. Salve em WebP com os mesmos nomes e substitua os arquivos em game/art/ (e em source/public/art/, para manter o código-fonte igual).
  4. Recarregue sem o cache.

Receita 3: a aparência da roda

  1. O aro com as lâmpadas é wheel-rim.webp (1024 × 1024, um quadrado com o meio transparente). As fatias são desenhadas dentro do círculo interno dele; esse círculo é medido em source/src/ui/art.js (wheel.face, uma fração do raio da imagem). Um aro novo com o círculo interno mais largo ou mais estreito precisa que esse número seja mudado (e um build novo).
  2. As fatias são preenchidas com as quatro texturas contínuas mat-cream, mat-blue, mat-ruby, mat-gold (1024 × 1024). Qual número recebe qual material é definido em source/src/ui/theme.js (wedge: 1: 'cream', 2: 'blue', mult: 'gold'...). A roda de bônus usa bonusWedges em sequência, com o maior valor sempre dourado.
  3. O centro, os pinos, o ponteiro e a base são wheel-hub, wheel-peg, wheel-pointer e wheel-stand. Mantenha as proporções deles.
  4. Os números na roda são escritos com a fonte pintada (font-gold.webp + font-gold.json): ela tem só 0-9 x K M + , .. Para redesenhá-la, mantenha os mesmos caracteres; o JSON lista o x e a largura de cada caractere na imagem.

Receita 4: placas, botões e fichas

Placas e botões são esticados com as pontas decoradas mantidas intactas ("9-slice", 9 pedaços). Quando redesenhar board.webp, tile-*.webp, ribbon.webp, plaque.webp, pill-blue.webp, btn-gold.webp ou prize-plate.webp, mantenha o mesmo tamanho de imagem e a mesma largura da borda decorada, e deixe o meio liso: o jogo escreve o texto ali. Se uma placa nova tiver a borda mais grossa ou mais fina, mude os números dela tanto em source/src/ui/plates.css (corte do border-image) quanto em source/src/ui/art.js (cut e glass, a área lisa onde o texto pode ficar) e depois gere o build.

As fichas são chip-0.webp a chip-4.webp (160 × 160), com o menor valor primeiro; o valor é escrito nelas pelo jogo.

Receita 5: sons, voz e música

  1. Cada som é um MP3 em game/audio/ (com os mesmos nomes em source/public/audio/). Substitua um arquivo por outro MP3 com o mesmo nome; efeitos curtos devem continuar curtos (menos de 2 segundos).
  2. Música: music.mp3 (a mesa) e music-bonus.mp3 (a roda de bônus e os grandes ganhos). Elas tocam em loop, com uma transição suave entre uma e outra.
  3. Locutor: v-bets, v-nomore, v-x2, v-x7, v-bonus, v-big, v-mega, v-epic.
  4. Efeitos: coin, chip, chips, sweep, spin, peg, stop, stopSpecial, win, bigwin, stamp, bonus, line, count, click, nope, collect, wheel-win, levelup, coinrain, drumroll, applause, aww.
  5. Se faltar um arquivo, o jogo toca no lugar um som sintetizado embutido, então ele nunca quebra. Para acrescentar um nome de arquivo novo, coloque-o na lista FILES no início de source/src/audio/audio.js e gere o build (um nome da lista sem o arquivo seria pedido e daria erro). O volume inicial é audio: { volume: 0.8 } no saloon-showdown.config.js.

Receita 6: cores dos efeitos e da tela

  1. Em source/src/ui/theme.js, mude accent (anéis, faíscas, reflexos), gold, ruby, bulbs (as luzes do aro), tierRays (raios de luz das comemorações BIG, MEGA e EPIC) e ambient. As cores são escritas como '#ffd36a' ou [255, 214, 120].
  2. A paleta da interface fica no topo de source/src/ui/styles.css (as variáveis --gold-1 ... --panel-2).
  3. Os tempos (quanto tempo a roda gira, a mola do ponteiro, as comemorações) ficam em source/src/ui/feel.js.
  4. Rode npm run build e envie dist/. Nada nesses arquivos muda um resultado ou um pagamento.

Receita 7: textos e idiomas

  1. Para mudar alguns textos na hospedagem, coloque-os no saloon-showdown.config.js: texts: { tapToPlay: 'PLAY NOW' } muda em todos os idiomas; texts: { pt: { tapToPlay: 'JOGAR' } }, só em português. Os nomes (tapToPlay, placeBets...) são as chaves de source/src/locales/en.js.
  2. Para oferecer só alguns idiomas: languages: ['en', 'es']. Para abrir sempre em um: language: 'es'.
  3. Para editar uma tradução inteira, mude source/src/locales/<code>.js, rode npm run locales e npm run build.
  4. Os títulos pintados (BONUS ROUND, FREE SPIN, BIG/MEGA/EPIC WIN) são imagens (title-*.webp): para traduzi-los, substitua as imagens.

Receita 8: a roda e os pagamentos dela

O jeito fácil

Escolha uma das 6 rodas prontas com math: { preset: 'party' } no saloon-showdown.config.js (studio, party, grand, polar, show, classic; veja a tabela no guia principal). Sem refazer o build.

A sua própria roda

Também no saloon-showdown.config.js: math: { wheel: { order: [...], pays: {...} } }.

  • order é a lista de fatias em sentido horário a partir do ponteiro: números ('1', '2', '5'...), multiplicadores ('x2', 'x7': a roda gira de novo) e '@bonus' (a roda de bônus). Todas as fatias têm a mesma chance, então um número que está em mais fatias ganha com mais frequência.
  • pays diz quanto cada número paga para 1: { 1: 1, 2: 2, 5: 5, 10: 10 }.
  • maxRespins: quantos x2/x7 seguidos no máximo (9 na roda padrão). bonus: { order: ['5x', '10x', ...] } define a roda de bônus; bonus: null tira a roda de bônus.

Conferir

Salve e, em source/, rode npm run rtp: ele lê o arquivo de configuração e mostra o RTP de cada aposta. O jogo recusa uma roda em que alguma aposta devolveria 100% ou mais, uma roda com menos de 6 fatias ou com tantas fatias que os números ficariam menores que 13 px num celular (59 fatias com os números padrão), e diz o porquê na primeira tela. Com a sua própria roda, a lista de rodas em OPTIONS fica escondida (os jogadores não conseguiriam voltar para a sua).

window.SALOON_SHOWDOWN_CONFIG = {
  math: {
    wheel: {
      order: ['@bonus', '1', '2', '1', '5', '1', '2', 'x2', '1', '2', '1', '10', '1', '2', '1', '5'],
      pays: { 1: 1, 2: 2, 5: 5, 10: 10 },
    },
  },
};

São apenas créditos de demonstração fictícios.

Receita 9: fichas, limites e créditos iniciais

No saloon-showdown.config.js, dentro de math: { }:

  • startBalance (100.000): os créditos de um jogador novo (e de uma recarga).
  • chips (10, 50, 100, 500, 1.000): até 5 valores de ficha, o menor primeiro (há 5 imagens de ficha).
  • minTotal (10), maxSpot (5.000, numa casa) e maxTotal (20.000, na mesa): os limites da mesa. Cada ficha precisa valer no máximo maxSpot.
  • maxWin (5.000): uma rodada nunca paga mais que esse número de vezes a aposta total.

Um valor errado interrompe o jogo na primeira tela com uma mensagem dizendo o que corrigir.

Receita 10: níveis, o giro grátis diário e moedas grátis

No saloon-showdown.config.js, dentro de progress: { } (os valores são múltiplos da menor ficha):

  • levels: { enabled: false } desliga os níveis (todas as fichas liberadas desde o início). unlock: [1, 1, 1, 3, 6] é o nível que libera cada ficha; reward, o presente ao subir de nível.
  • daily: { everyHours: 24, stake: 10 }: o giro grátis diário da roda de bônus (prêmio = o multiplicador dela × stake × a menor ficha). alwaysReady: true oferece o giro em toda visita (para uma página de demonstração); enabled: false desliga o giro.
  • coins: { everyHours: 3, amount: 50 }: as moedas grátis do botão de presente.
  • winTiers: { big: 10, mega: 25, epic: 50 } (fora de progress): quando as comemorações começam.

Receita 11: publicar a sua versão

  1. Se você mudou só arquivos de game/ na hospedagem, terminou: recarregue sem o cache.
  2. Se você mudou source/: rode npm test, depois npm run build, e envie o conteúdo de source/dist/ por cima da pasta do jogo.
  3. Mantenha o SCOPE.md junto com o jogo e o aviso de créditos visível. Mude o brand.storageKey se quiser que os jogadores comecem com dados salvos novos.