Miko Climb

Version 1.0.0 · HTML5 wall-jump climbing arcade game — buyer guide

English

Overview

Miko Climb is a one-button arcade climber. You are Miko, a little monkey with a red bandana climbing between two walls through the jungle. Tap to jump to the other wall, keep holding to cling, tap again in the air to dash. Defeat enemies by jumping through them, collect bananas and purple fruits and reach the banana bunch at the top.

  • 50 levels in 5 worlds of 10, each world adds one new element (new in each world: spikes, toucans, coconut dummies and coconut-throwing rival monkeys; cracked temple stones; bats; armored beetles; ice walls).
  • A boss at the end of every world: Gorilla King, Giant Beehive, Serpent Kite, Shadow Panther, Snow Yeti.
  • 1 to 3 stars per level (clear it, collect all the purple fruits, take no damage); 3 hearts; lantern checkpoints.
  • Endless tower with a best height; a shop with 6 colors for the hero's bandana, bought with the bananas of the levels.
  • 14 interface languages, music, sound effects, vibration, screen shake and reduced-motion options.
  • Portrait and landscape phones, tablets and desktop (mouse or keyboard).
  • Plain HTML, CSS and JavaScript: no compile step, no dependencies, commented code, levels written as text, and a test robot that plays every level.

Install on your website

  1. Unzip the download on your computer.
  2. Upload only the contents of the game/ folder to your web host (FTP, the file manager of your hosting panel, or any static host such as Netlify, GitHub Pages or an S3 bucket). A subfolder works too, for example https://example.com/games/climb/.
  3. Open the address of the folder in a browser. Keep the folder structure exactly as it is.

Do not upload source/, documentation/ or the ZIP to the public game folder. No database, PHP, account or online service is needed.

Requirements

  • Any static web host; HTTPS recommended.
  • A current browser: Chrome, Edge, Firefox, Safari (desktop, Android, iPhone/iPad).
  • The game must be opened through http:// or https://. Opening index.html with a double click (file://) does not work, because browsers block JavaScript modules there. To try it on your computer use npm run serve (section Development).
  • Node.js 26.13.0 or newer is only needed for the optional tools (tests, local server, build).

How to play

  • Tap / click / Space / Up arrow / W: jump to the other wall.
  • Keep holding: cling to the wall when you land (stops climbing).
  • Tap again in the air: dash (the only way to defeat armored enemies).
  • Esc or P: pause / close a panel. Enter or Space also press the main button of a panel.

A wall that glows at its end is about to finish: jump before it. A card explains each new element the first time it appears.

Screens

Title screen1234
Title screen
  1. Play: opens the world map
  2. Settings
  3. Shop: colors of the bandana
  4. Language
World map1234567
World map
  1. Back to the title
  2. World name
  3. Stars of this world
  4. Next level (lanterns: one per level, the 10th is the boss)
  5. Play the next level
  6. Endless tower
  7. Next world (opens after the boss)
A level123456
A level
  1. Hearts (3)
  2. Level number
  3. Bananas of this run
  4. Pause
  5. Height: how far the banana bunch is
  6. Purple fruits of the level (all = 1 star)
Level clear12345
Level clear
  1. Stars: clear + all the purple fruits + no damage
  2. Bananas earned
  3. Next level
  4. Play again
  5. World map
Shop123
Shop
  1. Bananas to spend
  2. Color in use
  3. Other colors: tap to buy, tap again to use
Settings123456
Settings
  1. Sound effects volume
  2. Music volume
  3. Vibration (phones)
  4. Screen shake
  5. Reduced motion
  6. Language

Files in the download

game/                         upload THESE CONTENTS to your web host
  index.html                  entry page: every screen and panel
  style-2.css, style-3.css, style.cssstyles (loaded in this order)
  src/art.js                  image list, loading, color tint, draw helpers
  src/audio.js                sound effects and music
  src/bot.js                  test robot (npm test, ?bot)
  src/config.js               TUNE (rules) and FEEL (effects)
  src/i18n.js                 language choice
  src/levels.js               50 levels + endless tower (text pieces)
  src/locales.js              texts, 14 languages
  src/main.js                 start-up, screens, HUD, input, panels, map, shop
  src/ribbon.js               cloth animation (not shown, kept for reuse)
  src/save.js                 save (miko-climb.template.save.v1)
  src/sim.js                  the rules (no drawing)
  src/view-fx.js              renderer: events, effects, particles
  src/view-world.js           renderer: walls, enemies, items, bosses
  src/view.js                 canvas renderer of a level
  assets/                     images (WebP), music/, sfx/, fonts/ (with licenses)
  DOCUMENTATION.txt           short note pointing to this guide
