Master Qwan's Mahjong: Game Description & Official Manual

Part I: Game Description

1.1 Overview and Lore

Enter the serene, contemplative atmosphere of the ancient mountain monastery in Master Qwan's Mahjong, a classic tile-matching solitaire puzzle game inspired by timeless Asian philosophy, strategy, and artistry. Perched high upon the misty crags of Mount Songshan, the revered temple of Master Qwan has preserved the art of mindful tile-matching for centuries. Here, the traditional game of Mahjong Solitaire is elevated into an exercise of focus, spatial observation, and strategic foresight. As a dedicated disciple seeking wisdom and mental acuity, you must unravel intricate multi-layered pyramids, towers, and symbolic patterns of traditional bamboo, character, dot, wind, and dragon tiles under the peaceful guidance of the Grandmaster himself.

In Master Qwan's Mahjong, authentic single-player solitaire mechanics are paired with elegant visual design and smooth digital performance. Players are presented with a three-dimensional arrangement of stacked tiles placed upon an ornate mahogany table. Unlike multi-player Mahjong, your objective is not to form winning hands against opponents, but rather to methodically identify and match pairs of unblocked, identical tiles to completely dismantle the board structure. Success requires careful visual scanning, patience, long-term spatial planning, and an understanding of tile hierarchy, as every move dictates which concealed tiles beneath will be exposed for future turns.

Designed for puzzle purists, casual gamers, strategy enthusiasts, and players seeking a tranquil mental escape, Master Qwan's Mahjong balances deep tactical gameplay with an enchanting, meditative environment. Every successful match provides crisp visual feedback—detailed tile engravings shifting in light, subtle wooden friction animations, and resonant acoustic chimes. Featuring dozens of classic layout patterns (including the Turtle, Dragon, Spider, and Fortress), dynamic hint systems, an endless Zen mode, and customizable tile sets, Master Qwan's Mahjong offers a rich, timeless journey into the art of focus and spatial problem-solving.

1.2 Component Inventory & Player HUD Layout

Whether played via intuitive touch interactions on mobile devices or precision cursor clicks on desktop computers, Master Qwan's Mahjong presents a high-visibility, uncluttered operational interface:

1 Primary Tile Canvas (The Monastery Table):
- The Tile Layout: A dynamic 3D multi-layered structure composed of up to 144 traditional Mahjong tiles arranged in authentic stacked patterns.
- Tile Categories: Suited tiles (Dots, Bamboo, Characters) and Honor tiles (Winds, Dragons, Flowers, Seasons).
1 Disciple HUD:
- Timer & Speed Display: Measures total elapsed time spent unraveling the active layout.
- Tile Counter: Displays real-time counts of total remaining tiles and currently exposed, matchable pairs on the board (e.g., $48 / 144 \text{ Tiles Remaining} \mid 6 \text{ Available Matches}$).
1 Master Qwan’s Wisdom Dock:
- Wisdom Hint (Lantern): Highlights a guaranteed playable pair of matching exposed tiles.
- Monastery Reshuffle (Fan): Scrambles all remaining tiles currently on the board into a guaranteed solvable arrangement.
- Undo Step (Lotus): Reverses your previous tile match, placing the tiles back onto their original stack positions.

1.3 Visual Aesthetics and Acoustic Atmosphere

Master Qwan's Mahjong surrounds players in a quiet, high-contrast Eastern aesthetic engineered for visual clarity and cognitive calm:

Traditional Visual Craftsmanship: High-definition rendered wood-grain tables, authentic hand-painted tile faces (bamboo shoots, calligraphy strokes, cherry blossoms), soft ambient lantern glow, and realistic tile drop shadows.
Serene Acoustic Soundscape: A tranquil traditional musical score featuring Guzheng harps, Erhu violins, soft bamboo flutes, crisp wooden tile clicks upon matching, and a resonant temple bell chime upon fully clearing a layout.

1.4 Core Objectives

The primary objective in Master Qwan's Mahjong is to dismantle the multi-layered tile layout completely by identifying, selecting, and matching unblocked pairs of identical Mahjong tiles until zero tiles remain on the table.

Player performance is evaluated through:

