Onyx Club Blackjack 1.0.0: customization guide

Step-by-step recipes to change art, sounds, texts and settings, without programming.

Main buyer guide

EnglishPortuguêsEspañol

Before you start

This guide is for people who do not program. Every recipe says which file to open and what to change. You need:

  • a text editor (Visual Studio Code, Notepad++, TextEdit in plain-text mode) for .js and .css files;
  • an image editor that saves WebP (GIMP, Photopea in the browser, Krita) for the art;
  • an audio editor that saves MP3 (Audacity) for the sounds.

Make a backup first: copy the whole package folder before you change anything.

There are two ways to change the game:

  1. Directly on the host (no tools): replace files in your uploaded game/ folder (art, audio, onyx-club.config.js). Fast, but these changes live only on the host.
  2. In source/ and build (needs Node.js, see the main guide): change files in source/, run npm run build and upload source/dist/. Use this for code, styles, theme.js, feel.js and translations.

After each upload, reload the game without the cache (Ctrl+F5, or Cmd+Shift+R on a Mac).

A full reskin is: new pictures with the same names in art/, new sounds in audio/, the colours of source/src/ui/theme.js, the table names in the locales, and the name in onyx-club.config.js and index.html.

Betting at the first table (LOUNGE TABLE): three spots on a wide screen, the side bets beside the middle one. 1 2 3 4 5 6 7 8 9 10 11 12 13
Betting at the first table (LOUNGE TABLE): three spots on a wide screen, the side bets beside the middle one.
  1. balance of free demo credits (the + opens the free coins)
  2. player level and XP
  3. menu: settings, rules, statistics, tables
  4. rules of this table
  5. betting spot
  6. Perfect Pairs side bet
  7. 21+3 side bet
  8. chip rack (the table's five chips)
  9. CLEAR: take the bets back
  10. REBET: the last round's bets again
  11. ×2: double the bets
  12. DEAL: start the round
  13. the free-credits notice (keep it visible)

Which file is each part of the screen

On screen File (in game/art/, the same name in source/public/art/)
Room behind the first table (landscape / portrait) bg-landscape.webp, bg-portrait.webp
The table in front of the dealer (landscape / portrait) table-landscape.webp, table-portrait.webp
Rooms and tables of the second and third tables bg-stage-*.webp, table-stage-*.webp, bg-rooftop-*.webp, table-rooftop-*.webp
Table pictures in the lobby carousel thumb-lounge.webp, thumb-stage.webp, thumb-rooftop.webp
Logo logo.webp
The dealer (a black panther in an ivory tuxedo who deals, claps, shrugs and waves) bear-sprites/*.webp (one picture per pose) and bear-sprites/sprites.json
The dealer on panels (wheel, refill, level up, rules) bear-cheer.webp, bear-cheer-full.webp, bear-clipboard.webp, bear-peek.webp, bear-sack.webp, bear-thumbs.webp
Playing cards (all 52 and the back) cards.webp (one sheet)
Card shoe / discard tray shoe.webp / discard.webp
Chips: in the rack / seen from above / seen from the side chip-rack-0..5.webp / chip-top-0..5.webp / chip-side-0..5.webp
Chip rack and the console bar (wide screens) rack.webp, console-bar.webp
Buttons and plates btn-blue/teal/navy/violet/gray/pill.webp, banner.webp, plaque.webp, panel.webp, row.webp, round-btn.webp, badge*.webp, level-badge.webp
Result panels and titles panel-win/push/bigwin/crest.webp, banner-bust.webp, title-*.webp
Icons icon-*.webp
Daily wheel wheel.webp, wheel-hub.webp, wheel-pointer.webp, wheel-base.webp, title-wheel.webp, coin piles pile-0..2.webp
Statistics and achievements stat-*.webp, medal-*.webp
Decorations (Art Deco ornaments, gold dust and sparks) crystal-0..3.webp, flake-0..5.webp, spark-0..3.webp, coin.webp, ice-arrow.webp, gift-sack.webp
Painted digits: light (bets, totals) / gold (balance, wins) font-ice.webp + .json / font-gold.webp + .json
Texts source/src/locales/*.js or texts in onyx-club.config.js
Colours of the effects source/src/ui/theme.js
Timings of the game feel source/src/ui/feel.js
Layout, sizes, palette source/src/ui/styles.css (base), then styles-placement.css, styles-polish.css, styles-final.css

Recipe 1: replace the room and the table

  1. bg-landscape.webp is 1672 × 941 (desktops and phones held sideways), bg-portrait.webp is 941 × 1672 (phones held upright). table-landscape.webp and table-portrait.webp have the same sizes and are drawn over the room, in front of the dealer: keep their transparent upper part.
  2. Keep the important part of the picture in the middle: the edges are cut on screens of other shapes. The far edge of the table must stay at the same height, because the dealer's paws rest on it.
  3. Save as WebP with the same names and replace them.

Recipe 3: the three tables, their rooms and a fourth table

  1. Each table of rules.tables has an id (lounge, stage, rooftop). The first table uses bg-landscape/portrait and table-landscape/portrait; the others use bg-<id>-landscape/portrait.webp and table-<id>-landscape/portrait.webp. The carousel shows thumb-<id>.webp (420 × 507).
  2. The names shown are the texts table_<id> of the locales (for example table_stage), so a table can be renamed per language with texts.
  3. A new table: add a line to rules.tables in onyx-club.config.js, for example { id: 'vip', minBet: 500, maxBet: 20000, chips: [500, 1000, 2000, 5000, 20000], unlock: 20 }, and its name texts: { table_vip: 'VIP TABLE' }. It plays in the first room. To give it its own room, add bg-vip-*.webp, table-vip-*.webp and thumb-vip.webp, add 'vip' to the SCENES list in source/src/main.js and copy the four [data-scene='rooftop'] rules at the end of source/src/ui/styles-final.css with vip, then build.

Recipe 4: cards and chips

  1. cards.webp is 2600 × 1400: 13 columns (A, 2 to 10, J, Q, K) and 5 rows (spades, hearts, diamonds, clubs, and the back on the last row), each card 200 × 280. Keep the same grid.
  2. Each chip colour has three pictures with the same number: chip-rack-N (in the rack), chip-top-N (seen from above, 256 × 256) and chip-side-N (a stack seen from the side). The values are chips of each table in rules.tables; which colour each rack position uses is chipColors in theme.js. The game writes the value on the chip.

Recipe 5: buttons and plates

Buttons and plates are stretched with their decorated ends kept intact ("9-slice"). When you redraw btn-*.webp, banner.webp, plaque.webp, panel.webp or row.webp, keep the same image size and the same width of the decorated ends, otherwise the ends stretch. The cut sizes are in source/src/ui/art.js (plates), measured on the shipped art.

Recipe 6: sounds, voice and music

  1. Every sound is an MP3 in game/audio/ (same names in source/public/audio/). Replace a file with another MP3 of the same name; short effects should be short (under 2 seconds).
  2. Music: music.mp3 (the tables), music-wheel.mp3 (the daily wheel) and music-bigwin.mp3 (big wins). They loop.
  3. Announcer: v-welcome, v-place-bets, v-blackjack, v-dealer-busts, v-big, v-mega, v-epic, v-level-up.
  4. Effects: the cards (card, card-land, flip, shuffle, sweep), the chips (chip, chips-win, chips-lose), results (win, lose, push, bust, blackjack, bigwin, shatter), coins (coin, coinrain, count, collect, levelup), the daily wheel (wheel-tick, wheel-win), and click, nope, whoosh.
  5. A missing optional track does not break the game. The starting volume is audio: { volume: 0.8 } in onyx-club.config.js; the player has separate switches for music, effects and voice in SETTINGS. The list of files and their volumes is at the top of source/src/audio/audio.js.

Recipe 7: colours, effects and timings

  1. In source/src/ui/theme.js change accent (rings, sparks, glints), gold, ambient (the gold dust rising slowly in the lamplight), rays (the light rays behind each celebration) and chipColors. Colours are written like '#6fe9ff' or [150, 230, 255].
  2. In source/src/ui/feel.js every timing has a name and a comment: how fast cards fly and flip, the chips, the dealer's turn, how long a result stays, the celebrations. speed.fast is the FAST setting. Smaller numbers make the game quicker.
  3. The palette of the interface is at the top of source/src/ui/styles.css (the -- variables).
  4. Run npm run build and upload dist/. Nothing in these files changes a card or a payout.

Recipe 8: texts and the 14 languages

  1. To change a few texts on the host, add them to onyx-club.config.js: texts: { tapToPlay: 'PLAY NOW' } changes every language; texts: { pt: { tapToPlay: 'JOGAR' } } only Portuguese. The names (tapToPlay, deal, table_lounge...) are the keys of source/src/locales/en.js.
  2. To offer only some languages: languages: ['en', 'es']. To always open in one: language: 'es'.
  3. To edit a whole translation, change source/src/locales/<code>.js (en pt es fr de it nl pl tr ru id ja ko zh), run npm run locales and npm run build.

Recipe 9: table rules, limits and the starting credits

In onyx-club.config.js, inside rules: { }:

  • preset: 'vegas', 'european' or 'social'; then any single rule: decks, dealerHitsSoft17, blackjackPays ([3, 2] or [6, 5]...), double, surrender, insurance, maxHands.
  • tables: the minimum and maximum bet, the five chips and the unlock level of each table.
  • sideBets: { perfectPairs: { enabled: false } } removes a side bet; pays changes what it pays.
  • startBalance: the credits of a new player and of the free refill.
  • After a change, run npm run edge in source/ to see the house edge of your table. A wrong value is refused with a message.

These are fictional demo credits only.

Recipe 10: levels, daily wheel and free coins

In onyx-club.config.js, inside progress: { }:

  • wheel: { alwaysReady: false, everyHours: 24 } offers the wheel once a day (the demo offers it on every visit); prizes and weights set the 12 wedges.
  • coins: { everyHours: 3, amount: 100 } sets the gift button.
  • levels: { enabled: false } turns levels off (every table open from the start); need and reward set how fast levels come and what they give.

Amounts are multiples of the smallest bet of the first table.

Recipe 11: publish your version

  1. If you changed only files of game/ on the host, you are done: reload without the cache.
  2. If you changed source/: run npm test, then npm run build, and upload the contents of source/dist/ over your game folder. npm run robot (main guide) plays a few rounds to check nothing broke.
  3. Keep SCOPE.md with the game and the credits notice visible. Change brand.storageKey if you want players to start with a fresh save.