麻将 - JavaScript 麻将游戏

项目说明

Mahjong. In the browser.

1: We're talking real "four players sitting around a table" 麻将 here. Not the "one player solitaire" 游戏. That 游戏 has literally nothing to do with 麻将.

2: This README.md has been kept sparse pending a set of full length de articles that walk through going from "having an idea" to "having finished writing a fully functional 游戏".

Can I play this game?

You sure can! And you don't even need to sign up for anything, or check out any programming 代码, or do anything beyond just clicking through to the li:

Note that mostly due to "that's what we play in our house a lot", this implementation currently comes with "Chinese Classical" and "Cantonese" rules for play and scoring. Additional rules may e be written up, but if you want to get ahead of the 游戏 and implement one so it can be added to the repo, those will be more than welcome.

What it looks like

!A screenshot of what the live 游戏 looks like when set to autoplay

What if I want a different look?

Not a problem, since this is just a webpage, you can customize your look using User Styles as much as you like. In fact, if you want to try some of the other styles that other folks already made, have a look at any of the following to see if they suit your mood better!

This is a pure HTML, CSS, and Ja game

That means there are no bundlers, no web app packaging, no CSS preprocessors or JS transpiling, just an index.html, a bunch of CSS files, and a bunch of JS files. If you can load the page, you now have a full copy of the 游戏 that you can save to your desktop and congratulations, you now have your own copy "installed" without doing anything beyond just downloading the page and its local page assets.

I can hear the web de you thinking "but... then isn't it horribly inefficient?" to which I'm just going to point out that this is how we used to write the web and it was, and still is, blazing fast. This 游戏 has a Google PageSpeed ranking of 97/98, so: don't be fooled (or, don't fool yourself) into thinking e needs to be a web app bundle to be performant.

Debugging using query parameters

Open index.html in your browser. Debugging options are set via URL query parameter, however, the way to toggle these is via the settings menu.

!A screenshot of the settings menu

Node based testing

Most of the 代码 is aware of whether it's running in the browser, or in node context. As such, the following things work:

And for full gameplay debugging through play recordings, you can use node src/js/test/play-game with the following optional flags:

I have (a) question(s)!

I'd be happy to answer them! Feel free to drop me a message for shallow engagement, or file an issue over on the issue tracker if you need deeper engagement.

技术栈

开发语言：JavaScript

项目类型：JavaScript 麻将游戏

Star 数：114

功能特点

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

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

部署说明

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

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

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

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

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

学习价值

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

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

免责声明

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