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
- Unzip the download on your computer.
-
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 examplehttps://example.com/games/climb/. - 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://orhttps://. Openingindex.htmlwith a double click (file://) does not work, because browsers block JavaScript modules there. To try it on your computer usenpm 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
1234
- Play: opens the world map
- Settings
- Shop: colors of the bandana
- Language
1234567
- Back to the title
- World name
- Stars of this world
- Next level (lanterns: one per level, the 10th is the boss)
- Play the next level
- Endless tower
- Next world (opens after the boss)
123456
- Hearts (3)
- Level number
- Bananas of this run
- Pause
- Height: how far the banana bunch is
- Purple fruits of the level (all = 1 star)
12345
- Stars: clear + all the purple fruits + no damage
- Bananas earned
- Next level
- Play again
- World map
123
- Bananas to spend
- Color in use
- Other colors: tap to buy, tap again to use
123456
- Sound effects volume
- Music volume
- Vibration (phones)
- Screen shake
- Reduced motion
- Language
Screenshot gallery
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; runnpm testand 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/andassets/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.
- 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).
- Close and open the terminal again (Windows: PowerShell or Command Prompt; macOS: Terminal) and check:
node --version npm --version
-
Go to the
source/folder (the one withpackage.json), for examplecd Downloads/miko-climb-static-1.0.0/source. - Install and test (the project has no dependencies,
npm cionly checks the lockfile):
npm ci npm test
-
Play your copy:
npm run serveand openhttp://localhost:5197/(Ctrl+C stops the server). -
Build:
npm run buildwritessource/dist/(a fresh copy of the game every time; files you deleted or renamed disappear from it). Upload the contents ofdist/.
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
-
nodeornpm"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), ornpm.cmd test. ENOENT package.json: you are not insidesource/.EBADENGINE: update Node.js to 26.13.0 or newer.-
Port in use:
PORT=8080 npm run serve(macOS/Linux) orset 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
- Descompacte o download no computador.
-
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 exemplohttps://exemplo.com/jogos/climb/. - 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://ouhttps://. Abrir oindex.htmlcom dois cliques (file://) não funciona, porque o navegador bloqueia módulos JavaScript assim. Para testar no computador usenpm 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
1234
- Jogar: abre o mapa dos mundos
- Ajustes
- Loja: cores de bandana
- Idioma
1234567
- Volta para a abertura
- Nome do mundo
- Estrelas deste mundo
- Próxima fase (lanternas: uma por fase, a 10ª é o chefe)
- Joga a próxima fase
- Torre sem fim
- Próximo mundo (abre depois do chefe)
123456
- Corações (3)
- Número da fase
- Bananas desta partida
- Pausa
- Altura: quanto falta para o cacho de bananas
- Frutas roxas da fase (todas = 1 estrela)
12345
- Estrelas: terminar + todas as frutas roxas + sem dano
- Bananas ganhas
- Próxima fase
- Jogar de novo
- Mapa
123
- Bananas para gastar
- Cor em uso
- Outras cores: toque para comprar, toque de novo para usar
123456
- Volume dos efeitos
- Volume da música
- Vibração (celular)
- Tremor de tela
- Menos movimento
- Idioma
Galeria de capturas
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; rodenpm teste 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/eassets/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.
- 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).
- Feche e abra de novo o terminal (Windows: PowerShell ou Prompt de Comando; macOS: Terminal) e confira:
node --version npm --version
-
Entre na pasta
source/(a que tem opackage.json), por exemplocd Downloads/miko-climb-static-1.0.0/source. - Instale e teste (o projeto não tem dependências; o
npm cisó confere o lockfile):
npm ci npm test
-
Jogue a sua cópia:
npm run servee abrahttp://localhost:5197/(Ctrl+C para o servidor). -
Build:
npm run buildgravasource/dist/(cópia nova do jogo a cada vez; arquivos apagados ou renomeados somem dela). Envie o conteúdo dedist/.
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
-
nodeounpm"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) ounpm.cmd test. ENOENT package.json: você não está dentro desource/.EBADENGINE: atualize o Node.js para 26.13.0 ou mais novo.-
Porta ocupada:
PORT=8080 npm run serve(macOS/Linux) ouset 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
- Descomprime la descarga en tu ordenador.
-
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 ejemplohttps://ejemplo.com/juegos/climb/. - 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://ohttps://. Abririndex.htmlcon doble clic (file://) no funciona, porque el navegador bloquea ahí los módulos JavaScript. Para probarlo en tu ordenador usanpm 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
1234
- Jugar: abre el mapa de mundos
- Ajustes
- Tienda: colores de bandana
- Idioma
1234567
- Volver al título
- Nombre del mundo
- Estrellas de este mundo
- Siguiente nivel (faroles: uno por nivel, el 10.º es el jefe)
- Jugar el siguiente nivel
- Torre infinita
- Siguiente mundo (se abre tras el jefe)
123456
- Corazones (3)
- Número de nivel
- Plátanos de esta partida
- Pausa
- Altura: cuánto falta para el racimo de plátanos
- Frutas moradas del nivel (todas = 1 estrella)
12345
- Estrellas: terminar + todas las frutas moradas + sin daño
- Plátanos ganadas
- Siguiente nivel
- Jugar otra vez
- Mapa
123
- Plátanos para gastar
- Color en uso
- Otros colores: toca para comprar, toca otra vez para usar
123456
- Volumen de efectos
- Volumen de música
- Vibración (móvil)
- Temblor de pantalla
- Menos movimiento
- Idioma
Galería de capturas
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; ejecutanpm testy 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/yassets/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.
- 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).
- Cierra y abre otra vez la terminal (Windows: PowerShell o Símbolo del sistema; macOS: Terminal) y comprueba:
node --version npm --version
-
Entra en la carpeta
source/(la que tienepackage.json), por ejemplocd Downloads/miko-climb-static-1.0.0/source. -
Instala y prueba (el proyecto no tiene dependencias;
npm cisolo comprueba el lockfile):
npm ci npm test
-
Juega tu copia:
npm run servey abrehttp://localhost:5197/(Ctrl+C detiene el servidor). -
Build:
npm run buildescribesource/dist/(una copia nueva del juego cada vez; los archivos borrados o renombrados desaparecen de ella). Sube el contenido dedist/.
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
-
nodeonpm"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) onpm.cmd test. ENOENT package.json: no estás dentro desource/.EBADENGINE: actualiza Node.js a 26.13.0 o posterior.-
Puerto ocupado:
PORT=8080 npm run serve(macOS/Linux) oset 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.