source/                       the same editable game, plus:
  package.json                npm test, npm run build, npm run serve
  package-lock.json, README.md
  test/                       node --test tests (the robot plays all 50 levels)
  tools/build.mjs             copies the game into source/dist/
  tools/serve.mjs             local test server
documentation/                this guide, the customization guide and their pictures
DOCUMENTATION.html            shortcut to this guide
CUSTOMIZATION.html            shortcut to the customization guide
START-HERE.txt, CHANGELOG.txt
THIRD-PARTY-LICENSES/         font licenses (SIL Open Font License 1.1)

The table of internal names used in the code is in source/README.md and in the customization guide.

Customization

The step-by-step guide for non-programmers is customization.html (CUSTOMIZATION.html in the root of the download). In short:

  • Pictures: replace the WebP files in assets/ with your own, same name and similar size.
  • Texts: src/locales.js (one list per language).
  • Levels: src/levels.js (levels are columns of letters; run npm test and the robot checks that every level can be finished).
  • Difficulty: src/config.js (TUNE: speeds, gravity, hearts, timings).
  • Shop: the 6 colors and prices are in SCARVES (src/art.js).
  • Music and sounds: assets/music/ and assets/sfx/, same file names.

Edit the files in source/, test, then run npm run build and upload the contents of source/dist/. If you do not use Node.js, edit the same files inside game/ directly.

Languages

The game has 14 interface languages: English, Portuguese, Spanish, French, German, Italian, Turkish, Russian, Polish, Indonesian, Japanese, Korean, Chinese and Arabic (right to left). The first visit uses the browser language (English if it is not one of the 14); the player can change it in the settings. ?lang=xx in the address (for example ?lang=ja) forces a language. The translations other than English and Portuguese were not reviewed by native speakers.

To add a language: add a line to LANGS and a list to T in src/locales.js (same order as the keys) and a flag picture assets/flag-xx.webp; npm test checks that every language has every text.

Save data

Progress, stars, bananas, bandana colors and settings are saved in the browser (localStorage) in one entry: miko-climb.template.save.v1 (STORAGE_KEY in src/save.js). Change it if you host more than one copy of the game on the same domain. Clearing the site data of the browser erases the progress.

Development (optional, for beginners)

The game is ready in game/. These steps are only for testing your changes on your computer.

  1. Install Node.js 26.13.0 or newer (the current LTS line) from nodejs.org (Windows and macOS installers; on Linux use your package manager or nvm).
  2. Close and open the terminal again (Windows: PowerShell or Command Prompt; macOS: Terminal) and check:
node --version
npm --version
  1. Go to the source/ folder (the one with package.json), for example cd Downloads/miko-climb-static-1.0.0/source.
  2. Install and test (the project has no dependencies, npm ci only checks the lockfile):
npm ci
npm test
  1. Play your copy: npm run serve and open http://localhost:5197/ (Ctrl+C stops the server).
  2. Build: npm run build writes source/dist/ (a fresh copy of the game every time; files you deleted or renamed disappear from it). Upload the contents of dist/.

Test robot and test shortcuts

