Big Top Roulette 1.0.0: guia de personalização

Receitas passo a passo para trocar arte, sons, textos e 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 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:

  1. 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.
  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 este jeito para código, estilos, theme.js, feel.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 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)

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

  1. bg-landscape.webp tem 1672 × 941 (computador e celular deitado), bg-portrait.webp tem 941 × 1672 (celular em pé).
  2. 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.
  3. Salve em WebP com os mesmos nomes e substitua os arquivos.

Receita 3: a roleta

  1. 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.
  2. A ordem dos números na roleta e quais são vermelhos são configurações, não arte: rules: { wheel: [...], red: [...] } no big-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).
  3. As cores das casas estão em source/src/ui/roulette.js (a lista ink no começo de buildRotor); o brilho da casa vencedora é o glow em source/src/ui/theme.js.

Receita 4: as fichas

  1. Cada valor de ficha tem duas imagens com o mesmo número: chip-N.webp (160 × 160, vista de cima, na bandeja) e chip3d-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ão chip-5 é a cor de um sexto valor, se você acrescentar um.
  2. Os valores ficam em rules.chips no big-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.
  3. Desenhe o valor na ficha ou deixe em branco: o jogo escreve o valor nela.

Receita 5: botões e placas

Botões e placas são esticados mantendo as duas pontas intactas ("9 pedaços", em inglês "9-slice"). Ao redesenhar btn-gold.webp, pill.webp, plaque.webp ou frame.webp, mantenha o mesmo tamanho de imagem e a mesma largura das pontas decoradas, senão as pontas esticam. As medidas de corte estão nas folhas de estilo (border-image), se você precisar mudá-las.

Receita 6: sons, voz e música

  1. Cada som é um MP3 em game/audio/ (com os mesmos nomes em source/public/audio/). Troque um arquivo por outro MP3 com o mesmo nome; efeitos curtos devem ser curtos (menos de 2 segundos).
  2. Música: music.mp3 (a mesa) e music-wheel.mp3 (a roda diária). Elas tocam em repetição.
  3. Locutor: v-place (façam suas apostas), v-nomore (apostas encerradas), v-n0 a v-n12 (o resultado), v-lucky e v-luckyhit (números da sorte), v-big, v-mega, v-epic.
  4. 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), e click, nope.
  5. Se faltar um arquivo, o jogo toca no lugar um som sintetizado embutido, então nunca quebra. O volume inicial é audio: { volume: 0.8 } no big-top.config.js.

Receita 7: cores, efeitos e tempos

  1. Em source/src/ui/theme.js, mude accent (anéis e faíscas), gold, glow (a casa e a célula vencedoras), tierRays (raios de luz das celebrações) e ambient (a poeira dourada que sobe na luz do letreiro). As cores são escritas como '#ffd76a' ou [255, 214, 110].
  2. 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.
  3. A paleta da interface fica no começo de source/src/ui/styles.css (as variáveis --).
  4. Rode npm run build e envie dist/. Nada nesses arquivos muda um resultado ou um pagamento.

Receita 8: textos e idiomas

  1. 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 de source/src/locales/en.js.
  2. Para oferecer só alguns idiomas: languages: ['en', 'es']. Para abrir sempre num só: language: 'es'.
  3. Para editar uma tradução inteira, mude source/src/locales/<code>.js, rode npm run locales e npm 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, mults e weights mudam quantos são e de quanto.
  • pays muda 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 rtp em source/ 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); prizes e weights definem as fatias.
  • coins: { everyHours: 3, amount: 50 } define o botão de presente.
  • missions: { enabled: false } desliga as missões diárias; perDay e reward mudam as missões.
  • levels: { enabled: false } desliga os níveis (todas as fichas liberadas desde o início); unlock diz em qual nível cada ficha é liberada.

Os valores são múltiplos da menor ficha.

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.