Lumi - Customization guide

Recipes to change the look, the sound, the texts and the levels without programming.

← Back to the buyer guide

EnglishPortuguêsEspañol

Before you start

You can change the look, the sound, the texts and the levels of Lumi without programming. Work in the source/ folder, test, and copy what you changed to game/ (or upload source/ without the tools/ folder).

  • Keep a copy of the original package.
  • Change one thing at a time and reload the page (Ctrl+F5) to see it.

Free tools

ForTool
Text files (.js, .css, .html)Visual Studio Code, Notepad++
Pictures (.webp, with transparency)GIMP, Krita, Photopea (in the browser), Squoosh to convert PNG to WebP
Sound (.mp3)Audacity

Where each part of the screen comes from

What you seeWhere it is
Lumi's head and bodyassets/lumi-cabeca.webp, lumi-cabeca-feliz.webp, lumi-cabeca-ai.webp, lumi-gomo.webp
Ground and rockassets/bloco.webp, bloco-pedra.webp (world 1), -w2, -w3 versions, ilha-base.webp
Berry, spikes, portalassets/fruta.webp, espinhos.webp, portal-fechado.webp, portal-aberto.webp
Plate, door, lanternassets/botao-solto.webp, botao-press.webp, porta.webp, lanterna-bloco.webp, pedestal.webp, borla.webp
Backgroundsassets/fundo-w1/w2/w3.webp (landscape), fundo-p1/p2/p3.webp (portrait)
Logoassets/logo.webp
Result starsassets/hud/star-on.webp, star-off.webp
Buttons, panels, chipsDrawn by css/style.css (no picture)
IconsThe <symbol> list at the top of index.html (SVG)
Textsjs/config.js (English, Portuguese) and js/i18n.js (other languages)

Recipe 1: colours of the interface

Open css/style.css. The first lines hold the palette:

--ink: #1b1147;      /* outlines */
--panel: #3b2a9c;    /* window, top */
--panel2: #2a1c74;   /* window, bottom */
--cream: #fff6dc;    /* text */
--gold: #ffd75e;     /* main button, top */
--gold2: #ffa52e;    /* main button, bottom */
--goldink: #5a2a08;  /* text on gold */
--vio: #8468f7;      /* other buttons, top */
--vio2: #5f43dc;     /* other buttons, bottom */

Change the values and every button, window and chip follows. Keep a strong contrast between --gold and --goldink, and between --cream and --panel.

Recipe 2: backgrounds

Replace assets/fundo-w1.webp (landscape, about 1920×1080) and assets/fundo-p1.webp (portrait, about 1080×1920) with your pictures, keeping the names. Worlds 2 and 3 use -w2, -p2, -w3, -p3; the bonus world reuses a darker sky. The picture is cropped to fill the screen, so keep the important part near the centre.

Recipe 3: the character

Lumi is made of four pictures, all facing right, with a transparent background:

  • lumi-cabeca.webp (normal face), lumi-cabeca-feliz.webp (happy, on the result and ending screens), lumi-cabeca-ai.webp (hurt, on spikes);
  • lumi-gomo.webp (one body piece, repeated).

Keep the same picture size and keep the character centred, so the pieces line up. The game mirrors the head when Lumi turns left.

Recipe 4: ground, objects and a new world look

  • Ground: bloco.webp (a square with grass on top) and bloco-pedra.webp (the rock used below the surface). The game repeats the rock as one continuous wall and runs the grass along the top.
  • Worlds 2 and 3 have their own bloco-w2, bloco-pedra-w2, bloco-w3, bloco-pedra-w3.
  • Objects: replace fruta, espinhos, portal-fechado, portal-aberto, botao-solto, botao-press, porta, lanterna-bloco, pedestal.

Keep square pictures square and wide pictures wide: the game scales them, it does not stretch them.

Recipe 6: sounds and music

Replace the .mp3 files, keeping the names.

FileWhen it plays
sfx/step, bump, land, landbigstep, hitting a wall, landing, landing from high
sfx/eat, dropeating a berry (the pitch rises with each one), dropping the tail
sfx/plate, door, doorcloseplate pressed, door opening, door closing
sfx/gate, enter, winportal opens, Lumi enters, level complete
sfx/spike, undo, restart, hintspikes, undo, restart, hint
music/m-menu, music/m-gamemenu, levels (they loop and cross-fade)

Keep effects short (under 1 second) and at a similar loudness.

Recipe 7: texts and languages

  • English and Portuguese texts: js/config.js, inside STR. The other languages: js/i18n.js.
  • Change only the text between the quotes. Keep {n}, {m} and {w}: the game replaces them with numbers.
  • Level names: the name of each level in js/levels.js (English and Portuguese) and the list N in js/i18n.js.

Add a language

  1. In js/i18n.js, copy one language block inside T (for example es: { ... }), give it the new code (for example sv) and translate the texts.
  2. Do the same in N for the level names (optional: a missing name falls back to English).
  3. Add ['sv', 'Svenska'] to LUMI_LANGS at the end of the file.

Long texts are fine: the letters shrink to fit the button.

Recipe 8: change or add levels

Levels are text drawings in js/levels.js; the main guide explains the characters. To add a level, copy one, give it a new id and name, draw it and choose the world. Then, in source/:

npm run solve
npm run answers

The solver says which levels cannot be finished and writes the 3-star target. A world may have more or fewer than 10 levels; the level screen shows them 5 per row.

Recipe 9: hints and rewarded video

In js/config.js, hintsPerLevel is the number of free hints on each level (0 = unlimited). rewardedAd connects your ad network: the main guide has the example.

Recipe 10: speed and game feel

The block FEEL at the top of js/config.js:

NumberEffect
moveMsTime of one step. Smaller = faster game.
squashHow much the body squashes on landing.
trauma, shakeMaxPxScreen shake strength.
hitstopMsThe tiny pause on spikes and on the win.
lightLight radius in dark rooms (lumi, lantern, gate), in cells.
ceremony.pauseMsWait between entering the portal and the result window.

Publish your changed game

  1. Test in source/ with npm start: play a level of each world, on the computer and on a phone.
  2. Run npm test.
  3. Copy the changed files to game/ (or upload source/ without tools/, package.json and documentation/).
  4. Upload, then reload with Ctrl+F5. If you still see the old version, see "Updating the game and clearing the cache" in the main guide.