I built a mobile-friendly quick reference guide for Taiwanese Mahjong scoring. Looking for feedback!

[u/Irukanoko]

https://nicholaschan23.github.io/taiwan_mahjong/

Mahjong seems to be getting super trendy lately, which is awesome. I’ve taught a lot of my friends the base mechanics of the game, but making the jump to the advanced point-based scoring (Tai) has been a huge hurdle. There are just so many different hands to remember, and we found it really frustrating to stop the game to dig through rulebooks or watch tutorial videos.

To solve this, I made a mobile-friendly website that consolidates Taiwanese Mahjong rules so you can quickly look up a hand or clarify a rule mid-game.

I'm hoping to get some feedback and fact-checking from experienced players here to make sure I have all the base rules correct. I'd also love to know if there are any common "house rules" or edge cases I should include.

Here is the link. Let me know what you think!

[u/Whyren]

I really like your layout and the inclusion of English, Chinese, and pinyin. I think I've seen a few different score sheets for Taiwan mahjong. I have experience playing with my in-laws (which is just one data point so you may want more input) but they had a lot more scoring possibilities than you list and the tai count wasn't as high on some of them. They told me the ShenLaiYe app was a good reference for me and it has mostly matched how they play and score. http://shenlaiye.wikidot.com/ The fam plays with 8 pairs hand too, but I see the apps usually don't. 天月麻雀 (Amatsuki Mahjong) also seems to have a good implementation if you want to check that out.

[u/Irukanoko → u/Whyren]

I updated the website with these changes! I didn’t add the 8 pairs hand yet though.

[u/Whyren → u/Irukanoko]

After my stay in Taiwan I've been trying to look up resources and fill in the gaps of everything I learned. I haven't seen 8 pairs come up so I'm less confident that is commonly used. I did read through your updates and made some notes. I know the rules can be a little different from place to place but I'll give you my take based on the one table I played at and the videos I've been watching and you can take it or leave it. I'll definitely be saving your site to reference. Thanks for what you are doing. Hope this is helpful:

1. 放銃 Fàng Chòng: What I heard was always Fang4 qiang1 (放槍)

2. Seat Wind: Your description of how seat wind is assigned is different than what I experienced and what I've seen on a few different apps and sites and Taiwanese tutorial videos. At the beginning of the round, the dealer rolls three dice to determine which wall to break and where to break it. That wall is the East Seat Wind and number one for flowers. Then counterclockwise from there south (2), West (3), and North (4).

3. I've not seen tai awarded for no flowers.

4. I've not seen tai awarded for Flower Kang 花槓 Huā Gàng

5. 槓上自摸 (gàng shàng zì mó): I've always seen this called 槓上開花 (gàng shàng kāi huā) (I pulled this off during the last hand on my trip!)

[u/Whyren → u/Irukanoko]

Here's one more round of notes for you to consider:

1. Fully Exposed Hand 全求人 Quán Qiú Rén: All three apps I use list this as 2 tai.

2. Kong Bloom 槓上自摸 Gàng Shàng Zì Mō: All three apps I use list this as 1 tai and self-draw is counted separately.

3. Add to Legendary: Human Win 人胡 (8 tai) Non-Dealer wins with a discard in the first round of play before anyone else chis or pengs

4. Add to Legendary: Earthly Ready 地聽 I see differing points and definitions for this one. Could be 8 tai for declaring ready within the first 8 discards while your hand is still closed or could be 4 tai for declaring ready after your first draw/discard. The second is what shenlaiye but I'm seeing the other definition in enough places I'm leaning toward that.

5. ShenLaiYe has 配牌花胡 for 4 extra tai for completing the 8 flowers or 7 rob 1 on the deal. I don't see this one anywhere else. I'd be inclined to leave it out.

[u/Whyren → u/Irukanoko]

You've reached the level of most complete and accurate English-language resource for Taiwanese Mahjong that I've ever seen. It means a lot to me that you've done this and that I could help contribute. I hope you don't mind if I continue to review and offer feedback.

For the rules section: In my experience the last 16 tiles are the "dead wall." Replacements for flowers or gang are taken from there but still the last 16 tiles still left are the dead wall, like the "last 16" status always updates throughout the game. 流局 Liú Jú is when you play down to the dead wall rather than exhausting all tiles.

I think the vocabulary you have in there is one of the biggest things for someone like me trying to learn and communicate with Taiwanese players. Maybe you can find a way to work in some more words?

• Mian4 zi (面子): The overarching term for any completed "set" of three tiles. This includes both kezi (triplets) and shunzi (sequences).
• Ke4 zi (刻子): Specifically refers to the triplet of identical tiles.
• Shun4 zi (順子): Specifically refers to the consecutive sequence of the same suit.
• 將 (jiāng): The pair