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
.jsand.cssfiles; - 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:
-
Directly on the host (no tools): replace files in your uploaded
game/folder (art, audio,desert-express.config.js). Fast, but these changes live only on the host. -
In
source/and build (needs Node.js, see the main guide): change files insource/, runnpm run buildand uploadsource/dist/. Use this for code, styles,theme.jsand translations.
After each upload, reload the game without the cache (Ctrl+F5, or Cmd+Shift+R on a Mac).
1
2
3
4
5
6
7
8
9
10
11
12
13
14
- Demo credits balance (+ = free refill when empty)
- Jackpots of the Locked Coins bonus
- Player level
- Free coins (every few hours)
- Menu: rules, sound, fullscreen
- BUY BONUS (paid with demo credits)
- Reels: 5 × 3, 20 lines
- Bet – / +
- MAX BET
- Win of the round and the paying line
- Spin (Space or Enter)
- Auto spin
- Turbo
- 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 raccoon conductor) |
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 / green 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 desert-express.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), railway lantern, ticket, pocket watch, gold bars,
WILD (golden locomotive), 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
-
Open
art/s7.webp(for example) in your image editor to see its size: symbols are 320 × 320 pixels with a transparent background. - Draw or paste your symbol on a transparent 320 × 320 canvas, centred, with a small margin.
-
Export as WebP with the same name,
s7.webp, and replace the file ingame/art/(and insource/public/art/to keep the source in step). - Reload without the cache. The paytable in the rules uses the same files, so it changes too.
Recipe 2: replace the backgrounds
-
bg-landscape.webpis 1672 × 941 (desktop and phones held sideways),bg-portrait.webpis 941 × 1672 (phones held upright),bg-free.webp1672 × 941 is shown during free spins. - 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.
- Save as WebP with the same names and replace them.
Recipe 3: the logo and the mascot
-
The logo is
logo.webp(1516 × 999, transparent background). Keep a similar width-to-height shape so it fits in the same place. -
The mascot has three poses of 725 × 1100 with a transparent background:
mascot-idle,mascot-cheerandmascot-hype. The game switches between them (waiting, wins, the title screen and the daily wheel), so replace all three with the same character. -
To rename the game, also set
brand: { name: 'My Game' }indesert-express.config.jsand the<title>inindex.html.
Recipe 5: sounds, voice and music
-
Every sound is an MP3 in
game/audio/(same names insource/public/audio/). Replace a file with another MP3 of the same name; short effects should be short (under 2 seconds). -
Music:
music.mp3(base game) andmusic-free.mp3(free spins). They loop. Optional extra tracksmusic-locked,music-bigwinandmusic-wheel(Locked Coins, big wins, the daily wheel) are supported but not shipped: add the MP3 tosource/public/audio/, add its name to theFILESlist at the top ofsource/src/audio/audio.jsand build. -
Announcer:
v-big,v-mega,v-epic,v-free,v-locked,v-grand. -
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. -
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 }indesert-express.config.js.
Recipe 6: colours of the effects and the screen
-
In
source/src/ui/theme.jschangeaccent(rings, sparks, the waiting reel),gold,reelBed(the colour behind the symbols),tierRays(light rays of the celebrations),ambient(the floating particles) andbolt(the WILD trail). Colours are written like'#5fe38a'or[95, 227, 138]. -
The palette of the interface is at the top of
source/src/ui/styles-1.css(the--variables). -
Run
npm run buildand uploaddist/. Nothing in these files changes a result or a payout.
Recipe 7: texts and languages
-
To change a few texts on the host, add them to
desert-express.config.js:texts: { tapToPlay: 'PLAY NOW' }changes every language;texts: { pt: { tapToPlay: 'JOGAR' } }only Portuguese. The names (tapToPlay,buyBonus...) are the keys ofsource/src/locales/en.js. -
To offer only some languages:
languages: ['en', 'es']. To always open in one:language: 'es'. -
To edit a whole translation, change
source/src/locales/<code>.js, runnpm run localesandnpm run build.
Recipe 8: bets, starting credits and RTP
-
In
desert-express.config.js, insidemath: { }:startBalance(credits of a new player),bets(the bet steps, multiples of 20),maxWin, andprofile:'generous'(about 97% RTP),'standard'(about 95%) or'house'(about 92.5%). buyBonus: falseremoves the BUY BONUS button.- If you change pays or reels, measure the new RTP:
npm run rtpinsource/.
These are fictional demo credits only.
Recipe 9: levels, daily wheel and free coins
In desert-express.config.js, inside progress: { }:
-
wheel: { alwaysReady: false, everyHours: 24 }offers the wheel once a day (the demo offers it on every visit);prizesandweightsset 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
-
If you changed only files of
game/on the host, you are done: reload without the cache. -
If you changed
source/: runnpm test, thennpm run build, and upload the contents ofsource/dist/over your game folder. -
Keep
SCOPE.mdwith the game and the credits notice visible. Changebrand.storageKeyif you want players to start with a fresh save.