Honey Ten 1.0.0 · Customization guide · Technical guide (14 languages)

Honey Ten customization guide

Step-by-step recipes to change the look, texts, sounds and levels of Honey Ten, for people who do not program. Every picture is a real screenshot of the game in this package. The technical guide is documentation/index.html.

Before you start

Which file makes which part of the screen

Title screen

Title screen, real screenshot with numbered parts 1 2 3 4 5 6
# What you see File to change
1 Game logo assets/art/logo.webp (recipe A)
2 Bee on the title screen assets/art/bee-big.webp (recipe B)
3 Play button Text: key play in src/locales.js. Look: assets/art/btn-green.webp (recipes E and F)
4 Levels button Text: key levels. Look: assets/art/btn-amber.webp
5 Sound button assets/art/b-music.webp
6 Settings button assets/art/b-gear.webp

World map (world 2, Water Lily Pond)

World map (world 2, Water Lily Pond), real screenshot with numbered parts 1 2 3 4 5 6 7 8 9
# What you see File to change
1 Game logo assets/art/logo.webp (recipe A)
2 World name Keys w1 to w5 in src/locales.js and src/locales-more.js (recipe E)
3 Stars assets/art/star.webp and assets/art/star-off.webp
4 Level stone on the map assets/art/stone.webp and assets/art/stone-now.webp (the current level)
5 World chest assets/art/chest.webp and assets/art/chest-open.webp; what it gives: chestText key
6 Gate to the next world assets/art/gate.webp
7 The bee mascot assets/art/bee-fly.webp on the map, bee-idle.webp and the other poses in a level (recipe B)
8 Play button Text: key play in src/locales.js. Look: assets/art/btn-green.webp (recipes E and F)
9 Map background and trail assets/art/map-land.webp (world 1) and w2-map-land.webp to w5-map-land.webp (recipe D)

A level (level 6, Flower Bed)

A level (level 6, Flower Bed), real screenshot with numbered parts 1 2 3 4 5 6 7 8 9 10 11
# What you see File to change
1 Game logo assets/art/logo.webp (recipe A)
2 Level number Key level in src/locales.js
3 Moves left The limit comes from par and RULES_UI (recipe I)
4 Stars assets/art/star.webp and assets/art/star-off.webp
5 Door (glowing bar) Colors from COLORS in src/config.js (recipe G); position in src/levels.js (recipe J)
6 Honey block assets/art/comb.webp (recipe C); its number and color come from the level (recipe J)
7 Flower on a block assets/art/flower-r.webp to flower-k.webp (recipe C)
8 The bee mascot assets/art/bee-fly.webp on the map, bee-idle.webp and the other poses in a level (recipe B)
9 Board frame and honeycomb tray assets/art/board.webp (recipe C)
10 Power-ups assets/art/p-undo.webp, p-brush.webp, p-shovel.webp, p-plus.webp; rules in RULES_UI (recipe I)
11 Restart and Home assets/art/b-restart.webp and b-home.webp

On a phone held upright the same pieces are arranged in a column (the world and level names are hidden to save room):

A level on a phone held upright, real screenshot
A level on a phone held upright: the same files, another layout.

A. Game name, logo and page title

  1. Logo: draw your logo with a transparent background, about 1200 x 700 pixels, export it as WebP and save it over assets/art/logo.webp. It is used on the title screen and, small, above the map and the level panel.
  2. Line under the logo: open index.html, find <div class="sub"><span>Puzzle</span></div> and change the word Puzzle.
  3. Browser tab title: in index.html change the text between <title> and </title>. The tab icon is the line with rel="icon" (it points to assets/art/jar-r.webp; any small square image works).
  4. The name inside texts (for example the thank-you screen) is the key endText in src/locales.js and src/locales-more.js (recipe E).

B. The bee mascot

The bee is a set of pictures with a transparent background. Replace them with your character in the same poses, each about 500 x 500 pixels, keeping the names:

File in assets/art/ When it shows
bee-idle.webp waiting on the frame
bee-think.webp while a block is being dragged
bee-cheer.webp a jar was made or delivered
bee-oops.webp a sum over 10, a jar with no door, or out of moves
bee-wave.webp when a level starts
bee-push.webp pushing a block (free for your own use; the game shows it only through the test helpers)
bee-big.webp title screen
bee-fly.webp flying along the map
bee-win.webp the win panel

