Lucky Clover 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 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, lucky-clover.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 e traduções.

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

A tela do jogo (1280×720) depois de um prêmio de linha. 1 2 3 4 5 6 7 8 9 10 11 12 13 14
A tela do jogo (1280×720) depois de um prêmio de linha.
  1. Saldo de créditos de demonstração (+ = recarga grátis quando acaba)
  2. Jackpots do bônus Locked Coins
  3. Nível do jogador
  4. Moedas grátis (a cada poucas horas)
  5. Menu: regras, som, tela cheia
  6. BUY BONUS (pago com créditos de demonstração)
  7. Rolos: 5 × 3, 20 linhas
  8. Aposta – / +
  9. MAX BET (aposta máxima)
  10. Ganho da rodada e a linha premiada
  11. Girar (Espaço ou Enter)
  12. Giro automático
  13. Turbo
  14. Aviso dos créditos (mantenha visível)

Qual arquivo é cada parte da tela

Na tela Arquivo (em game/, com o mesmo nome em source/public/)
Fundo (horizontal / vertical / rodadas grátis) art/bg-landscape.webp, art/bg-portrait.webp, art/bg-free.webp
Logo art/logo.webp
Mascote (o duende) art/mascot-idle.webp, art/mascot-cheer.webp, art/mascot-hype.webp
Símbolos dos rolos art/s0.webp ... art/s10.webp (veja a lista abaixo)
Moldura em volta dos rolos art/frame.webp
Botão de girar art/spin.webp
Botões dourados / pílulas verdes / placas art/btn-gold.webp, art/pill.webp, art/plaque.webp, art/btn-blank.webp, art/btn-close.webp
Placas dos jackpots art/jp-mini.webp, art/jp-minor.webp, art/jp-major.webp, art/jp-grand.webp
Ícones (menu, regras, som, tela cheia, presente) art/icon-*.webp
Títulos das comemorações (BIG WIN, FREE SPINS...) art/title-*.webp, faixa art/banner.webp
Roleta diária art/wheel.webp, art/wheel-hub.webp, art/wheel-pointer.webp, art/title-wheel.webp
Números pintados art/font-gold.webp + art/font-gold.json
Moedas, pilhas, brilhos art/coin.webp, art/pile-0..2.webp, art/burst.webp, art/shard-0..5.webp, art/frost.webp
Camadas do WILD / camadas do SCATTER art/wild-hammer.webp, art/wild-banner.webp, art/bolt-0..3.webp / art/scatter-ring.webp, art/scatter-core.webp, art/scatter-banner.webp
Textos source/src/locales/*.js ou texts no lucky-clover.config.js
Cores dos efeitos source/src/ui/theme.js
Layout, tamanhos, paleta source/src/ui/styles-1.css ... styles-3.css

Símbolos: 4 gemas baixas (esmeralda, safira, ametista, topázio), harpa, ferradura, cogumelo, pote de ouro, WILD (trevo de quatro folhas), SCATTER e MOEDA. Nos arquivos: s0-s3 são as gemas baixas, s4-s7 os símbolos altos, s8 o WILD, s9 o SCATTER e s10 o COIN.

Receita 1: trocar um símbolo

  1. Abra art/s7.webp (por exemplo) no seu editor de imagem para ver o tamanho: os símbolos têm 320 × 320 pixels com fundo transparente.
  2. Desenhe ou cole o seu símbolo numa tela transparente de 320 × 320, centralizado, com uma pequena margem.
  3. Exporte em WebP com o mesmo nome, s7.webp, e substitua o arquivo em game/art/ (e em source/public/art/, para manter o código-fonte igual).
  4. Recarregue sem o cache. A tabela de pagamentos nas regras usa os mesmos arquivos, então ela também muda.

Receita 2: trocar os fundos

  1. bg-landscape.webp tem 1672 × 941 (computador e celular deitado), bg-portrait.webp tem 941 × 1672 (celular em pé) e bg-free.webp, de 1672 × 941, aparece durante as rodadas grátis.
  2. Deixe a parte importante da imagem no meio: as bordas são cortadas em telas de outros formatos. Deixe o centro mais escuro para os rolos se destacarem.
  3. Salve em WebP com os mesmos nomes e substitua os arquivos.

Receita 4: botões e placas

Botões e placas são esticados com as duas pontas mantidas intactas ("9-slice", 9 pedaços). Quando redesenhar btn-gold.webp, pill.webp, plaque.webp ou as placas jp-*.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 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 (jogo base) e music-free.mp3 (rodadas grátis). Elas tocam em loop. Faixas extras opcionais music-locked, music-bigwin e music-wheel (Locked Coins, grandes ganhos, roda diária) são aceitas mas não vêm no pacote: coloque o MP3 em source/public/audio/, acrescente o nome na lista FILES no início de source/src/audio/audio.js e gere o build.
  3. Locutor: v-big, v-mega, v-epic, v-free, v-locked, v-grand.
  4. Efeitos: spin, stop, win, smallwin, bigwin, line, coin, coinrain, count, collect, scatter, suspense, bonus, buy, clang, shatter, zap, stamp, heart, drumroll, levelup, miss, nope, click, wheel-tick, wheel-win.
  5. Se faltar um arquivo, o jogo toca no lugar um som sintetizado embutido, então ele nunca quebra. O volume inicial é audio: { volume: 0.8 } no lucky-clover.config.js.

Receita 6: cores dos efeitos e da tela

  1. Em source/src/ui/theme.js, mude accent (anéis, faíscas, o rolo em espera), gold, reelBed (a cor atrás dos símbolos), tierRays (raios de luz das comemorações), ambient (as partículas flutuantes) e bolt (o rastro do WILD). As cores são escritas como '#5fe38a' ou [95, 227, 138].
  2. A paleta da interface fica no topo de source/src/ui/styles-1.css (as variáveis --).
  3. 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 lucky-clover.config.js: texts: { tapToPlay: 'PLAY NOW' } muda em todos os idiomas; texts: { pt: { tapToPlay: 'JOGAR' } }, só em português. Os nomes (tapToPlay, buyBonus...) 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.

Receita 8: apostas, créditos iniciais e RTP

  1. No lucky-clover.config.js, dentro de math: { }: startBalance (créditos de um jogador novo), bets (os valores de aposta, múltiplos de 20), maxWin e profile: 'generous' (cerca de 97% de RTP), 'standard' (cerca de 95%) ou 'house' (cerca de 92,5%).
  2. buyBonus: false tira o botão BUY BONUS.
  3. Se você mudar pagamentos ou rolos, meça o novo RTP: npm run rtp em source/.

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

Receita 9: níveis, roleta diária e moedas grátis

No lucky-clover.config.js, dentro de progress: { }:

  • wheel: { alwaysReady: false, everyHours: 24 } oferece a roleta uma vez por dia (a demonstração oferece em toda visita); prizes e weights definem as fatias.
  • coins: { everyHours: 3, amount: 50 } configura o botão de presente.
  • levels: { enabled: false } desliga os níveis (todas as apostas liberadas desde o início).

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

Receita 10: 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.