Total Layout Clearance: Successfully removing $100\%$ of tiles from the board without running out of playable matches.
Move Efficiency & Speed: Dismantling the layout in the shortest possible time to earn higher Master Rank scores.
Match Continuity: Linking consecutive tile matches in quick succession to maintain "Mindfulness Combo" score multipliers.
Monastery Distinction: Completing layouts with minimal reliance on hints or reshuffles to earn 3 Golden Lotus Badges.

Part II: Gameplay Instructions

2.1 Core Rules & Tile Matching Mechanics

Mastering Master Qwan's Mahjong relies on recognizing valid tile pairings and understanding the strict "Free Tile Law."

Rule 1: The Free Tile Law (Unblocked Condition)

A tile is considered Free (playable) and available for selection if and only if it satisfies both of the following structural conditions:

Side Unblocked: The tile has no adjacent tile touching its immediate left side OR its immediate right side. (At least one lateral side must be completely open).
Top Unblocked: The tile has no tile resting on top of it, even partially.

$$\text{Playable Tile} \iff (\text{Left Side Open} \lor \text{Right Side Open}) \quad \land \quad (\text{Top Surface Uncovered})$$

Tiles that are pinned down by overlapping upper layers or pinched tightly between left and right neighbors are locked and cannot be selected until surrounding tiles are cleared.

Rule 2: Matching Rules & Tile Categories

Tiles are matched by selecting two identical, free tiles. Matching rules vary slightly depending on whether the tiles belong to Suited Sets or Special Sets:

Suited Tiles (Dots, Bamboo, Characters): Must match exact number and suit (e.g., 5-Bamboo matches only another free 5-Bamboo; 9-Dot matches only another free 9-Dot).
Wind Tiles (North, South, East, West): Must match the exact same direction (e.g., East Wind matches only another free East Wind).
Dragon Tiles (Red, Green, White): Must match the exact same color/symbol (e.g., Red Dragon matches only another free Red Dragon).
Flower Tiles (Plum, Orchid, Bamboo, Chrysanthemum): Any Flower tile can match with ANY other Flower tile, regardless of specific artwork!
Season Tiles (Spring, Summer, Autumn, Winter): Any Season tile can match with ANY other Season tile, regardless of specific season!

$$\text{Special Category Match} = \text{Any Flower} \leftrightarrow \text{Any Flower} \quad \text{OR} \quad \text{Any Season} \leftrightarrow \text{Any Season}$$

2.2 Game Setup & Match Initialization

Select Layout Pattern: Choose an active puzzle design from the Monastery Layout Map (e.g., The Traditional Turtle, The Twin Pyramids, The Temple Gates, or The Imperial Dragon).
Select Tile Theme & Background: Choose your preferred visual style (e.g., Classic Jade, Ivory & Mahogany, or Ebony & Gold).
Initialize Layout: The 144 Mahjong tiles generate into the chosen three-dimensional structure. The timer begins, the available match counter updates, and your meditative puzzle session commences!

2.3 Fundamental Tactics & Step-by-Step Strategy

Clearing tall, dense tile layouts without running out of playable moves requires forward-thinking spatial management. Master disciples rely on four primary strategies:

Technique 1: Top-Layer & High-Stack Prioritization

Always prioritize matching free tiles located on the highest peak of the layout or on long stacked rows! Clearing upper tiles immediately exposes concealed tiles beneath, unlocking multiple new choices down lower layers.

Technique 2: Long Horizontal Row Reduction

Focus on removing free tiles located at the far left and far right ends of long horizontal lines! Clearing outer edge tiles frees trapped inner tiles across the middle of the row, expanding your lateral matching options.

Technique 3: Quad Scanning & Pair Conservation

Each suit contains exactly 4 identical tiles on the board. When 3 or 4 tiles of the same type become free simultaneously, scan the layout carefully before picking a pair! Choose the two tiles that free up the most locked or stacked tiles beneath them, holding the other pair in reserve.

Technique 4: Avoiding Deadlocks

Be cautious when matching tiles without inspecting their underlying stacks! If you clear a pair carelessly, you may accidentally trap a required matching tile beneath a deep layer, resulting in a deadlock where zero free matches remain on the board.

2.4 Structure of an Active Gameplay Loop

