mah - HTML5 麻将接龙游戏

项目说明

<di="center"><a href=" src=" alt="Support Palestine" style="width: 100%;"></a></div>

<di="center">
<img width="500" height="350" src="logo.svg" alt="Mah">
</div>

Mah - Mahjong Solitaire

The original open-源码 麻将 Solitaire 游戏 powering many 麻将 experiences on the web.
Completely free. No ads. No tracking. No cloud.

🀄 Play now in your browser

![license]()
!test
![de]()
![Maintainability]()
![Codacy Badge]()

---

✨ Features

🧩 84 built-in layouts - from classic layouts like Turtle and Dragon to unique custom designs

🌱 Random seed based layout generator - enter or generate a custom seed to share or replay a specific randomly generated board for endless replayability

🎨 13 tile image sets - switch between beautiful tile designs in light and dark styles

🏆 3 difficulty levels for features and boards generation - from relaxed casual play to expert-le

📅 Daily challenge - one board and one rule set per day, the same for e, with streaks, a result calendar and a best score per challenge type

🎯 7 challenge types - timed runs, score hunts and special tiles change how a board has to be cleared

🖼️ Massi customization - 8 image backgrounds, 375 pattern backgrounds, light/dark mode, 14 color themes, 3D tiles and shadows

🧘 Zen mode - hide the UI chrome for a clean, distraction-free playing experience

🔍 Pan, zoom and rotate - move and pinch-zoom the board, and optionally rotate it in portrait to fit wide layouts on a phone

⌨️ Playable by keyboard - tab and arrow key na e, shortcuts for every 游戏 action, focus and screen reader announcements

⏱️ Optional game timer - show or hide the 游戏 clock to suit your play style

🎉 confetti - optional celebratory confetti burst when you clear the board

💾 Auto-save - your 游戏 state and best times are sa in your browser, never to the cloud

📱 Cross-platform - runs in the browser, on desktop (macOS, Windows, Linux), and on Android

🌍 40 languages - English, العربية, বাংলা, Català, Čeština, Dansk, Deutsch, Ελληνικά, Español, Euskara, فارسی, Suomi, Filipino, Français, Gaeilge, हिन्दी, Magyar, Bahasa Indonesia, Íslenska, Italiano, 日本語, 한국어, Монгол, Bahasa Melayu, Nederlands, Norsk, Polski, Português, Română, Русский, S, Kiswahili, தமிழ், తెలుగు, ไทย, Türkçe, Українська, اردو, Tiếng Việt, 中文

---

📅 Daily Challenge

One board and one rule set per day, the same for e. A new challenge unlocks at midnight, your local time.
Your streak, your best streak, a won/played count and a calendar of past results are kept locally, and each challenge type keeps its own best score.

| Challenge | Objective |
|--------------|-----------------------------------------------------------------------------------------------------|
| Midas Match | Find and match the gold-marked tile. Hints and undo are allowed. |
| Sparkstone | Clear the board before time runs out. Matching the sparkstone adds time and marks a new one. |
| Match Rush | Make the target number of matches before time runs out. The board does not have to be cleared. |
| Fortune Hunt | Reach the target score before time runs out. Fast matches in a row build a multiplier. |
| Running Sand | You start with little time. Every match adds time, but only up to a limit. Clear the board in time. |
| The Purge | Remo tile of the marked suit before time runs out. |
| Blackout | Only free tiles show their face, covered tiles stay blank. Hints are allowed, undo is not. |

---

🏛️ Explore More Layouts

Mahjong Solitaire Layout Museum

Browse a curated archive of custom layouts created by the Kyodai Mahjongg community.
Click any layout and select "Play it with Mah" to import it directly into your game.

---

📷 Screenshot

<di="center">
<img width="500" src="screenshot.jpg" alt="Screenshot of Mah">
</div>

---

📥 Download

Play instantly in the browser, or grab a nati for your platform:

<a href=" target="_blank"><img height="80" src="./resources/badges/badge-github.png" alt="Get it on Github"></a>
<a href=" target="_blank"><img height="80" src="./resources/badges/badge-obtainium.png" alt="Get it on Obtainium"></a>

| | Platform | A |
|----|----------|------------------------------------------|
| 🌐 | Web | Play now |
| 🍎 | macOS | .dmg installer |
| 🪟 | Windows | .msi / .exe installer |
| 🐧 | Linux | .deb / .AppImage |
| 🤖 | Android | .apk |

> [!IMPORTANT]
>
> Unsigned apps/installers (macOS and Windows)
>
> The macOS and Windows builds are not yet 代码-signed. Your OS may show a warning the first time you run the app - this is normal for unsigned software and does not mean the files are malicious.
> If you prefer to skip these warnings, play in your browser instead.

<details>
<summary>🍎 <strong>macOS</strong> - bypassing Gatekeeper</summary>

Apple's Gatekeeper blocks apps from unidentified de. You may see a message claiming the app is damaged - this is not true.

Remove the quarantine attribute to fix it:

The exact steps may vary by macOS - search for instructions specific to yours.

</details>

<details>
<summary>🪟 <strong>Windows</strong> - bypassing SmartScreen</summary>

Microsoft Defender SmartScreen shows a warning for unsigned apps.

Click "More info" → "Run anyway" to proceed.

</details>

<details>
<summary>🤖 <strong>Android</strong> - installing from APK</summary>

Android blocks installs from unknown sources by default. Go to Settings → Security (or Apps) and enable Unknown Sources.

Most modern phones use arm64. Try these APK in order:

1. android-mah-x_y_z-arm64.apk
2. android-mah-x_y_z-arm.apk
3. android-mah-x_y_z-x86_64.apk
4. android-mah-x_y_z-x86.apk

</details>

---

🙏 Acknowledgements

Mah's art is built on open-源码 creative work. See the credits for artwork, backgrounds, sounds, icons and fonts.

---

🐳 Docker

Run Mah with a single command:

Then open

Or use Docker Compose:

For building your own docker container, see resources/docker.

---

🛠️ De

Build Config

The default 游戏 name is "Mah Jong". To change it:

1. Copy custom-build-config.json.dist to custom-build-config.json
2. Edit the name in custom-build-config.json to your desired app name

Quick Start

技术栈

开发语言：TypeScript

项目类型：HTML5 麻将接龙游戏

Star 数：151

功能特点

这是一套HTML5 麻将接龙游戏，代码结构清晰，适合开发者学习游戏的客户端渲染、服务端逻辑、场景管理与资源加载。项目涵盖了游戏的核心玩法、界面交互、地图与角色系统等模块，对理解游戏开发的完整流程具有较高的参考价值。

从技术实现角度看，游戏项目的难点在于：游戏循环与状态管理、资源加载与渲染优化、客户端与服务端的协议同步、以及多平台适配。本项目在这些方面提供了可运行的实现，开发者可以在此基础上进行二次开发或学习研究。

部署说明

1. 下载源码压缩包，解压到本地开发环境。

2. 根据项目类型准备对应的运行环境（Node.js / Go / C# / Unity / Godot 等）。

3. 按照 README 中的步骤配置依赖、数据库和配置文件。

4. 先启动服务端，再运行客户端，即可进入游戏进行测试。

注意：本项目仅供学习研究使用，请勿用于商业或非法用途。

学习价值

对于想进入游戏开发领域的开发者来说，这套源码是一个很好的入门参考。通过阅读代码，可以学习到游戏的核心玩法实现、场景与资源管理、网络协议设计、以及渲染优化等关键技术点。

同时，项目中的代码组织方式和模块划分，也展示了游戏项目在工程化方面的实践经验，值得开发者深入研究和借鉴。理解一个完整游戏项目的架构，对后续开发其他类型游戏也很有帮助。

免责声明

本资源来源于开源社区，仅供学习研究和技术交流使用，请勿用于任何商业或违法违规用途。使用本项目产生的一切后果由使用者自行承担。若涉及第三方权益，请联系删除。