Onyx Club Blackjack 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 em modo texto simples) para os arquivos .js e .css;
  • um editor de imagem que salve WebP (GIMP, Photopea no navegador, Krita) para a arte;
  • um editor de áudio que salve MP3 (Audacity) para os sons.

Faça uma cópia 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 da sua pasta game/ enviada (arte, áudio, onyx-club.config.js). Rápido, mas essas mudanças ficam só na hospedagem.
  2. Em source/ e gerar (precisa de Node.js, veja o guia principal): mude arquivos em source/, rode npm run build e envie source/dist/. Use 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).

Um tema completamente novo é: imagens novas com os mesmos nomes em art/, sons novos em audio/, as cores do source/src/ui/theme.js, os nomes das mesas nos idiomas, e o nome no onyx-club.config.js e no index.html.

Apostando na primeira mesa (MESA SALÃO): três lugares numa tela larga, as apostas paralelas ao lado do lugar do meio. 1 2 3 4 5 6 7 8 9 10 11 12 13
Apostando na primeira mesa (MESA SALÃO): três lugares numa tela larga, as apostas paralelas ao lado do lugar do meio.
  1. saldo de créditos grátis de demonstração (o + abre as moedas grátis)
  2. nível do jogador e XP
  3. menu: ajustes, regras, estatísticas, mesas
  4. regras desta mesa
  5. lugar de aposta
  6. aposta paralela Perfect Pairs
  7. aposta paralela 21+3
  8. bandeja de fichas (as cinco fichas da mesa)
  9. CLEAR: devolve as apostas
  10. REBET: repete as apostas da última rodada
  11. ×2: dobra as apostas
  12. DEAL: começa a rodada
  13. o aviso de créditos grátis (mantenha visível)

Qual arquivo é cada parte da tela