npm test runs the robot of src/bot.js on all 50 levels: it looks ahead in the real simulation and must reach the bell (world 1 with no damage). If you edit a level and the robot cannot finish it, the test says which one. On localhost and private network addresses only, the address accepts test options: ?bot (the robot plays in the browser), ?level=12, ?level=endless, ?world=3, ?screen=shop, ?qa (9999 bananas in that browser's save and window.__miko for automated tests). On a public address they are ignored.

http://localhost:5197/?bot&level=12

Common problems

  • node or npm "not recognized": reopen the terminal after installing, or add Node.js to the PATH.
  • Windows PowerShell blocks npm.ps1: run the same command in the Command Prompt (cmd), or npm.cmd test.
  • ENOENT package.json: you are not inside source/.
  • EBADENGINE: update Node.js to 26.13.0 or newer.
  • Port in use: PORT=8080 npm run serve (macOS/Linux) or set PORT=8080 && npm run serve (Windows cmd).

Updates and browser cache

After you upload a new version, a browser may still show the old files from its cache:

  • Force a reload: Ctrl+F5 (Windows), Cmd+Shift+R (macOS); on phones close the tab and open it again.
  • Clear only the cached images and files in the browser settings (do not clear cookies and site data if you want to keep the progress).
  • Try a private window to see the new version at once.
  • Purge the cache of your host or CDN (Cloudflare and similar) if you use one.
  • Add a version to the address, for example index.html?v=2, to bypass old copies.

Licenses

Fonts: Fredoka and Kaushan Script, SIL Open Font License 1.1 (files in THIRD-PARTY-LICENSES/ and assets/fonts/). The game code, pictures, music and sound effects are part of this item and are covered by the license you bought on CodeCanyon. No third-party JavaScript library is used.

Troubleshooting

  • Black or empty page: the game was opened from file://, or a file is missing. Open it through a web address and keep the folder structure.
  • No sound: browsers start audio only after the first touch (the "tap to start" screen does it); check the volume in the settings and the silent switch of the phone.
  • Old version after an update: see Updates and browser cache.
  • Progress lost: private windows and cleared site data do not keep the save.

FAQ

Can I put it on my site or in an app? Yes, within the CodeCanyon license you bought; it is a static web page, so it also works inside a WebView.

Do I need to know JavaScript? No for pictures, texts, sounds and colors (customization guide); levels are plain text with a legend.

Does it work offline? Once loaded it needs no server; it makes no request to other sites.

Support

Questions, problems or custom development: willian@polargames.com.br. Please include the item name, the browser and device, the address of your copy (if online) and a screenshot of the problem.

Português

Visão geral

Miko Climb é um jogo arcade de escalada de um botão só. Você é o Miko, um macaquinho de bandana vermelha que sobe entre duas paredes pela selva. Toque para saltar para a outra parede, continue segurando para se agarrar, toque de novo no ar para o impulso. Derrube os inimigos saltando através deles, pegue as bananas e as frutas roxas e chegue a o cacho de bananas no alto.

  • 50 fases em 5 mundos de 10; cada mundo traz um elemento novo (espinhos, tucanos, bonecos de coco e macacos rivais que jogam cocos; pedras rachadas do templo; morcegos; besouros de armadura; paredes de gelo).
  • Um chefe no fim de cada mundo: Gorilla King, Giant Beehive, Serpent Kite, Shadow Panther, Snow Yeti.
  • De 1 a 3 estrelas por fase (terminar, pegar todas as frutas roxas, não levar dano); 3 corações; lanternas de checkpoint.
  • Torre sem fim com recorde de altura; loja com 6 cores de bandana do herói, compradas com as bananas das fases.
  • 14 idiomas na interface, música, efeitos sonoros, vibração, tremor de tela e opção de menos movimento.
  • Celular em pé e deitado, tablet e computador (mouse ou teclado).
  • HTML, CSS e JavaScript puros: sem etapa de compilação, sem dependências, código comentado, fases escritas como texto e um robô de teste que joga todas as fases.

Instalar no seu site

  1. Descompacte o download no computador.
  2. Envie só o conteúdo da pasta game/ para a hospedagem (FTP, gerenciador de arquivos do painel ou qualquer hospedagem estática como Netlify, GitHub Pages ou S3). Pode ser numa subpasta, por exemplo https://exemplo.com/jogos/climb/.
  3. Abra o endereço da pasta no navegador. Mantenha a estrutura de pastas como está.

Não envie source/, documentation/ nem o ZIP para a pasta pública do jogo. Não precisa de banco de dados, PHP, conta nem serviço online.

Requisitos

  • Qualquer hospedagem estática; HTTPS recomendado.
  • Navegador atual: Chrome, Edge, Firefox, Safari (computador, Android, iPhone/iPad).
  • O jogo precisa ser aberto por http:// ou https://. Abrir o index.html com dois cliques (file://) não funciona, porque o navegador bloqueia módulos JavaScript assim. Para testar no computador use npm run serve (seção Desenvolvimento).
  • Node.js 26.13.0 ou mais novo só é preciso para as ferramentas opcionais (testes, servidor local, build).

Como jogar

  • Toque / clique / Espaço / seta para cima / W: salta para a outra parede.
  • Continuar segurando: agarra na parede ao pousar (para de subir).
  • Tocar de novo no ar: o impulso (o único jeito de derrubar inimigos de armadura).
  • Esc ou P: pausa / fecha uma janela. Enter ou Espaço também apertam o botão principal da janela.

A parede que brilha na ponta está acabando: salte antes. Um cartão explica cada elemento novo na primeira vez.

Telas

Abertura1234
Abertura
  1. Jogar: abre o mapa dos mundos
  2. Ajustes
  3. Loja: cores de bandana
  4. Idioma
Mapa do mundo1234567
Mapa do mundo
  1. Volta para a abertura
  2. Nome do mundo
  3. Estrelas deste mundo
  4. Próxima fase (lanternas: uma por fase, a 10ª é o chefe)
  5. Joga a próxima fase
  6. Torre sem fim
  7. Próximo mundo (abre depois do chefe)
Uma fase123456
Uma fase
  1. Corações (3)
  2. Número da fase
  3. Bananas desta partida
  4. Pausa
  5. Altura: quanto falta para o cacho de bananas
  6. Frutas roxas da fase (todas = 1 estrela)
Fase concluída12345
Fase concluída
  1. Estrelas: terminar + todas as frutas roxas + sem dano
  2. Bananas ganhas
  3. Próxima fase
  4. Jogar de novo
  5. Mapa
Loja123
Loja
  1. Bananas para gastar
  2. Cor em uso
  3. Outras cores: toque para comprar, toque de novo para usar
Ajustes123456
Ajustes
  1. Volume dos efeitos
  2. Volume da música
  3. Vibração (celular)
  4. Tremor de tela
  5. Menos movimento
  6. Idioma

Arquivos do download

game/                         upload THESE CONTENTS to your web host
  index.html                  entry page: every screen and panel
  style-2.css, style-3.css, style.cssstyles (loaded in this order)
  src/art.js                  image list, loading, color tint, draw helpers
  src/audio.js                sound effects and music
  src/bot.js                  test robot (npm test, ?bot)
  src/config.js               TUNE (rules) and FEEL (effects)
  src/i18n.js                 language choice
  src/levels.js               50 levels + endless tower (text pieces)
  src/locales.js              texts, 14 languages
  src/main.js                 start-up, screens, HUD, input, panels, map, shop
  src/ribbon.js               cloth animation (not shown, kept for reuse)
  src/save.js                 save (miko-climb.template.save.v1)
  src/sim.js                  the rules (no drawing)
  src/view-fx.js              renderer: events, effects, particles
  src/view-world.js           renderer: walls, enemies, items, bosses
  src/view.js                 canvas renderer of a level
  assets/                     images (WebP), music/, sfx/, fonts/ (with licenses)
  DOCUMENTATION.txt           short note pointing to this guide
source/                       the same editable game, plus:
  package.json                npm test, npm run build, npm run serve
  package-lock.json, README.md
  test/                       node --test tests (the robot plays all 50 levels)
  tools/build.mjs             copies the game into source/dist/
  tools/serve.mjs             local test server
documentation/                this guide, the customization guide and their pictures
DOCUMENTATION.html            shortcut to this guide
CUSTOMIZATION.html            shortcut to the customization guide
START-HERE.txt, CHANGELOG.txt
THIRD-PARTY-LICENSES/         font licenses (SIL Open Font License 1.1)

A tabela de nomes internos do código está no source/README.md e no guia de personalização.

Personalização

O guia passo a passo para quem não programa é o customization.html (CUSTOMIZATION.html na raiz do download, em inglês). Resumo:

  • Imagens: troque os WebP de assets/ pelos seus, mesmo nome e tamanho parecido.
  • Textos: src/locales.js (uma lista por idioma).
  • Fases: src/levels.js (cada fase é uma coluna de letras; rode npm test e o robô confere se todas dão para terminar).
  • Dificuldade: src/config.js (TUNE: velocidades, gravidade, corações, tempos).
  • Loja: as 6 cores e preços ficam em SCARVES (src/art.js).
  • Música e sons: assets/music/ e assets/sfx/, mesmos nomes de arquivo.

Edite os arquivos de source/, teste, rode npm run build e envie o conteúdo de source/dist/. Sem Node.js, edite os mesmos arquivos direto dentro de game/.

Idiomas

O jogo tem 14 idiomas: inglês, português, espanhol, francês, alemão, italiano, turco, russo, polonês, indonésio, japonês, coreano, chinês e árabe (da direita para a esquerda). Na primeira visita usa o idioma do navegador (inglês se não for um dos 14); o jogador troca nos ajustes. ?lang=xx no endereço (por exemplo ?lang=ja) força um idioma. As traduções além de inglês e português não foram revisadas por falantes nativos.

Para acrescentar um idioma: uma linha em LANGS e uma lista em T no src/locales.js (na ordem das chaves) e a bandeira assets/flag-xx.webp; o npm test confere se todo idioma tem todos os textos.

Progresso salvo

Progresso, estrelas, bananas, cores de bandana e ajustes ficam no navegador (localStorage) numa entrada só: miko-climb.template.save.v1 (STORAGE_KEY em src/save.js). Troque se hospedar mais de uma cópia do jogo no mesmo domínio. Limpar os dados do site no navegador apaga o progresso.

Desenvolvimento (opcional, para iniciantes)

O jogo pronto está em game/. Estes passos só servem para testar mudanças no computador.

  1. Instale o Node.js 26.13.0 ou mais novo (linha LTS atual) em nodejs.org (instaladores para Windows e macOS; no Linux use o gerenciador de pacotes ou o nvm).
  2. Feche e abra de novo o terminal (Windows: PowerShell ou Prompt de Comando; macOS: Terminal) e confira:
node --version
npm --version
  1. Entre na pasta source/ (a que tem o package.json), por exemplo cd Downloads/miko-climb-static-1.0.0/source.
  2. Instale e teste (o projeto não tem dependências; o npm ci só confere o lockfile):
npm ci
npm test
  1. Jogue a sua cópia: npm run serve e abra http://localhost:5197/ (Ctrl+C para o servidor).
  2. Build: npm run build grava source/dist/ (cópia nova do jogo a cada vez; arquivos apagados ou renomeados somem dela). Envie o conteúdo de dist/.

Robô de teste e atalhos de teste

O npm test põe o robô de src/bot.js para jogar as 50 fases: ele olha o futuro na simulação real e precisa chegar ao sino (mundo 1 sem dano). Se você mudar uma fase e o robô não conseguir terminar, o teste diz qual. Só em localhost e endereços de rede privada o endereço aceita opções de teste: ?bot (o robô joga no navegador), ?level=12, ?level=endless, ?world=3, ?screen=shop, ?qa (9999 bananas no save daquele navegador e window.__miko para testes automáticos). Em endereço público elas são ignoradas.

http://localhost:5197/?bot&level=12

Problemas comuns

  • node ou npm "não reconhecido": reabra o terminal depois de instalar ou ponha o Node.js no PATH.
  • O PowerShell bloqueia o npm.ps1: rode o mesmo comando no Prompt de Comando (cmd) ou npm.cmd test.
  • ENOENT package.json: você não está dentro de source/.
  • EBADENGINE: atualize o Node.js para 26.13.0 ou mais novo.
  • Porta ocupada: PORT=8080 npm run serve (macOS/Linux) ou set PORT=8080 && npm run serve (cmd do Windows).

Atualizações e cache do navegador

Depois de enviar uma versão nova, o navegador pode continuar mostrando os arquivos antigos do cache:

  • Recarga forçada: Ctrl+F5 (Windows), Cmd+Shift+R (macOS); no celular feche a aba e abra de novo.
  • Limpe só as imagens e arquivos em cache nos ajustes do navegador (não limpe cookies e dados do site se quiser manter o progresso).
  • Abra numa janela anônima para ver a versão nova na hora.
  • Limpe o cache da hospedagem ou da CDN (Cloudflare e parecidas), se usar.
  • Ponha uma versão no endereço, por exemplo index.html?v=2, para escapar de cópias antigas.

Licenças

Fontes: Fredoka e Kaushan Script, SIL Open Font License 1.1 (arquivos em THIRD-PARTY-LICENSES/ e assets/fonts/). O código, as imagens, a música e os efeitos sonoros fazem parte deste item e seguem a licença comprada na CodeCanyon. Nenhuma biblioteca JavaScript de terceiros é usada.

Solução de problemas

  • Página preta ou vazia: o jogo foi aberto por file:// ou falta um arquivo. Abra por um endereço web e mantenha a estrutura de pastas.
  • Sem som: o navegador só libera o áudio depois do primeiro toque (a tela "toque para começar" faz isso); confira o volume nos ajustes e a chave de silencioso do celular.
  • Versão antiga depois de atualizar: veja Atualizações e cache do navegador.
  • Progresso perdido: janela anônima e dados do site apagados não guardam o save.

Perguntas frequentes

Posso pôr no meu site ou num app? Sim, dentro da licença CodeCanyon comprada; é uma página web estática, então também funciona dentro de uma WebView.

Preciso saber JavaScript? Não para imagens, textos, sons e cores (guia de personalização); as fases são texto simples com legenda.

Funciona offline? Depois de carregado não precisa de servidor; não faz requisição a outros sites.

Suporte

Dúvidas, problemas ou desenvolvimento sob medida: willian@polargames.com.br. Informe o nome do item, o navegador e o aparelho, o endereço da sua cópia (se estiver online) e uma captura do problema.

Español

Resumen

Miko Climb es un juego arcade de escalada de un solo botón. Eres Miko, un monito con bandana roja que sube entre dos paredes por la selva. Toca para saltar a la otra pared, mantén pulsado para agarrarte, toca otra vez en el aire para el impulso. Derrota a los enemigos saltando a través de ellos, recoge las plátanos y las frutas moradas y llega a el racimo de plátanos de arriba.

  • 50 niveles en 5 mundos de 10; cada mundo añade un elemento nuevo (pinchos, tucanes, muñecos de coco y monos rivales que lanzan cocos; piedras agrietadas del templo; murciélagos; escarabajos con armadura; paredes de hielo).
  • Un jefe al final de cada mundo: Gorilla King, Giant Beehive, Serpent Kite, Shadow Panther, Snow Yeti.
  • De 1 a 3 estrellas por nivel (terminarlo, recoger todas las frutas moradas, no recibir daño); 3 corazones; faroles de control.
  • Torre infinita con récord de altura; tienda con 6 colores de bandana del héroe, comprados con las plátanos de los niveles.
  • 14 idiomas de interfaz, música, efectos de sonido, vibración, temblor de pantalla y opción de menos movimiento.
  • Móvil vertical y horizontal, tableta y ordenador (ratón o teclado).
  • HTML, CSS y JavaScript puros: sin paso de compilación, sin dependencias, código comentado, niveles escritos como texto y un robot de prueba que juega todos los niveles.

Instalar en tu web

  1. Descomprime la descarga en tu ordenador.
  2. Sube solo el contenido de la carpeta game/ a tu alojamiento (FTP, el administrador de archivos del panel o cualquier alojamiento estático como Netlify, GitHub Pages o S3). Puede ir en una subcarpeta, por ejemplo https://ejemplo.com/juegos/climb/.
  3. Abre la dirección de la carpeta en el navegador. Mantén la estructura de carpetas tal cual.

No subas source/, documentation/ ni el ZIP a la carpeta pública del juego. No hace falta base de datos, PHP, cuenta ni servicio en línea.

Requisitos

  • Cualquier alojamiento estático; se recomienda HTTPS.
  • Un navegador actual: Chrome, Edge, Firefox, Safari (ordenador, Android, iPhone/iPad).
  • El juego debe abrirse por http:// o https://. Abrir index.html con doble clic (file://) no funciona, porque el navegador bloquea ahí los módulos JavaScript. Para probarlo en tu ordenador usa npm run serve (sección Desarrollo).
  • Node.js 26.13.0 o posterior solo hace falta para las herramientas opcionales (pruebas, servidor local, build).

Cómo se juega

  • Tocar / clic / Espacio / flecha arriba / W: salta a la otra pared.
  • Mantener pulsado: se agarra a la pared al aterrizar (deja de subir).
  • Tocar otra vez en el aire: el impulso (la única forma de derrotar a los enemigos con armadura).
  • Esc o P: pausa / cierra un panel. Enter o Espacio también pulsan el botón principal del panel.

Una pared que brilla en su extremo se está acabando: salta antes. Una tarjeta explica cada elemento nuevo la primera vez.

Pantallas

Pantalla de título1234
Pantalla de título
  1. Jugar: abre el mapa de mundos
  2. Ajustes
  3. Tienda: colores de bandana
  4. Idioma
Mapa del mundo1234567
Mapa del mundo
  1. Volver al título
  2. Nombre del mundo
  3. Estrellas de este mundo
  4. Siguiente nivel (faroles: uno por nivel, el 10.º es el jefe)
  5. Jugar el siguiente nivel
  6. Torre infinita
  7. Siguiente mundo (se abre tras el jefe)
Un nivel123456
Un nivel
  1. Corazones (3)
  2. Número de nivel
  3. Plátanos de esta partida
  4. Pausa
  5. Altura: cuánto falta para el racimo de plátanos
  6. Frutas moradas del nivel (todas = 1 estrella)
Nivel superado12345
Nivel superado
  1. Estrellas: terminar + todas las frutas moradas + sin daño
  2. Plátanos ganadas
  3. Siguiente nivel
  4. Jugar otra vez
  5. Mapa
Tienda123
Tienda
  1. Plátanos para gastar
  2. Color en uso
  3. Otros colores: toca para comprar, toca otra vez para usar
Ajustes123456
Ajustes
  1. Volumen de efectos
  2. Volumen de música
  3. Vibración (móvil)
  4. Temblor de pantalla
  5. Menos movimiento
  6. Idioma

Archivos de la descarga

game/                         upload THESE CONTENTS to your web host
  index.html                  entry page: every screen and panel
  style-2.css, style-3.css, style.cssstyles (loaded in this order)
  src/art.js                  image list, loading, color tint, draw helpers
  src/audio.js                sound effects and music
  src/bot.js                  test robot (npm test, ?bot)
  src/config.js               TUNE (rules) and FEEL (effects)
  src/i18n.js                 language choice
  src/levels.js               50 levels + endless tower (text pieces)
  src/locales.js              texts, 14 languages
  src/main.js                 start-up, screens, HUD, input, panels, map, shop
  src/ribbon.js               cloth animation (not shown, kept for reuse)
  src/save.js                 save (miko-climb.template.save.v1)
  src/sim.js                  the rules (no drawing)
  src/view-fx.js              renderer: events, effects, particles
  src/view-world.js           renderer: walls, enemies, items, bosses
  src/view.js                 canvas renderer of a level
  assets/                     images (WebP), music/, sfx/, fonts/ (with licenses)
  DOCUMENTATION.txt           short note pointing to this guide
source/                       the same editable game, plus:
  package.json                npm test, npm run build, npm run serve
  package-lock.json, README.md
  test/                       node --test tests (the robot plays all 50 levels)
  tools/build.mjs             copies the game into source/dist/
  tools/serve.mjs             local test server
documentation/                this guide, the customization guide and their pictures
DOCUMENTATION.html            shortcut to this guide
CUSTOMIZATION.html            shortcut to the customization guide
START-HERE.txt, CHANGELOG.txt
THIRD-PARTY-LICENSES/         font licenses (SIL Open Font License 1.1)

La tabla de nombres internos del código está en source/README.md y en la guía de personalización.

Personalización

La guía paso a paso para quien no programa es customization.html (CUSTOMIZATION.html en la raíz de la descarga, en inglés). En resumen:

  • Imágenes: cambia los WebP de assets/ por los tuyos, mismo nombre y tamaño parecido.
  • Textos: src/locales.js (una lista por idioma).
  • Niveles: src/levels.js (cada nivel son columnas de letras; ejecuta npm test y el robot comprueba que todos se pueden terminar).
  • Dificultad: src/config.js (TUNE: velocidades, gravedad, corazones, tiempos).
  • Tienda: los 6 colores y precios están en SCARVES (src/art.js).
  • Música y sonidos: assets/music/ y assets/sfx/, mismos nombres de archivo.

Edita los archivos de source/, prueba, ejecuta npm run build y sube el contenido de source/dist/. Sin Node.js, edita los mismos archivos directamente dentro de game/.

Idiomas

El juego tiene 14 idiomas: inglés, portugués, español, francés, alemán, italiano, turco, ruso, polaco, indonesio, japonés, coreano, chino y árabe (de derecha a izquierda). En la primera visita usa el idioma del navegador (inglés si no es uno de los 14); el jugador lo cambia en los ajustes. ?lang=xx en la dirección (por ejemplo ?lang=ja) fuerza un idioma. Las traducciones aparte del inglés y el portugués no fueron revisadas por hablantes nativos.

Para añadir un idioma: una línea en LANGS y una lista en T de src/locales.js (en el orden de las claves) y la bandera assets/flag-xx.webp; npm test comprueba que cada idioma tenga todos los textos.

Datos guardados

Progreso, estrellas, plátanos, colores de bandana y ajustes se guardan en el navegador (localStorage) en una sola entrada: miko-climb.template.save.v1 (STORAGE_KEY en src/save.js). Cámbiala si alojas más de una copia del juego en el mismo dominio. Borrar los datos del sitio en el navegador borra el progreso.

Desarrollo (opcional, para principiantes)

El juego listo está en game/. Estos pasos solo sirven para probar cambios en tu ordenador.

  1. Instala Node.js 26.13.0 o posterior (la línea LTS actual) desde nodejs.org (instaladores para Windows y macOS; en Linux usa tu gestor de paquetes o nvm).
  2. Cierra y abre otra vez la terminal (Windows: PowerShell o Símbolo del sistema; macOS: Terminal) y comprueba:
node --version
npm --version
  1. Entra en la carpeta source/ (la que tiene package.json), por ejemplo cd Downloads/miko-climb-static-1.0.0/source.
  2. Instala y prueba (el proyecto no tiene dependencias; npm ci solo comprueba el lockfile):
npm ci
npm test
  1. Juega tu copia: npm run serve y abre http://localhost:5197/ (Ctrl+C detiene el servidor).
  2. Build: npm run build escribe source/dist/ (una copia nueva del juego cada vez; los archivos borrados o renombrados desaparecen de ella). Sube el contenido de dist/.

Robot de prueba y atajos de prueba

npm test pone al robot de src/bot.js a jugar los 50 niveles: mira el futuro en la simulación real y debe llegar a la campana (mundo 1 sin daño). Si cambias un nivel y el robot no puede terminarlo, la prueba dice cuál. Solo en localhost y direcciones de red privada la dirección acepta opciones de prueba: ?bot (el robot juega en el navegador), ?level=12, ?level=endless, ?world=3, ?screen=shop, ?qa (9999 plátanos en el guardado de ese navegador y window.__miko para pruebas automáticas). En una dirección pública se ignoran.

http://localhost:5197/?bot&level=12

Problemas comunes

  • node o npm "no se reconoce": reabre la terminal después de instalar o añade Node.js al PATH.
  • PowerShell bloquea npm.ps1: ejecuta el mismo comando en el Símbolo del sistema (cmd) o npm.cmd test.
  • ENOENT package.json: no estás dentro de source/.
  • EBADENGINE: actualiza Node.js a 26.13.0 o posterior.
  • Puerto ocupado: PORT=8080 npm run serve (macOS/Linux) o set PORT=8080 && npm run serve (cmd de Windows).

Actualizaciones y caché del navegador

Después de subir una versión nueva, el navegador puede seguir mostrando los archivos antiguos de su caché:

  • Recarga forzada: Ctrl+F5 (Windows), Cmd+Shift+R (macOS); en el móvil cierra la pestaña y ábrela otra vez.
  • Borra solo las imágenes y archivos en caché en los ajustes del navegador (no borres cookies ni datos del sitio si quieres conservar el progreso).
  • Abre una ventana privada para ver la versión nueva al momento.
  • Purga la caché de tu alojamiento o CDN (Cloudflare y similares), si usas uno.
  • Añade una versión a la dirección, por ejemplo index.html?v=2, para evitar copias antiguas.

Licencias

Fuentes: Fredoka y Kaushan Script, SIL Open Font License 1.1 (archivos en THIRD-PARTY-LICENSES/ y assets/fonts/). El código, las imágenes, la música y los efectos de sonido forman parte de este artículo y siguen la licencia comprada en CodeCanyon. No se usa ninguna biblioteca JavaScript de terceros.

Solución de problemas

  • Página negra o vacía: el juego se abrió desde file:// o falta un archivo. Ábrelo por una dirección web y mantén la estructura de carpetas.
  • Sin sonido: el navegador solo activa el audio después del primer toque (la pantalla "toca para empezar" lo hace); revisa el volumen en los ajustes y el modo silencio del móvil.
  • Versión antigua después de actualizar: mira Actualizaciones y caché del navegador.
  • Progreso perdido: las ventanas privadas y los datos del sitio borrados no guardan la partida.

Preguntas frecuentes

¿Puedo ponerlo en mi web o en una app? Sí, dentro de la licencia de CodeCanyon que compraste; es una página web estática, así que también funciona dentro de una WebView.

¿Necesito saber JavaScript? No para imágenes, textos, sonidos y colores (guía de personalización); los niveles son texto simple con leyenda.

¿Funciona sin conexión? Una vez cargado no necesita servidor; no hace peticiones a otros sitios.

Soporte

Dudas, problemas o desarrollo a medida: willian@polargames.com.br. Indica el nombre del artículo, el navegador y el dispositivo, la dirección de tu copia (si está en línea) y una captura del problema.