In the code the mascot is called pip (for example the #pip picture and the pipBox that holds it); you do not need to change those names.

C. Honey blocks, jars, flowers and the board

In the code these pieces keep the engine's names: a jar is a gift, a garden rock is ice, a honeycomb block is a pin, a flower bush is a hole and a surprise basket is a box.

D. World backgrounds and maps

Each world has a background for levels and a background for its map, in two shapes: land (wide screens, 1600 x 900 pixels) and port (phones held upright, 900 x 1600 pixels). Keep the important things away from the edges: different screens crop them a little.

World Levels Level background Map background
Flower Bed 1 to 10 bg-land.webp
bg-port.webp
map-land.webp
map-port.webp
Water Lily Pond 11 to 20 w2-bg-land.webp
w2-bg-port.webp
w2-map-land.webp
w2-map-port.webp
Beehive 21 to 30 w3-bg-land.webp
w3-bg-port.webp
w3-map-land.webp
w3-map-port.webp
Sunflower Field 31 to 40 w4-bg-land.webp
w4-bg-port.webp
w4-map-land.webp
w4-map-port.webp
Moonlit Garden 41 to 50 w5-bg-land.webp
w5-bg-port.webp
w5-map-land.webp
w5-map-port.webp
Level of world 2, real screenshot
World 2, Water Lily Pond: w2-bg-land.webp.
Level of world 3, real screenshot
World 3, Beehive: w3-bg-land.webp.
Level of world 4, real screenshot
World 4, Sunflower Field: w4-bg-land.webp.
Level of world 5, real screenshot
World 5, Moonlit Garden: w5-bg-land.webp.

E. Texts, world names and languages

  1. Open src/locales.js. Near the top is the English dictionary: each line is key: 'text'. Change only the text between the quotes.
  2. Keep anything in curly brackets, such as {n} in 'Level {n}': the game puts a number there.
  3. World names are the keys w1 to w5. The tutorial tips are tut1 to tut4 and tutMoves; the new-piece cards use tLock, dLock and the other keys that start with t and d.
  4. Portuguese and Spanish are in the same file; the other 11 languages are in src/locales-more.js. If you change a text in English, change it in the other languages too (or delete that line in a language: the English text is used instead).
  5. If a text contains an apostrophe, write it as \' (for example 'Time\'s up').
Language window, real screenshot
Settings, Language: the player picks one of the 14 languages. The list is LANGS in src/locales.js.

F. Buttons, panels and icons

Level complete panel, real screenshot
Level complete: stars, Next and Replay.
Settings window, real screenshot
Settings during a level.
New piece card, real screenshot
The card that presents a new piece (here the garden rock, rock.webp).
Thank-you screen, real screenshot
After level 50: the thank-you screen (keys endTitle and endText).

G. Block colors

The game uses up to eight colors, each named by a letter. In src/config.js, COLORS gives three shades per color (light, full, dark) used for the doors, the glow and the effects; the pictures of recipe C (jar-* and flower-*) should match them.

Letter Color Pictures
r red jar-r.webp, flower-r.webp
b blue jar-b.webp, flower-b.webp
g green jar-g.webp, flower-g.webp
y yellow jar-y.webp, flower-y.webp
p purple jar-p.webp, flower-p.webp
o orange jar-o.webp, flower-o.webp
t teal jar-t.webp, flower-t.webp
k pink jar-k.webp, flower-k.webp

H. Music and sound effects

Name in SYNTH When it plays
merge two blocks join (the note rises with the sum)
gift a jar is made
exit a jar is delivered
unlock a locked door opens
crack a garden rock cracks
melt a garden rock breaks
reveal a surprise basket opens
bump a sum over 10 does not fit
paint the Brush
shovel the Shovel
undo Undo
star a star on the win panel
win level complete
lose out of moves or time
tick the last seconds of a challenge level
ui_click a button
ui_back closing a window

I. Difficulty: moves, stars and power-ups

All in RULES_UI, in src/config.js:

The feel of the game (springs, shake, particles, vibration) is FEEL in the same file; small changes are safe.

J. Change or add a level

Each level is one line in src/levels.js, grouped by world (10 per world, in the lists W1 to W5). The technical guide explains every field ("Levels and the level generator"). The safest way to make a new level:

  1. Install Node.js and open a terminal in source/ (recipe L).
  2. Run npm run levels -- tools/level-params.example.json 3. It prints 3 new solvable levels, each as a ready line. Open tools/level-params.example.json to choose the board size, how many doors and colors, rocks (ice), bushes (holes), locked doors (locks) and the range of moves (par).
  3. Copy a line over a level in src/levels.js (keep the comma at the end), or add it to the end of a world list.
  4. Run npm test: it solves every level again and tells you if one has no solution or if its par is wrong.
  5. To watch the solution, open http://localhost:5310/?level=7&solution and press Show solution.

K. Font

The game uses Fredoka (SIL Open Font License), in assets/fonts/. To use another font, add its WOFF2 files there and change the @font-face blocks at the top of style.css, keeping font-family: Fredoka or changing that name everywhere in the CSS files. Check that the new font has the letters of all 14 languages, or keep Fredoka for them.

L. Test and publish

  1. Install Node.js 26 LTS (26.13 or newer) from nodejs.org. Open a terminal in the source/ folder.
  2. npm ci then npm test. All tests must pass.
  3. npm run serve and open http://localhost:5310/. Play a level of each world you changed. Ctrl+C stops the server.
  4. npm run build copies the game into source/dist/.
  5. Upload the contents of dist/ to your website over the old files. Delete on the server any file you renamed or removed.
  6. Do not see the change? Clear the browser cache: Ctrl+F5 (Windows) or Cmd+Shift+R (Mac), a private window, or the cache of your host or CDN. The technical guide has a full section on cache.

Help: willian@polargames.com.br, with your purchase code.