Mahjong Treasure Quest: free the tiles, fill the tray, find the treasure.
Mahjong Treasure Quest is an HTML5 triple tile-matching template with full source code and a pirate theme. Players tap a tile that no other tile covers, it flies to a tray of seven slots, and three alike disappear. The edition has 60 levels in four worlds, a pirate octopus mascot, a guided tutorial, three helpers, 14 interface languages and a ready-to-host game folder.
Four worlds, sixty levels
Tropical Island, Sunken Ship, Sunken Temple and Treasure Cave each bring their own background for the map and the levels and a sheet of 12 tile pictures: shells, compasses, anchors, treasure maps, parrots, ship wheels, pearls, jellyfish, idols, crowns, rubies, diamonds and more. Levels grow from 9 to 90 tiles, and every level is generated from a stored solution, so it can always be won.
A pirate octopus as your guide
The mascot waves on the menu, waits on the map, cheers on the win window and worries when the tray is almost full. Tiles shatter into shards when a trio clears, coins leave a trail to the counter, a treasure chest opens on every win, tropical leaves drift over the island and bubbles rise under the sea.
Helpers, coins and stars
Undo takes back a move, Hint makes a trio you can complete glow and Shuffle rearranges what is left while keeping the level solvable. Coins come from every trio and every win, and each level awards up to three stars: fewer helpers, more stars.
14 languages, every screen size
The interface is translated into 14 languages and starts in the language of the device. Pirate artwork exists for landscape and portrait, so the game fits phones, tablets, desktops and ultra-wide monitors. A "Tap to start" screen unlocks sound on mobile browsers.
Built on a proven engine
Mahjong Treasure Quest uses the same tested engine and rules as our Mahjong Garden template, with an all-new pirate theme: scenery, tiles, mascot, logo, buttons, windows and effects. The sound effects and the music are the same as in Mahjong Garden.
Your game, your hosting
Upload the contents of the game folder to static HTTP(S) hosting and open index.html. No database, PHP, account, server or Node.js runtime is needed, and normal play makes no requests to ranking, advertising or payment services. The package includes the editable project, an illustrated offline guide in English, Portuguese and Spanish, a separate step-by-step customization guide and the font licence notice.
What this edition does not include
Native apps, hosting and custom development are not included, nor are online multiplayer, an online ranking, in-app purchases or an advertising SDK. The included translations are supplied as they are: have a native speaker review them before launching in a new market.
Customise it
CUSTOMIZATION.html lists the file and size of every picture on every screen and gives recipes to replace backgrounds, the octopus, the tile sheets, the logo, sounds and music, texts, colors and the font, and to change level sizes, helpers and coins. Plain JavaScript modules and CSS, no framework, no build step.
Technical details at a glance
- Stack: HTML5, plain JavaScript modules and CSS, Canvas 2D and Web Audio, with no third-party code and no game engine.
- Files: HTML, CSS, JavaScript, JSON, SVG, PNG, WebP, MP3 and WOFF2.
- Languages: 14 interface languages and a guide in English, Portuguese and Spanish.
- Browsers: Chromium-based browsers 105+, Firefox 121+, Safari 16+, desktop and mobile.
- Saves: the browser's local storage, with no account or cloud sync.
- Tests: npm test plays all 60 levels by their stored solution and checks the 14 languages. Node.js 26.13 or newer is only used for the tests, the local server and the copy command.