Gameplay in Master Qwan's Mahjong follows a focused, deeply satisfying tactical rhythm:

Phase 1: Board Inspection & Peak Scanning
- Examine the layout, locate high stacks, identify open end-tiles on long rows, and note all currently playable pairs.
Phase 2: Tactical Selection
- Click or tap a free tile to highlight it, then select its matching partner to remove both tiles from the table.
Phase 3: Layer Unlocking & Board Exposure
- Observe covered tiles underneath become exposed as upper layers dissolve, instantly updating the HUD's available match count.
Phase 4: Table Clearance & Master Ranking
- Match the final pair of tiles from the mahogany table! A triumphant temple bell rings, total completion time is logged, and master rank badges are awarded.

2.5 Master Qwan's Boosters & Board Mechanics

Special assistance tools and structural mechanics help navigate complex board states:

Feature / Tool	Visual Identifier	Operational Function & Rule Mechanics
Wisdom Hint	Glowing Paper Lantern	Highlights 1 unblocked matching pair currently available on the table
Monastery Reshuffle	Folding Silk Fan	Rearranges all remaining tiles on the board to guarantee at least one valid match
Lotus Undo	Pink Lotus Flower	Reverses the last completed match, returning both tiles to their previous positions
Locked Tile	Shadowed / Dimmed Tile	Indicates a tile that cannot be selected due to adjacent or top structural blockages
Free Tile	Bright / Highlighted Edge	Indicates a tile that meets all unblocked criteria and is ready for immediate pairing

2.6 Game Modes

2.6.1 Master's Journey (Campaign Mode)

The primary single-player progression experience featuring over 200 handcrafted layouts across 6 thematic chapters. Unlock new tile sets, background mats, and philosophical proverbs as you ascend Mount Songshan.

2.6.2 Time Attack (Sprint Mode)

Gameplay: A high-speed race against a countdown clock!
Mechanics: Every successful match adds +5 seconds back to your clock. Clear the entire structure as rapidly as possible to post high scores on global leaderboards.

2.6.3 Zen Monastery (Endless Mode)

Gameplay: A completely tranquil, stress-free puzzle experience with zero timers or score counters!
Mechanics: Unlimited hints, infinite undo moves, and auto-reshuffles allow players to match tiles at their own peaceful, relaxed pace.

2.7 Stage Settlement & Scoring Formula

Final stage performance and lotus ratings are calculated upon clearing the final pair of tiles:

$$\text{Final Stage Score} = (\text{Base Layout Points} \times 1000) - (\text{Elapsed Seconds} \times 10) + (\text{Max Match Streak} \times 150)$$

Pure Focus Bonus: 2,000 Points awarded for clearing a complete 144-tile layout without using any hints or reshuffles.
Lotus Rating Thresholds:
- 1 Bronze Lotus: Clear the entire layout without running out of moves.
- 2 Silver Lotuses: Complete the layout within the target time threshold using fewer than 2 boosters.
- 3 Golden Lotuses: Master the layout rapidly with zero booster assistance and high combo streaks!

2.8 Game End & Victory Conditions

A session in Master Qwan's Mahjong officially concludes upon reaching either of two final outcomes:

Layout Completed (Victory Condition): Every single tile is successfully matched and removed from the table. A serene victory screen displays your time, match efficiency, and earned lotus badges, unlocking the next layout on the mountain map!
No Playable Moves (Defeat Condition): Zero free matching pairs remain on the board, and no reshuffle items are available. The board freezes, offering options to use a fan reshuffle, undo your last moves, or restart the layout.

The disciple who observes carefully, plans every match with wisdom, and clears layouts with calm precision earns the revered title of Master of the Songshan Monastery!

2.9 System Integrity & Field Settings

3D Board Rotation: Free-look camera controls allow players to tilt, pan, and rotate the mahogany table to inspect hidden stack edges from any angle.
High-Visibility Mode: Toggles simplified tile face graphics and high-contrast borders for players seeking maximum readability.
Cross-Platform Cloud Sync: Layout progress, unlocked tile designs, earned lotus badges, and high scores sync seamlessly across mobile devices, tablets, and desktop web browsers.

Header AD

Master Qwans Mahjong