Tokyo Mahjong

1. GAME OVERVIEW

Tokyo Mahjong: Neon Tides is the ultimate digital adaptation of Japanese Riichi Mahjong, blending traditional strategic depth with a rich, stylish urban aesthetic. Set in the rain-slicked, neon-drenched alleys and high-rise private parlors of contemporary Tokyo, players step into the shoes of aspiring mahjong prodigies, underworld hustlers, and veteran champions vying for dominance in the grandest underground tournament the city has ever seen: the Neon Dragon Cup.

Whether you are a seasoned Riichi grandmaster capable of calculating complex tile efficiency in milliseconds or a complete newcomer eager to learn the art of the 13 tiles, Tokyo Mahjong delivers an unparalleled experience. Combining authentic, officially recognized Riichi Mahjong rules with customizable game parlors, dynamic visual effects, high-energy jazz-synth soundtracks, and deep narrative campaigns, this is more than just a table game—it is a full-scale tactical battle of minds.

2. THE LORE & SETTING

Beneath the glittering billboards of Shibuya and the dense electric maze of Akihabara lies a hidden world where fortunes are made and lost on the green felt of a mahjong table. In Tokyo, tile games are not merely pastimes; they are high-stakes duels where criminal syndicates, tech moguls, and elite players resolve disputes and claim power.

As a rising tile slinger in the metropolis, you will travel across eight distinct Tokyo districts, each home to unique mahjong parlors with custom house rules, atmospheric soundscapes, and distinct AI opponents. Win respect on the streets of Shinjuku, outsmart tech-enhanced rivals in Akihabara, and earned your place in the hyper-exclusive sky parlors of Ginza. Along the way, unlock hidden storylines, uncover corporate conspiracies, and build your reputation as the undisputed sovereign of the game board.

3. KEY FEATURES

Authentic Japanese Riichi Mahjong Ruleset: Fully compliant with standard professional rulesets (EMA and WRC standard variants toggleable), including Furiten, Dora, Ura-Dora, Red Fives (Aka-Dora), Abortive Draws, and Yaku calculations.
Atmospheric Tokyo Parlors: Play across 12 beautifully rendered 3D environments ranging from cozy, rain-pattered alleyways and late-night ramen shop backrooms to sleek futuristic penthouse lounges.
Deep Narrative Campaign Mode: Embark on a 20+ hour story mode complete with fully voiced character interactions, branching dialogue paths, special objective matches, and rival boss battles.
Extensive Customization Engine: Customize every aspect of your game experience—unlock handcrafted tile sets (jade, obsidian, glowing neon, classic bamboo), custom felt tables, dynamic Riichi stick animations, tile discard effects, and personal avatars.
Robust Online Multiplayer & Leagues: Test your skills against players worldwide in Ranked Seasons, Casual Quick Matches, Private Room Lobbies with customizable house rules, and weekly Global Tournaments.
Interactive Interactive Learning Suite: Includes an interactive step-by-step tutorial, hand analyzer tools, discard recommendations, tile efficiency indicators, and a comprehensive Yaku encyclopedia.
Dynamic Audio Experience: Immerse yourself in an original dynamic soundtrack blending chill lofi beats, modern electro-jazz, and rain ambiance that reacts dynamically to the tension of the match.

4. GAME MODES

Narrative Campaign: "Underground Syndicate"

Journey through Tokyo’s dark underbelly in a single-player story mode. Face off against legendary parlor masters, fulfill specific match requirements (e.g., winning with a specific Yaku or making a comeback from a 20,000 point deficit), and uncover the mystery behind the missing Mahjong Sovereign.

Ranked League & Matchmaking

Compete in seasonal ladders spanning six skill tiers: Novice, Apprentice, Parlor Ace, District Champion, Tokyo Elite, and Mahjong Sovereign. Earn rating points, climb leaderboard rankings, and earn seasonal cosmetic rewards.

Custom Private Parlors

Create personalized game lobbies with friends or community members. Customize every rule parameter: enable/disable Red Fives, adjust starting points, select East-only (Tonpuusen) or South matches (Hanchan), set dynamic timer lengths, and toggle dynamic weather effects.

Master's Puzzle & Efficiency Mode

Sharpen your mind with hundreds of daily hand-calculation puzzles. Practice identifying Tenpai states, calculating maximum tile acceptance (Ukeire), and solving complex defensive escape scenarios based on real historical championship hands.

5. CHARACTER AVATARS & DISTRICTS

