🀄 Hong Kong Mahjong (香港麻雀)

Select Language / 選擇語言 / 选择语言
English • 繁體中文 • 简体中文

---

🌐 English

A responsive, lightweight web-based Hong Kong Mahjong game built with pure HTML5, CSS3, and Vanilla JavaScript. Features custom SVG tile graphics, customizable player profiles, AI opponents, and adaptive screen scaling.

🚀 Live Demo

Play directly in your browser: https://johnnylin707.github.io/HK_Mahjong/

✨ Key Features

• 🎨 Authentic SVG Tile Rendering: Custom SVG code rendering crisp tiles for Wanzi, Tongzi, and Suozi (including classical 7, 8, and 9 Suo patterns, 1-Tiao Peacock, and Dragon White Frame).
• 👤 Customizable Player Profile: Enter your own nickname on the main menu, displayed alongside 3 AI opponents (AI 雀聖, AI 雀仙, AI 雀神) with real-time score tracking.
• 🤖 Multiple Game Modes: Includes Tutorial Mode for beginners, as well as Easy and Medium AI play modes.
• 📱 Adaptive Layout Scaling: Optimized for a 1800x1400 canvas while auto-scaling seamlessly across desktop and laptop screens.
• ⚡ Zero Dependencies: 100% Vanilla JS, HTML, and CSS without any heavy frameworks or external packages.

🛠️ Local Development

1. Clone the repository:

   git clone [https://github.com/JohnnyLin707/HK_Mahjong.git](https://github.com/JohnnyLin707/HK_Mahjong.git)
   

---

🌐 🇭🇰 繁體中文

基於原生 HTML5、CSS3 與 Vanilla JavaScript 開發的輕量級網頁版香港麻雀遊戲。支援擬真 SVG 牌面繪製、自訂玩家名稱、AI 對手與自動適應螢幕佈局。

🚀 線上試玩 點擊即刻開玩：https://johnnylin707.github.io/HK_Mahjong/

✨ 核心特色 🎨 擬真 SVG 牌面繪製: 原生 SVG 精細繪製萬子、筒子、索子（含經典 W/M 形八索、三色九索、彩鳳一索與白板框），重現手雕麻雀質感。

👤 自訂玩家名稱與實時計分: 主選單可自由輸入大名，並在桌面上方以正向卡片呈現 4 家名稱與輸贏得分。

🤖 多種對戰模式: 支援 新手教學模式，以及 簡單 與 中等偏上 的 AI 對戰模式（對手為 AI 雀聖、AI 雀仙、AI 雀神）。

📱 高清自適應佈局: 針對 1800x1400 大桌面設計，並支援全裝置等比例自動縮放適應視窗。

⚡ 零外部依賴: 100% 原生 JavaScript 與 CSS，無須安裝或構建任何套件，隨點隨玩。

🛠️ 本地運行

1. 複製倉庫：

   git clone [https://github.com/JohnnyLin707/HK_Mahjong.git](https://github.com/JohnnyLin707/HK_Mahjong.git)

直接雙擊或以瀏覽器開啟 index.html 即可。

---

🌐 🇨🇳 简体中文

基于原生 HTML5、CSS3 与 Vanilla JavaScript 开发的轻量级网页版香港麻将游戏。支持拟真 SVG 牌面绘制、自定义玩家名称、AI 对手与自动适应屏幕布局。

🚀 在线试玩 点击即刻开玩：https://johnnylin707.github.io/HK_Mahjong/

✨ 核心特色 🎨 拟真 SVG 牌面绘制: 原生 SVG 精细绘制万字、筒子、索子（含经典 W/M 形八索、三色九索、彩凤一索与白板框），还原手雕麻将质感。

👤 自定义玩家名称与实时计分: 主菜单可自由输入姓名，并在桌面上方正向卡片展示 4 家名称与输赢得分。

🤖 多种对战模式: 支持 新手教学模式，以及 简单 与 中等偏上 的 AI 对战模式（对手为 AI 雀圣、AI 雀仙、AI 雀神）。

📱 高清自适应布局: 针对 1800x1400 大桌面设计，并支持全设备等比例自动缩放适应窗口。

⚡ 零外部依赖: 100% 原生 JavaScript 与 CSS，无需安装或构建任何依赖包，即点即玩。

🛠️ 本地运行

1. 克隆仓库：

   git clone [https://github.com/JohnnyLin707/HK_Mahjong.git](https://github.com/JohnnyLin707/HK_Mahjong.git)
   

直接双击或在浏览器中打开 index.html 即可。