Apr 2026
MCR Helper
A bilingual web reimplementation of an open-source C++/Cocos2d-x Mahjong Competition Rules tool, supporting hand input, fan calculation, and in-person game records.
- React
- JavaScript
- Ant Design
- Zustand
- TanStack Router
- Cloudflare Workers
Project overview
MCR Helper for the Web reimplements Jeff Wang’s C++/Cocos2d-x Chinese Official Mahjong Helper, which was released under the MIT License. The original project provides fan calculation, ready-hand analysis, in-person scoring, and fan reference material. This version focuses on a browser-based experience and adds English localization to make Mahjong Competition Rules scoring more practical for players in the United States.
Development began in April 2026. The product remains in closed-source Alpha testing and was most recently updated in August 2026. I may open-source it later, but this case study does not describe the current version as open source.
Features and architecture
The current version supports hand input and fan calculation, in-person game records, Chinese and English interfaces, and light and dark themes. It is a frontend-only application built with Vite, React, JavaScript, Ant Design, Zustand, and TanStack Router.
Game data remains on the user’s device in LocalStorage. The static application is deployed on Cloudflare Workers, avoiding a separate data service while the product is still validating its core workflows.
An in-person game record with player names anonymized and scoring details preserved.
The calculator presents hand conditions, fan names, and the total result in English.
Alpha testing
Approximately 20 players from a local Mahjong club have used the Alpha version. Their real-game feedback has driven additional features, interaction changes, and UI refinement while the project continues to validate its core workflows.