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 imagens 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 uma cópia de segurança antes: copie a pasta inteira do pacote antes de mudar qualquer coisa.
Há dois jeitos de mudar o jogo:
-
Direto na hospedagem (sem ferramentas): troque arquivos na pasta
game/que você enviou (arte, áudio,big-top.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 este jeito para código, estilos,theme.js,feel.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
16
- Saldo: os créditos de demonstração grátis
- Nível: cresce jogando, dá créditos grátis e libera as fichas maiores
- Presentes: moedas grátis, a roleta diária e as missões do dia
- Menu: INFO, números, apostas favoritas, jogo automático, turbo, som, tela cheia
- A roda: 13 casas; toque num número dela para apostar nele e nos dois vizinhos
- Últimos resultados (toque: a página NÚMEROS)
- APOSTA: o que está na mesa; depois da rodada, GANHO
- A mesa: toque num número, numa linha, num canto ou numa casa de fora para pôr a ficha escolhida
- Fichas: escolha o valor; as trancadas abrem em níveis mais altos
- Desfazer a última ficha
- Limpar a mesa
- Repetir: as apostas da última rodada
- ×2: dobra todas as apostas
- GIRAR (segure: jogo automático)
- Turbo liga/desliga
- O aviso dos créditos (mantenha visível:
SCOPE.md)
Qual arquivo é cada parte da tela
| Na tela | Arquivo (em game/, com o mesmo nome em source/public/) |
|---|---|
| Fundo (horizontal / vertical) | art/bg-landscape.webp, art/bg-portrait.webp |
| Logo | art/logo.webp |
| Crupiê (o leão mestre de picadeiro) |
art/mascot-idle.webp, art/mascot-watch.webp,
art/mascot-hype.webp, art/mascot-cheer.webp
|
| Roleta: aro dourado com a pista da bolinha / torre no centro |
art/rim.webp / art/hub.webp (as casas e os números são desenhados por
código)
|
| Moldura em volta da mesa | art/frame.webp |
| Fichas: na bandeja / na mesa e no ar |
art/chip-0.webp ... art/chip-5.webp / art/chip3d-0.webp ...
art/chip3d-5.webp
|
| Bandeja de fichas | art/tray.webp |
| Marcador de cristal no número vencedor | art/dolly.webp |
| O rodo do crupiê | art/rake-head.webp, art/rake-handle.webp |
| Botão GIRAR | art/spin.webp |
| Botões dourados / pílulas / placas / botões redondos |
art/btn-gold.webp, art/pill.webp, art/plaque.webp,
art/btn-blank.webp, art/btn-close.webp
|
| Ícones (menu, informações, som, tela cheia, presente, desfazer, limpar, repetir, automático, favoritas, turbo...) | art/icon-*.webp |
| Títulos das celebrações (BIG WIN, MEGA WIN, EPIC WIN) |
art/title-big.webp, art/title-mega.webp, art/title-epic.webp,
faixa art/banner.webp
|
| Roda diária |
art/wheel.webp, art/wheel-hub.webp, art/wheel-pointer.webp,
art/title-wheel.webp, pilhas de moedas art/pile-0..2.webp
|
| Números pintados: dourados (valores) / marfim (mesa, roleta, resultados) |
art/font-gold.webp + .json / art/font-board.webp +
.json
|
| Moedas e brilhos | art/coin.webp, art/burst.webp, art/shard-0..5.webp |
| Textos | source/src/locales/*.js ou texts no big-top.config.js |
| Cores dos efeitos | source/src/ui/theme.js |
| Tempos da sensação do jogo | source/src/ui/feel.js |
| Layout, tamanhos, paleta |
source/src/ui/styles.css (estrutura comum) e source/src/ui/game.css (a
mesa da roleta)
|
Receita 1: trocar os fundos
-
bg-landscape.webptem 1672 × 941 (computador e celular deitado),bg-portrait.webptem 941 × 1672 (celular em pé). - Deixe a parte importante da imagem no meio: as bordas são cortadas em telas de outros formatos. Deixe a parte de baixo tranquila: a mesa e a roleta ficam ali.
- Salve em WebP com os mesmos nomes e substitua os arquivos.
Receita 2: o logo e o crupiê
-
O logo é
logo.webp(1744 × 866, fundo transparente). Mantenha uma proporção parecida entre largura e altura para ele caber no mesmo lugar. -
O crupiê tem quatro poses de 720 × 1100 com fundo transparente:
mascot-idle(esperando),mascot-hype(lançando a bolinha, na tela de abertura),mascot-watch(acompanhando a bolinha) emascot-cheer(ganhos). Troque as quatro pelo mesmo personagem, parado no mesmo lugar da imagem, para as poses trocarem sem pulo. -
Para mudar o nome do jogo, defina também
brand: { name: 'My Game' }nobig-top.config.jse o<title>noindex.html.
Receita 3: a roleta
-
As 13 casas, as cores e os números são desenhados pelo jogo, então sempre combinam com as
regras. Só o aro dourado (
rim.webp, 900 × 900, transparente no meio) e a torre do centro (hub.webp, 420 × 420) são imagens. Mantenha os tamanhos e mantenha a pista da bolinha do aro no mesmo lugar: a bolinha corre nela. -
A ordem dos números na roleta e quais são vermelhos são configurações, não arte:
rules: { wheel: [...], red: [...] }nobig-top.config.js(a ordem do pacote é 0, 7, 2, 9, 4, 12, 6, 1, 8, 3, 10, 5, 11; vermelhos: 1, 3, 5, 7, 9, 12). -
As cores das casas estão em
source/src/ui/roulette.js(a listainkno começo debuildRotor); o brilho da casa vencedora é oglowemsource/src/ui/theme.js.
Receita 4: as fichas
-
Cada valor de ficha tem duas imagens com o mesmo número:
chip-N.webp(160 × 160, vista de cima, na bandeja) echip3d-N.webp(a mesma ficha vista no ângulo da mesa, com a lateral listrada, na mesa e no ar). A ficha 0 é o menor valor; a mesa do pacote usa cinco valores (10, 50, 100, 500, 1000), entãochip-5é a cor de um sexto valor, se você acrescentar um. -
Os valores ficam em
rules.chipsnobig-top.config.js(de 1 a 6 valores, do menor para o maior). Use valores pares: as metades no 0 são arredondadas para baixo. - Desenhe o valor na ficha ou deixe em branco: o jogo escreve o valor nela.
Receita 6: sons, voz e música
-
Cada som é um MP3 em
game/audio/(com os mesmos nomes emsource/public/audio/). Troque um arquivo por outro MP3 com o mesmo nome; efeitos curtos devem ser curtos (menos de 2 segundos). -
Música:
music.mp3(a mesa) emusic-wheel.mp3(a roda diária). Elas tocam em repetição. -
Locutor:
v-place(façam suas apostas),v-nomore(apostas encerradas),v-n0av-n12(o resultado),v-luckyev-luckyhit(números da sorte),v-big,v-mega,v-epic. -
Efeitos: a bolinha (
launch,ball-roll,ball-ting,ball-tock,ball-settle,whoosh), as fichas (chip,chip-stack,chips-rake,chips-pay,dolly), os ganhos (win,bigwin,coin,coinrain,count,shatter,levelup), os números da sorte (lucky-strike,lucky-hit), a roda diária e os presentes (wheel-tick,drumroll,wheel-win,collect), eclick,nope. -
Se faltar um arquivo, o jogo toca no lugar um som sintetizado embutido, então nunca quebra. O volume
inicial é
audio: { volume: 0.8 }nobig-top.config.js.
Receita 7: cores, efeitos e tempos
-
Em
source/src/ui/theme.js, mudeaccent(anéis e faíscas),gold,glow(a casa e a célula vencedoras),tierRays(raios de luz das celebrações) eambient(a poeira dourada que sobe na luz do letreiro). As cores são escritas como'#ffd76a'ou[255, 214, 110]. -
Em
source/src/ui/feel.js, cada tempo de uma rodada tem um nome e um comentário: a velocidade com que as fichas voam, quanto dura a câmera lenta do quique decisivo, o replay de um EPIC WIN, o rodo, as torres de pagamento, a contagem da celebração. Números menores deixam a rodada mais rápida. -
A paleta da interface fica no começo de
source/src/ui/styles.css(as variáveis--). -
Rode
npm run builde enviedist/. Nada nesses arquivos muda um resultado ou um pagamento.
Receita 8: textos e idiomas
-
Para mudar alguns textos na hospedagem, acrescente-os ao
big-top.config.js:texts: { tapToPlay: 'PLAY NOW' }muda todos os idiomas;texts: { pt: { tapToPlay: 'JOGAR' } }muda só o 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 num só:language: 'es'. -
Para editar uma tradução inteira, mude
source/src/locales/<code>.js, rodenpm run localesenpm run build.
Receita 9: as regras da mesa e os créditos iniciais
No big-top.config.js, dentro de rules: { }:
-
zeroRule:'half'(as apostas perdedoras que não cobrem o 0 recebem metade de volta quando a bolinha cai no 0),'evenHalf'(só as apostas de 1:1 recebem) ou'none'(a mesa clássica). -
lucky: { enabled: false }joga sem números da sorte (o pleno paga 11 para 1);count,multseweightsmudam quantos são e de quanto. -
paysmuda o que um tipo de aposta paga;startBalance, os créditos de um jogador novo;limits, o máximo numa casa e na mesa. -
Depois de uma mudança, rode
npm run rtpemsource/para ver o retorno de cada aposta. Uma configuração que devolveria mais de 100% é recusada com uma mensagem.
São somente créditos de demonstração fictícios.
Receita 10: níveis, roda diária, moedas grátis e missões
No big-top.config.js, dentro de progress: { }:
-
wheel: { alwaysReady: false, everyHours: 24 }oferece a roda uma vez por dia (a demonstração oferece em toda visita);prizeseweightsdefinem as fatias. coins: { everyHours: 3, amount: 50 }define o botão de presente.-
missions: { enabled: false }desliga as missões diárias;perDayerewardmudam as missões. -
levels: { enabled: false }desliga os níveis (todas as fichas liberadas desde o início);unlockdiz em qual nível cada ficha é liberada.
Os valores são múltiplos da menor ficha.
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.