Monkey King: Mountain-Sea Temple
An isometric action-RPG for the web, inspired by the "Black Myth: Wukong Mobile" gameplay footage
(see PLAN.md for the frame analysis). It runs on PC and mobile and works fully offline.
Characters are animated with motion-captured clips from free CC0 asset packs, dressed with costumes built
in code. Foliage uses a CC0 nature kit. VFX and Web Audio sound are made in code. No assets were taken
from the reference video. See Credits below.
Play
- Online: GitHub Pages. After the first visit, the service worker caches everything so it works offline.
You can also install it as an app from the browser menu ("Install app" / "Add to Home Screen").
- Fully offline: the build is a single self-contained
index.html. Download it (or the
monkey-king-offline artifact from the Actions run) and open it directly in a browser. No server is needed.
Controls
| Keyboard & mouse | Touch | Gamepad / joystick |
|---|
| Move | WASD / arrows | Left joystick | Left stick |
| Aim | Mouse | Auto-aim | Right stick |
| Staff combo (4 hits) | Left click (hold) | Big button (hold) | X |
| Heavy smash (hold to charge, spends Focus) | Right click (hold) | Hammer button (hold) | Y |
| Dodge roll (perfect dodge = slow-mo + Focus) | Space | Dodge button | A |
| Healing gourd | G | Gourd button | B |
| Spells (4 slots) | 1–4 | Spell buttons | LB RB LT RT |
| Monkey King form | T | Monkey button | R3 / D-pad up |
| Menu / pause | I / Esc | Top buttons | Back / Start |
| Menus | Arrows, Enter, Q/E tabs | Tap | Stick/D-pad, A, B, LB/RB |
What's in the game
- Look: a retro pixel render (low-res world, dithered limited palette, outlines) or smooth, in Settings.
- Camera styles: Isometric, Third person, Side view (2D) and Cinematic. Switch any time with C (or Settings, or d-pad down).
Tall props and foliage between the camera and the hero dissolve in every style.
- Three chapters, three hand-designed maps: the Black Wind Forest (lush forest valley, mountain ridges, Mirror Pond and a
stream crossed by a plank bridge, a ruined temple up two flights of stairs), the Yellow Wind Ridge (dunes, a sandstone canyon,
a wind cave, a switchback climb to a ruined fort and wind-carved arches) and the Frozen Bone Sanctum (a walkable frozen lake,
ice cliffs, snowy pines, rib-vaulted bone halls). Each has its own terrain, elevation, paths, palette, weather, enemy roster
(no spiders outside chapter one), boss and story beats.
- Travel and save: every Keeper's Shrine you light can be fast-travelled to from the Travel tab; chapters you unlock can be revisited.
Progress is saved per chapter.
- Gear you can see: equipped staffs, armour, gloves, boots and relics change the hero, and every item has its own 3D pixel icon.
- Checkpoints: a Keeper's Shrine in every area. Walk up to it to heal, refill the gourd, save and set your respawn point.
- Exploration: side paths, hidden groves and ledges off the critical path, one-way shortcut gates, secrets behind breakable
rubble, spirit herbs, relic shards and lore notes, and chests in three kinds — normal, ornate (more and better loot) and
sealed ones that open only once you beat the elite guarding them or light every brazier of their puzzle. Opened chests and
taken collectables stay that way, saved per chapter.
- Chapter 1: six areas (Black Wind Forest → Mirror Pond Glade → Old Pine Hollow → Temple Courtyard → Upper Terrace → boss arena), plus
in-engine cutscenes for the chapter intro, the boss entrance and the victory. Cutscenes can be skipped with any button.
- Combat:
- Keyframed animations with wind-up, strike and follow-through, and weapon motion trails
- A 4-hit staff combo; a charged heavy smash that spends Focus to stagger enemies and break bosses
- Dodge roll with perfect-dodge slow motion; a healing gourd that refills at cleared areas
- Spells: Golden Whirlwind, Flaming Staff, Cloud Slam, Jade Gale, Immobilize and Ring of Fire (four slots).
The Monkey King transformation is powered by a Fury meter.
Credits
- Quaternius (CC0): Universal Animation Library 1 & 2 (mocap clips), Universal Base Characters (the male and
female body every character is built on), Modular Character Outfits – Fantasy (armour, robes, boots, hoods,
bracers) and the hair styles, Stylized Nature MegaKit (trees, rocks, ferns, grass, mushrooms and flowers for every
chapter). All the character packs share one rig, so the clips drive every character.
- flo-bit — Low Poly Nature Pack (CC0): snow-capped pines and firs, bare trees and stumps for the Frozen Bone Sanctum.
- KayKit by Kay Lousberg (CC0): Dungeon Remastered — chests (normal and gold), pillars and rubble;
Character Pack: Skeletons — the skeleton warrior and mage, retargeted onto the Quaternius rig by
tools/build-assets.mjs so they use the same animations.
- Kenney and OpenGameArt authors incl. rubberduck, artisticdude, qubodup, LokiF, SubspaceAudio (CC0): sound effects, via
Legerdo/open-game-sfx-index.
- Versilian Community Sample Library (CC0): dan tranh zither, drums, gong, ocarina; aliexpress-erhu sample set (CC0).
tools/build-audio.py trims, normalises and encodes them.
tools/build-assets.mjs picks the clips, bodies, outfit pieces and props, retargets what needs it, simplifies
them and compresses them with meshopt and webp into src/assets/models/*.glb. The build inlines those files, so the single-file offline version still works.
Develop
npm install
npm run dev # local dev server (also reachable from your phone on the same Wi-Fi)
npm run build # type-check + single-file production build in dist/
npm run preview # serve the production build
The code is organised as:
| Path | Contents |
|---|
src/engine | Renderer, camera, input, helpers |
src/game | Player, enemies and boss, VFX, loot, save, main Game loop |
src/world | Level layout, props, debris, rain |
src/ui | HUD, touch controls, menus |
src/audio | Synthesised sound and music |
Deploy
.github/workflows/deploy.yml builds and deploys on every push to the default branch.
Turn it on once with Settings → Pages → Build and deployment → Source: GitHub Actions.