Na tela Arquivo (em game/art/, o mesmo nome em source/public/art/)
Ambiente atrás da primeira mesa (deitado / em pé) bg-landscape.webp, bg-portrait.webp
A mesa na frente do crupiê (deitado / em pé) table-landscape.webp, table-portrait.webp
Ambientes e mesas da segunda e da terceira mesa bg-stage-*.webp, table-stage-*.webp, bg-rooftop-*.webp, table-rooftop-*.webp
Figuras das mesas no carrossel do salão thumb-lounge.webp, thumb-stage.webp, thumb-rooftop.webp
Logo logo.webp
O crupiê (uma pantera negra de smoking marfim que dá as cartas, bate palmas, dá de ombros e acena) bear-sprites/*.webp (uma figura por pose) e bear-sprites/sprites.json
O crupiê nos painéis (roleta, recarga, subir de nível, regras) bear-cheer.webp, bear-cheer-full.webp, bear-clipboard.webp, bear-peek.webp, bear-sack.webp, bear-thumbs.webp
Cartas (as 52 e o verso) cards.webp (uma folha)
Sapato de cartas / bandeja de descarte shoe.webp / discard.webp
Fichas: na bandeja / vistas de cima / vistas de lado chip-rack-0..5.webp / chip-top-0..5.webp / chip-side-0..5.webp
Bandeja de fichas e a barra do console (telas largas) rack.webp, console-bar.webp
Botões e placas btn-blue/teal/navy/violet/gray/pill.webp, banner.webp, plaque.webp, panel.webp, row.webp, round-btn.webp, badge*.webp, level-badge.webp
Painéis e títulos de resultado panel-win/push/bigwin/crest.webp, banner-bust.webp, title-*.webp
Ícones icon-*.webp
Roleta diária wheel.webp, wheel-hub.webp, wheel-pointer.webp, wheel-base.webp, title-wheel.webp, montes de moedas pile-0..2.webp
Estatísticas e conquistas stat-*.webp, medal-*.webp
Decorações (ornamentos Art Déco, pó dourado e faíscas) crystal-0..3.webp, flake-0..5.webp, spark-0..3.webp, coin.webp, ice-arrow.webp, gift-sack.webp
Algarismos pintados: claros (apostas, totais) / dourados (saldo, vitórias) font-ice.webp + .json / font-gold.webp + .json
Textos source/src/locales/*.js ou texts no onyx-club.config.js
Cores dos efeitos source/src/ui/theme.js
Tempos da sensação de jogo source/src/ui/feel.js
Layout, tamanhos, paleta source/src/ui/styles.css (base), depois styles-placement.css, styles-polish.css, styles-final.css

Receita 1: trocar o ambiente e a mesa

  1. bg-landscape.webp tem 1672 × 941 (computadores e celulares deitados), bg-portrait.webp tem 941 × 1672 (celulares em pé). table-landscape.webp e table-portrait.webp têm os mesmos tamanhos e são desenhadas por cima do ambiente, na frente do crupiê: mantenha a parte de cima transparente.
  2. Deixe a parte importante da figura no meio: as bordas são cortadas em telas de outros formatos. A borda do fundo da mesa tem de ficar na mesma altura, porque as patas do crupiê se apoiam nela.
  3. Salve em WebP com os mesmos nomes e substitua.

Receita 3: as três mesas, seus ambientes e uma quarta mesa

  1. Cada mesa de rules.tables tem um id (lounge, stage, rooftop). A primeira mesa usa bg-landscape/portrait e table-landscape/portrait; as outras usam bg-<id>-landscape/portrait.webp e table-<id>-landscape/portrait.webp. O carrossel mostra thumb-<id>.webp (420 × 507).
  2. Os nomes mostrados são os textos table_<id> dos idiomas (por exemplo table_stage), então uma mesa pode ser renomeada por idioma com texts.
  3. Uma mesa nova: acrescente uma linha em rules.tables no onyx-club.config.js, por exemplo { id: 'vip', minBet: 500, maxBet: 20000, chips: [500, 1000, 2000, 5000, 20000], unlock: 20 }, e o nome dela texts: { table_vip: 'MESA VIP' }. Ela usa o primeiro ambiente. Para ter um ambiente próprio, acrescente bg-vip-*.webp, table-vip-*.webp e thumb-vip.webp, ponha 'vip' na lista SCENES de source/src/main.js e copie as quatro regras [data-scene='rooftop'] do fim de source/src/ui/styles-final.css trocando por vip; depois gere o build.

Receita 4: cartas e fichas

  1. cards.webp tem 2600 × 1400: 13 colunas (A, 2 a 10, J, Q, K) e 5 linhas (espadas, copas, ouros, paus, e o verso na última linha), cada carta com 200 × 280. Mantenha a mesma grade.
  2. Cada cor de ficha tem três figuras com o mesmo número: chip-rack-N (na bandeja), chip-top-N (vista de cima, 256 × 256) e chip-side-N (uma pilha vista de lado). Os valores são os chips de cada mesa em rules.tables; a cor de cada posição da bandeja é chipColors no theme.js. O jogo escreve o valor na ficha.

Receita 5: botões e placas

Botões e placas são esticados mantendo as pontas decoradas intactas ("9 pedaços"). Ao redesenhar btn-*.webp, banner.webp, plaque.webp, panel.webp ou row.webp, mantenha o mesmo tamanho de imagem e a mesma largura das pontas decoradas, senão as pontas esticam. Os cortes estão em source/src/ui/art.js (plates), medidos na arte original.

Receita 6: sons, voz e música

  1. Cada som é um MP3 em game/audio/ (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 (as mesas), music-wheel.mp3 (a roleta diária) e music-bigwin.mp3 (vitórias grandes). Elas repetem.
  3. Locutor: v-welcome, v-place-bets, v-blackjack, v-dealer-busts, v-big, v-mega, v-epic, v-level-up.
  4. Efeitos: as cartas (card, card-land, flip, shuffle, sweep), as fichas (chip, chips-win, chips-lose), resultados (win, lose, push, bust, blackjack, bigwin, shatter), moedas (coin, coinrain, count, collect, levelup), a roleta diária (wheel-tick, wheel-win), e click, nope, whoosh.
  5. Uma faixa opcional que falte não quebra o jogo. O volume inicial é audio: { volume: 0.8 } no onyx-club.config.js; o jogador tem chaves separadas para música, efeitos e voz em SETTINGS. A lista de arquivos e seus volumes está no começo de source/src/audio/audio.js.

Receita 7: cores, efeitos e tempos

  1. Em source/src/ui/theme.js mude accent (anéis, faíscas, brilhos), gold, ambient (o pó dourado subindo devagar na luz das luminárias), rays (os raios de luz atrás de cada comemoração) e chipColors. As cores se escrevem como '#6fe9ff' ou [150, 230, 255].
  2. Em source/src/ui/feel.js cada tempo tem um nome e um comentário: a velocidade das cartas voando e virando, as fichas, a vez do crupiê, quanto tempo um resultado fica, as comemorações. speed.fast é o ajuste FAST. Números menores deixam o jogo mais rápido.
  3. A paleta da interface está no começo de source/src/ui/styles.css (as variáveis --).
  4. Rode npm run build e envie dist/. Nada nesses arquivos muda uma carta ou um pagamento.

Receita 8: textos e os 14 idiomas

  1. Para trocar alguns textos na hospedagem, ponha no onyx-club.config.js: texts: { tapToPlay: 'JOGAR' } muda todos os idiomas; texts: { pt: { tapToPlay: 'JOGAR' } } só o português. Os nomes (tapToPlay, deal, table_lounge...) são as chaves de source/src/locales/en.js.
  2. Para oferecer só alguns idiomas: languages: ['en', 'es']. Para abrir sempre num: language: 'es'.
  3. Para editar uma tradução inteira, mude source/src/locales/<código>.js (en pt es fr de it nl pl tr ru id ja ko zh), rode npm run locales e npm run build.

Receita 9: regras, limites das mesas e os créditos iniciais

No onyx-club.config.js, dentro de rules: { }:

  • preset: 'vegas', 'european' ou 'social'; depois qualquer regra avulsa: decks, dealerHitsSoft17, blackjackPays ([3, 2] ou [6, 5]...), double, surrender, insurance, maxHands.
  • tables: a aposta mínima e a máxima, as cinco fichas e o nível de abertura de cada mesa.
  • sideBets: { perfectPairs: { enabled: false } } tira uma aposta paralela; pays muda o que ela paga.
  • startBalance: os créditos de um jogador novo e da recarga grátis.
  • Depois de uma mudança, rode npm run edge em source/ para ver a vantagem da casa da sua mesa. Um valor errado é recusado com uma mensagem.

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

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

No onyx-club.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 12 fatias.
  • coins: { everyHours: 3, amount: 100 } define o botão de presente.
  • levels: { enabled: false } desliga os níveis (todas as mesas abertas desde o início); need e reward definem a velocidade dos níveis e o que eles dão.

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

Receita 11: publicar a sua versão

  1. Se mudou só arquivos de game/ na hospedagem, terminou: recarregue sem o cache.
  2. Se mudou source/: rode npm test, depois npm run build, e envie o conteúdo de source/dist/ por cima da pasta do jogo. npm run robot (guia principal) joga algumas rodadas para conferir que nada quebrou.
  3. Mantenha o SCOPE.md junto do jogo e o aviso de créditos visível. Mude o brand.storageKey se quiser que os jogadores comecem com um save novo.