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
.jse.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:
-
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. -
Em
source/e com build (precisa do Node.js, veja o guia principal): mude arquivos emsource/, rodenpm run builde enviesource/dist/. Use esta forma para código, estilos,theme.js,engine.jse traduções.
Depois de cada envio, recarregue o jogo sem o cache (Ctrl+F5, ou Cmd+Shift+R no Mac).
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
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
|
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
Receita 1: trocar os fundos
-
bg-landscape.webp(1672 × 940) é usado em computadores, tablets e celulares deitados;bg-portrait.webp(941 × 1672), em celulares em pé. - 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.
-
Salve em WebP com os mesmos nomes e substitua os arquivos em
game/art/(e emsource/public/art/, para manter o código-fonte igual). - Recarregue sem o cache.
Receita 2: o logo e o apresentador
-
O logo é
logo.webp(1000 × 554, fundo transparente). Ele aparece na tela de título e no pódio. Mantenha uma proporção parecida entre largura e altura para ele caber nos mesmos lugares. -
O apresentador tem cinco poses de 670 × 900 com fundo transparente:
mascot-idle(esperando),mascot-hope(a roda está desacelerando),mascot-pull(girando),mascot-cheer(um ganho, a roda de bônus, comemorações) emascot-aww(uma perda). O jogo troca uma pose pela outra no mesmo lugar, então desenhe as cinco com o mesmo enquadramento (mesmo tamanho e mesma posição do corpo); senão, o apresentador pula de uma pose para a outra. - O pódio (
podium.webp, 600 × 501) fica na frente do apresentador no computador. -
Para mudar o nome do jogo, defina
brand: { name: 'My Show' }nosaloon-showdown.config.jse mude o<title>noindex.html.
Receita 3: a aparência da roda
-
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 emsource/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). -
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 emsource/src/ui/theme.js(wedge:1: 'cream',2: 'blue',mult: 'gold'...). A roda de bônus usabonusWedgesem sequência, com o maior valor sempre dourado. -
O centro, os pinos, o ponteiro e a base são
wheel-hub,wheel-peg,wheel-pointerewheel-stand. Mantenha as proporções deles. -
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 5: sons, voz e música
-
Cada som é um MP3 em
game/audio/(com os mesmos nomes emsource/public/audio/). Substitua um arquivo por outro MP3 com o mesmo nome; efeitos curtos devem continuar curtos (menos de 2 segundos). -
Música:
music.mp3(a mesa) emusic-bonus.mp3(a roda de bônus e os grandes ganhos). Elas tocam em loop, com uma transição suave entre uma e outra. -
Locutor:
v-bets,v-nomore,v-x2,v-x7,v-bonus,v-big,v-mega,v-epic. -
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. -
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
FILESno início desource/src/audio/audio.jse gere o build (um nome da lista sem o arquivo seria pedido e daria erro). O volume inicial éaudio: { volume: 0.8 }nosaloon-showdown.config.js.
Receita 6: cores dos efeitos e da tela
-
Em
source/src/ui/theme.js, mudeaccent(anéis, faíscas, reflexos),gold,ruby,bulbs(as luzes do aro),tierRays(raios de luz das comemorações BIG, MEGA e EPIC) eambient. As cores são escritas como'#ffd36a'ou[255, 214, 120]. -
A paleta da interface fica no topo de
source/src/ui/styles.css(as variáveis--gold-1...--panel-2). -
Os tempos (quanto tempo a roda gira, a mola do ponteiro, as comemorações) ficam em
source/src/ui/feel.js. -
Rode
npm run builde enviedist/. Nada nesses arquivos muda um resultado ou um pagamento.
Receita 7: textos e idiomas
-
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 desource/src/locales/en.js. -
Para oferecer só alguns idiomas:
languages: ['en', 'es']. Para abrir sempre em um:language: 'es'. -
Para editar uma tradução inteira, mude
source/src/locales/<code>.js, rodenpm run localesenpm run build. -
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. paysdiz 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: nulltira 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) emaxTotal(20.000, na mesa): os limites da mesa. Cada ficha precisa valer no máximomaxSpot. 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: trueoferece o giro em toda visita (para uma página de demonstração);enabled: falsedesliga o giro. coins: { everyHours: 3, amount: 50 }: as moedas grátis do botão de presente.-
winTiers: { big: 10, mega: 25, epic: 50 }(fora deprogress): quando as comemorações começam.
Receita 11: publicar a sua versão
- Se você mudou só arquivos de
game/na hospedagem, terminou: recarregue sem o cache. -
Se você mudou
source/: rodenpm test, depoisnpm run build, e envie o conteúdo desource/dist/por cima da pasta do jogo. -
Mantenha o
SCOPE.mdjunto com o jogo e o aviso de créditos visível. Mude obrand.storageKeyse quiser que os jogadores comecem com dados salvos novos.