Select from a diverse cast of 10 playable avatars, each bringing distinct visual flair, animated emote sets, and voiced reaction lines to the table:

Ren "The Calculating Blade" (Akihabara): A former esports analyst who approaches Mahjong purely through mathematical probability and tile counts.
Yuki "The Street Phantom" (Shibuya): A quick-witted rogue known for aggressive, lightning-fast Chii and Pon tile calls that disrupt opponents' flow.
Kagura "The Crimson Phoenix" (Ginza): A refined high-roller whose calm composure masks an appetite for high-scoring Yakuman hands.
Kenji "Iron Wall" (Shinjuku): A veteran parlor bouncer specializing in impenetrable defensive play and Furiten traps.

Explore Iconic Districts:

Shinjuku Neon Alleyway: Gritty, fast-paced parlor with rapid dynamic turn timers.
Akihabara Tech Den: Futuristic cyber lounge featuring holographic tile displays and neon effects.
Roppongi Skyline Club: High-stakes venue with elevated point stakes and dramatic orchestral jazz background tracks.
Kyoto Traditional Tea House: Serene, meditative environment with traditional wood aesthetics and calming atmospheric rain sounds.

6. HOW TO PLAY: COMPREHENSIVE INSTRUCTIONS

Japanese Riichi Mahjong is a four-player tile-based game of strategy, probability, and tactical intuition. The objective is to construct a winning 14-tile hand faster than your opponents while managing risk and maximizing score value.

A. THE MAHJONG TILES (136 Total Tiles)

A standard Riichi Mahjong deck consists of 136 tiles divided into Suited Tiles and Honor Tiles:

Suited Tiles (108 tiles, numbers 1 through 9, 4 copies each):
- Manzu (Characters / Number Suits): Represented by Chinese kanji numbers and character symbols.
- Pinzu (Dots / Circles): Represented by circular geometric patterns.
- Souzu (Bamboo / Sticks): Represented by bamboo sticks (Note: The 1-Bamboo is traditionally depicted as a bird).
Honor Tiles (28 tiles, 4 copies each):
- Winds (16 tiles): East (Ton), South (Nan), West (Sha), North (Pei).
- Dragons (12 tiles): White Dragon (Haku - blank), Green Dragon (Hatsu), Red Dragon (Chun).

B. HAND STRUCTURE & FORMATION

A complete winning hand almost always consists of 14 tiles structured into 4 sets and 1 pair:

Melds / Sets (3 tiles each):
- Sequence (Chow / Chii): Three consecutive tiles of the same suit (e.g., 3-4-5 of Bamboo). Note: Honors cannot form sequences.
- Triplet (Pung / Pon): Three identical tiles (e.g., three 7-Dots or three Green Dragons).
- Quad (Kong / Kan): Four identical tiles declared during play, which acts as a set of 3 while drawing an extra tile.
Pair (Eye / Atama): Two identical tiles (e.g., two East Winds or two 2-Characters).

C. MATCH FLOW STEP-BY-STEP

1. Game Setup & Dealing

Each player starts with a base stack of points (typically 25,000 points represented by scoring sticks).
The tiles are shuffled and formed into a wall.
Players are dealt 13 tiles each. The East player (Dealer) begins with 14 tiles or draws first.
A Dora Indicator tile is flipped face-up in the dead wall. The tile immediately following it in suit/honor sequence serves as the Dora (bonus point tile).

2. The Turn Cycle

On your turn, the game follows a strict rhythmic sequence:

Draw: Draw 1 tile from the wall (giving you 14 tiles).
Evaluate: Check if your hand forms a complete valid winning hand or reachable state.
Discard: Place 1 unwanted tile into your personal discard zone face-up (reducing your hand back to 13 tiles).
Play proceeds clockwise to the next player.

3. Calling Opponents' Discards (Stealing Tiles)

When an opponent discards a tile, you may claim it to complete a set, subject to priority rules:

Pon (Triplet): Claim a discard from any player if you hold 2 matching tiles.
Kan (Quad): Claim a discard from any player if you hold 3 matching tiles.
Chii (Sequence): Claim a discard only from the player to your left if it completes a 3-tile numerical sequence.
Ron (Winning Claim): Claim a discard from any player to complete your entire winning hand.

Important Note: Calling Chii, Pon, or Kan opens your hand (Open Hand status). Open hands lose the ability to declare Riichi and reduce certain hand values!

D. THE ALL-IMPORTANT RIICHI & YAKU SYSTEM

