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
.jse.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:
-
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. -
Em
source/e gerar (precisa de Node.js, veja o guia principal): mude arquivos emsource/, rodenpm run builde enviesource/dist/. Use 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).
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.
1
2
3
4
5
6
7
8
9
10
11
12
13
- saldo de créditos grátis de demonstração (o + abre as moedas grátis)
- nível do jogador e XP
- menu: ajustes, regras, estatísticas, mesas
- regras desta mesa
- lugar de aposta
- aposta paralela Perfect Pairs
- aposta paralela 21+3
- bandeja de fichas (as cinco fichas da mesa)
- CLEAR: devolve as apostas
- REBET: repete as apostas da última rodada
- ×2: dobra as apostas
- DEAL: começa a rodada
- 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
-
bg-landscape.webptem 1672 × 941 (computadores e celulares deitados),bg-portrait.webptem 941 × 1672 (celulares em pé).table-landscape.webpetable-portrait.webptêm os mesmos tamanhos e são desenhadas por cima do ambiente, na frente do crupiê: mantenha a parte de cima transparente. - 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.
- Salve em WebP com os mesmos nomes e substitua.
Receita 2: o logo e o crupiê
-
O logo é
logo.webp(900 × 619, fundo transparente). Mantenha uma proporção parecida para caber no mesmo lugar. -
O crupiê é um conjunto de figuras inteiras de 1229 × 819, uma por pose (
rest,deal,wave-a,wave-b,clap-open,clap-shut,cheeks,scratch,chest,shrug,up,fist,curious,blink), algumas com uma cópia-frontcujas patas ficam na frente da borda da mesa. Desenhe o seu personagem em todas as poses no mesmo tamanho e no mesmo lugar da figura, para as poses trocarem sem pulo. Osprites.jsondá o tamanho das figuras e o ponto onde as patas tocam a mesa (contact). -
As seis figuras dos painéis (
bear-cheer.webp...) são o mesmo personagem na roleta diária, na recarga, ao subir de nível e nas regras. -
Para renomear o jogo, ponha também
brand: { name: 'Meu Jogo' }noonyx-club.config.js, o<title>e o textoaltdo logo noindex.html, e onameemsource/src/ui/theme.js. A linha pequena do estúdio sob o logo na tela de abertura é o<p class="maker">noindex.html: escreva o seu nome ali ou apague a linha.
Receita 3: as três mesas, seus ambientes e uma quarta mesa
-
Cada mesa de
rules.tablestem umid(lounge, stage, rooftop). A primeira mesa usabg-landscape/portraitetable-landscape/portrait; as outras usambg-<id>-landscape/portrait.webpetable-<id>-landscape/portrait.webp. O carrossel mostrathumb-<id>.webp(420 × 507). -
Os nomes mostrados são os textos
table_<id>dos idiomas (por exemplotable_stage), então uma mesa pode ser renomeada por idioma comtexts. -
Uma mesa nova: acrescente uma linha em
rules.tablesnoonyx-club.config.js, por exemplo{ id: 'vip', minBet: 500, maxBet: 20000, chips: [500, 1000, 2000, 5000, 20000], unlock: 20 }, e o nome delatexts: { table_vip: 'MESA VIP' }. Ela usa o primeiro ambiente. Para ter um ambiente próprio, acrescentebg-vip-*.webp,table-vip-*.webpethumb-vip.webp, ponha'vip'na listaSCENESdesource/src/main.jse copie as quatro regras[data-scene='rooftop']do fim desource/src/ui/styles-final.csstrocando porvip; depois gere o build.
Receita 4: cartas e fichas
-
cards.webptem 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. -
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) echip-side-N(uma pilha vista de lado). Os valores são oschipsde cada mesa emrules.tables; a cor de cada posição da bandeja échipColorsnotheme.js. O jogo escreve o valor na ficha.
Receita 6: sons, voz e música
-
Cada som é um MP3 em
game/audio/(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(as mesas),music-wheel.mp3(a roleta diária) emusic-bigwin.mp3(vitórias grandes). Elas repetem. -
Locutor:
v-welcome,v-place-bets,v-blackjack,v-dealer-busts,v-big,v-mega,v-epic,v-level-up. -
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), eclick,nope,whoosh. -
Uma faixa opcional que falte não quebra o jogo. O volume inicial é
audio: { volume: 0.8 }noonyx-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 desource/src/audio/audio.js.
Receita 7: cores, efeitos e tempos
-
Em
source/src/ui/theme.jsmudeaccent(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) echipColors. As cores se escrevem como'#6fe9ff'ou[150, 230, 255]. -
Em
source/src/ui/feel.jscada 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. -
A paleta da interface está no começo de
source/src/ui/styles.css(as variáveis--). -
Rode
npm run builde enviedist/. Nada nesses arquivos muda uma carta ou um pagamento.
Receita 8: textos e os 14 idiomas
-
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 desource/src/locales/en.js. -
Para oferecer só alguns idiomas:
languages: ['en', 'es']. Para abrir sempre num:language: 'es'. -
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), rodenpm run localesenpm 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;paysmuda 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 edgeemsource/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);prizeseweightsdefinem 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);neederewarddefinem 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
- Se mudou só arquivos de
game/na hospedagem, terminou: recarregue sem o cache. -
Se mudou
source/: rodenpm test, depoisnpm run build, e envie o conteúdo desource/dist/por cima da pasta do jogo.npm run robot(guia principal) joga algumas rodadas para conferir que nada quebrou. -
Mantenha o
SCOPE.mdjunto do jogo e o aviso de créditos visível. Mude obrand.storageKeyse quiser que os jogadores comecem com um save novo.