Doubloon Bay 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, doubloon-bay.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 and translations.

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

The game screen (1280×720) after a line win. 1 2 3 4 5 6 7 8 9 10 11 12 13 14
The game screen (1280×720) after a line win.
  1. Demo credits balance (+ = free refill when empty)
  2. Jackpots of the Locked Coins bonus
  3. Player level
  4. Free coins (every few hours)
  5. Menu: rules, sound, fullscreen
  6. BUY BONUS (paid with demo credits)
  7. Reels: 5 × 3, 20 lines
  8. Bet – / +
  9. MAX BET
  10. Win of the round and the paying line
  11. Spin (Space or Enter)
  12. Auto spin
  13. Turbo
  14. Credits notice (keep it visible)

Which file is each part of the screen

On screen File (in game/, the same name in source/public/)
Background (landscape / portrait / free spins) art/bg-landscape.webp, art/bg-portrait.webp, art/bg-free.webp
Logo art/logo.webp
Mascot (the parrot captain) art/mascot-idle.webp, art/mascot-cheer.webp, art/mascot-hype.webp
Reel symbols art/s0.webp ... art/s10.webp (see the table below)
Frame around the reels art/frame.webp
Spin button art/spin.webp
Gold buttons / pills / plaques art/btn-gold.webp, art/pill.webp, art/plaque.webp, art/btn-blank.webp, art/btn-close.webp
Jackpot plates art/jp-mini.webp, art/jp-minor.webp, art/jp-major.webp, art/jp-grand.webp
Icons (menu, rules, sound, fullscreen, gift) art/icon-*.webp
Celebration titles (BIG WIN, FREE SPINS...) art/title-*.webp, banner art/banner.webp
Daily wheel art/wheel.webp, art/wheel-hub.webp, art/wheel-pointer.webp, art/title-wheel.webp
Painted numbers art/font-gold.webp + art/font-gold.json
Coins, piles, sparkles art/coin.webp, art/pile-0..2.webp, art/burst.webp, art/shard-0..5.webp, art/frost.webp
WILD layers / SCATTER layers 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
Texts source/src/locales/*.js or texts in doubloon-bay.config.js
Colours of the effects source/src/ui/theme.js
Layout, sizes, palette source/src/ui/styles-1.css ... styles-3.css

Symbols: 4 low gems (emerald, sapphire, amethyst, topaz), spyglass, ship's wheel, captain's hat, treasure chest, WILD (golden compass), SCATTER and COIN. In the files: s0-s3 low gems, s4-s7 high symbols, s8 WILD, s9 SCATTER, s10 COIN.

Recipe 1: replace a symbol

  1. Open art/s7.webp (for example) in your image editor to see its size: symbols are 320 × 320 pixels with a transparent background.
  2. Draw or paste your symbol on a transparent 320 × 320 canvas, centred, with a small margin.
  3. Export as WebP with the same name, s7.webp, and replace the file in game/art/ (and in source/public/art/ to keep the source in step).
  4. Reload without the cache. The paytable in the rules uses the same files, so it changes too.

Recipe 2: replace the backgrounds

  1. bg-landscape.webp is 1672 × 941 (desktop and phones held sideways), bg-portrait.webp is 941 × 1672 (phones held upright), bg-free.webp 1672 × 941 is shown during free spins.
  2. Keep the important part of the picture in the middle: the edges are cut on screens of other shapes. Keep the centre darker so the reels stand out.
  3. Save as WebP with the same names and replace them.

Recipe 4: buttons and plates

Buttons and plates are stretched with their two ends kept intact ("9-slice"). When you redraw btn-gold.webp, pill.webp, plaque.webp or the jp-*.webp plates, keep the same image size and the same width of the decorated ends, otherwise the ends stretch. The cut sizes are in the stylesheets (border-image) if you need to change them.

Recipe 5: 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 (base game) and music-free.mp3 (free spins). They loop. Optional extra tracks music-locked, music-bigwin and music-wheel (Locked Coins, big wins, the daily wheel) are supported but not shipped: add the MP3 to source/public/audio/, add its name to the FILES list at the top of source/src/audio/audio.js and build.
  3. Announcer: v-big, v-mega, v-epic, v-free, v-locked, v-grand.
  4. Effects: 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. If a file is missing the game plays a built-in synthesised sound instead, so it never breaks. The starting volume is audio: { volume: 0.8 } in doubloon-bay.config.js.

Recipe 6: colours of the effects and the screen

  1. In source/src/ui/theme.js change accent (rings, sparks, the waiting reel), gold, reelBed (the colour behind the symbols), tierRays (light rays of the celebrations), ambient (the floating particles) and bolt (the WILD trail). Colours are written like '#5fe38a' or [95, 227, 138].
  2. The palette of the interface is at the top of source/src/ui/styles-1.css (the -- variables).
  3. Run npm run build and upload dist/. Nothing in these files changes a result or a payout.

Recipe 7: texts and languages

  1. To change a few texts on the host, add them to doubloon-bay.config.js: texts: { tapToPlay: 'PLAY NOW' } changes every language; texts: { pt: { tapToPlay: 'JOGAR' } } only Portuguese. The names (tapToPlay, buyBonus...) 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, run npm run locales and npm run build.

Recipe 8: bets, starting credits and RTP

  1. In doubloon-bay.config.js, inside math: { }: startBalance (credits of a new player), bets (the bet steps, multiples of 20), maxWin, and profile: 'generous' (about 97% RTP), 'standard' (about 95%) or 'house' (about 92.5%).
  2. buyBonus: false removes the BUY BONUS button.
  3. If you change pays or reels, measure the new RTP: npm run rtp in source/.

These are fictional demo credits only.

Recipe 9: levels, daily wheel and free coins

In doubloon-bay.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 wedges.
  • coins: { everyHours: 3, amount: 50 } sets the gift button.
  • levels: { enabled: false } turns levels off (every bet open from the start).

Amounts are multiples of the smallest bet.

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