Unlike basic tile games, you cannot win in Riichi Mahjong simply by forming 4 sets and 1 pair. Your hand MUST contain at least one valid YAKU (a specific scoring condition/pattern).

What is Riichi?

If your hand is Closed (no called Chii, Pon, or Open Kan) and you are only 1 tile away from a complete hand (a state known as Tenpai):

You may declare RIICHI!
Place a 1,000-point stick on the table as a bet.
Rotate your discarded tile sideways to signal your declaration.
From this point on, your hand is locked: you automatically draw and discard incoming tiles unless they complete your winning hand.
Declaring Riichi automatically satisfies the Yaku requirement and unlocks access to extra hidden bonus Dora (Ura-Dora) upon victory!

E. COMMON YAKU (SCORING PATTERNS) FOR BEGINNERS

To win, aim for one or more of these foundational scoring conditions:

Riichi (1 Han): Declared when 1 tile away from completion with a closed hand.
Tanyao / All Simples (1 Han): A hand composed entirely of number tiles 2 through 8 (containing NO 1s, 9s, Winds, or Dragons). Can be open or closed.
Yakuhai / Honor Triplets (1 Han): Holding a triplet of Dragon tiles, the Round Wind tile, or your personal Seat Wind tile.
Pinfu / All Sequences (1 Han): A closed hand consisting entirely of sequences, a non-scoring pair, and an open-ended wait.
Honitsu / Half Flush (2-3 Han): A hand made using only one single suit plus Honor tiles.
Ippeiko / Twin Sequences (1 Han): A closed hand containing two identical sequences in the exact same suit (e.g., 2-3-4 of Dots twice).
Kokushi Musou / Thirteen Orphans (Yakuman - Maximum Value): Holding one of every 1s, 9s, Wind, and Dragon tile plus one duplicate pair.

F. WINNING THE HAND: TSUMO VS. RON

There are two ways to claim victory once in Tenpai:

TSUMO (Self-Draw Win): You draw the final winning tile yourself from the wall.
- Payment: All three other players split the point cost and pay you.
RON (Discard Steal Win): An opponent discards the exact tile you need to complete your hand.
- Payment: The player who discarded your winning tile must pay the ENTIRE point value alone!

G. CRITICAL RULES TO REMEMBER

Furiten Rule (The Defense Mechanism): If any tile you currently need to win is present in your OWN past discard pile, you CANNOT win via Ron (stealing an opponent's discard). You can only win via Tsumo (self-draw). This ensures opponents can analyze your discard pile to play safely!
Dora Bonus Tiles: Holding tiles matching or indicated by Dora indicators adds bonus point multipliers (Han) to your winning hand.
Red Fives (Aka-Dora): Specially marked red 5-tiles that act as permanent extra Dora bonus points.

7. STRATEGY & ADVANCED TIPS

Prioritize Keeping Your Hand Closed: Unless you have guaranteed Dragon triplets or clear high-value plans, keep your hand closed to retain the power of declaring Riichi.
Master Tile Efficiency (Ukeire): Focus on keeping flexible tile pairs (such as 3-4 or 5-6) rather than isolated edge tiles (like 1s and 9s) to maximize your draw chances.
Defensive Folding (Beta-Ori): If an opponent declares Riichi and your hand is far from ready, play defensively! Discard safe tiles—such as tiles the Riichi player previously discarded—to avoid dropping a high-value Ron tile.
Watch the Wall Count: As remaining wall tiles diminish, assess risk vs. reward. Avoid taking wild risks when only a few draws remain.

8. SYSTEM REQUIREMENTS (PC & CONSOLE)

OS: Windows 10/11 (64-bit) / macOS 12+ / PlayStation 5 / Xbox Series X|S / Nintendo Switch
Processor: Intel Core i5-6600K / AMD Ryzen 5 1600
Memory: 8 GB RAM
Graphics: NVIDIA GeForce GTX 1060 (6 GB) / AMD Radeon RX 580 (8 GB)
Storage: 15 GB available space
Network: Broadband Internet connection for online multiplayer modes

Step up to the table, draw your tiles, call your claim, and declare Riichi under the glowing lights of Tokyo Mahjong! """

with open("tokyo_mahjong_game_description.md", "w", encoding="utf-8") as f: f.write(content)

words = len(content.split()) print(f"Total word count: {words}")

Code output Total word count: 2076

Python content = """# TOKYO MAHJONG: NEON TIDES

Experience the pulse-pounding thrill of high-stakes Japanese Riichi Mahjong set against the shimmering backdrop of a cyber-infused modern Tokyo!

Header AD