Mahjongg: Game Description & Official Manual

Part I: Game Description

1.1 Overview and History

Step into the tranquil sanctuary of classical tile solitaire in Mahjongg (often rendered as Mahjong Solitaire or Shanghai), an enduring masterpiece of visual pattern recognition, spatial deduction, and tactical foresight. Tracing its roots back through centuries of traditional Chinese tile craft and popularized digitally in the late 20th century, Mahjongg transforms the physical components of the classic four-player tabletop game into a captivating, deeply satisfying single-player mental challenge. Set within a serene, moonlit courtyard adorned with polished bamboo tables, delicate cherry blossoms, and glowing paper lanterns, the game invites players to engage in a meditative yet intellectually stimulating puzzle-solving journey.

In Mahjongg, players face a multi-layered, three-dimensional structure built from 144 traditional bone-and-bamboo tiles carved with intricate calligraphic symbols, suits, natural elements, and imperial iconography. The objective is elegant in its simplicity yet deceptively complex in execution: systematically discover, match, and remove identical pairs of unblocked tiles until the entire structure is completely cleared from the board. Every move alters the physical architecture of the arrangement—removing upper tiles uncovers hidden pieces underneath, while clearing outer edge pieces unlocks pinched lateral neighbors, directly shaping the future availability of matches.

Designed for puzzle purists, strategy enthusiasts, casual gamers, and players seeking a focused mental retreat, Mahjongg balances soothing atmospheric relaxation with sharp cognitive strategy. Every successful match delivers rich sensory feedback—smooth polished tile glides, crisp wooden clacks, delicate glowing particle trails, and resonant temple chime harmonies as tiles dissolve from the board. Featuring dozens of classic layout formations (including the iconic Turtle, Dragon, and Pyramid structures), dynamic hint systems, an endless Zen Meditation mode, high-contrast visual themes, and detailed statistical telemetry, Mahjongg offers a timeless puzzle experience where visual acuity, methodical spatial planning, and patience pave the path to complete harmony.

1.2 Component Inventory & Player HUD Layout

Whether navigated through intuitive touch-and-tap gestures on mobile displays or precision cursor clicks on desktop computers, Mahjongg presents a clean, high-contrast, distraction-free visual interface:

1 Central Tile Table (The Assembly Surface):
- The Tile Layout (The Grid): A dynamic 3D multi-layered structure composed of 144 traditional tiles arranged in authentic stacked patterns.
- Tile Categories: Suited tiles (Dots/Coins, Bamboo/Rods, Characters/Numbers) and Honor/Bonus tiles (Winds, Dragons, Flowers, and Seasons).
1 Player Telemetry HUD:
- Session Chronometer: Tracks total elapsed time spent unwinding the active tile arrangement.
- Board Metrics Panel: Tracks total remaining tiles on the table alongside real-time counts of currently exposed, matchable pairs (e.g., $64 / 144 \text{ Tiles Remaining} \mid 8 \text{ Playable Matches}$).
- Layout Title: Displays the active board pattern (e.g., The Turtle, The Fortress, The Cloud).
1 Master’s Utility Dock:
- Lantern Hint: Highlights a guaranteed playable pair of matching unblocked tiles currently on the board.
- Wind Breeze (Reshuffle): Rearranges all remaining tiles on the board into a guaranteed solvable arrangement.
- Dewdrop Undo: Reverses your previous match, returning both tiles to their original stack positions.

1.3 Visual Aesthetics and Acoustic Atmosphere

Mahjongg surrounds players in a quiet, high-contrast Asian aesthetic engineered for visual clarity, spatial focus, and mental calm:

Refined Traditional Visuals: High-definition rendered wood-grain and stone tables, authentic hand-painted tile faces (cherry blossoms, soaring cranes, character calligraphy, bamboo stalks), dynamic morning sunlight filters, floating autumn leaves, and realistic drop shadows outlining stacked layers.
Serene Acoustic Soundscape: A tranquil musical score featuring traditional Guzheng harps, bamboo flutes, soft running water sounds, crisp wooden tile clicks upon matching, and a resonant temple gong chime upon successfully clearing a layout.

1.4 Core Objectives

The primary objective in Mahjongg is to completely dismantle the multi-layered tile structure by finding, selecting, and matching unblocked pairs of identical tiles until zero tiles remain on the table.

Player performance is evaluated through:

Complete Board Clearance: Removing $100\%$ of tiles from the table without running into deadlocks.
Move Foresight & Speed: Dismantling structures efficiently to achieve high speed ratings.
Combo Execution: Executing rapid consecutive matches to build and maintain score multipliers.
Flawless Clearance: Clearing layouts with zero booster assistance (hints or reshuffles) to earn master rank honors.

Part II: Gameplay Instructions

2.1 Core Rules & Tile Matching Mechanics

Mastering Mahjongg relies on recognizing valid tile pairings and strictly adhering to the "Free Tile Law."

Rule 1: The Free Tile Law (Unblocked Condition)

A tile is defined as Free (playable) and available for matching if and only if it satisfies both of the following physical layout conditions:

Lateral Freedom: The tile has no neighboring tile directly touching its left side OR its right side. (At least one lateral side must be entirely open).
Vertical Freedom: 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 locked by overlapping upper layers or pinched between left and right neighbors are shaded or dimmed and cannot be selected until surrounding tiles are cleared.

Rule 2: Matching Categories & Pairing Regulations

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

Suited Tiles (Dots, Bamboo, Characters): Must match exact rank and suit (e.g., 4-Dot matches only another free 4-Dot; 8-Bamboo matches only another free 8-Bamboo).
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 layout from the board selector (e.g., The Turtle, The Monument, The Spider, The Arena).
Select Tile & Table Style: Choose your preferred table mat and tile back design (e.g., Classic Ivory, Jade Stone, Ebony Wood).
Initialize Layout: The 144 Mahjong tiles generate into the selected 3D structure. The timer starts, the playable match counter updates on the HUD, and your peaceful puzzle session begins!

2.3 Fundamental Tactics & Step-by-Step Strategy

Clearing tall, complex tile stacks without running into deadlocks requires methodical spatial management. Master solvers rely on four primary tactical approaches:

Technique 1: Top-Layer & High-Peak Prioritization

Always prioritize matching free tiles located on the highest layer of a stack! Removing top tiles instantly uncovers hidden tiles underneath, expanding your available choices for future turns.

Technique 2: Reducing Long Horizontal Rows

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, opening lateral access across the board.

Technique 3: Quad Scanning & Pair Conservation

Each tile type contains exactly 4 identical copies on the board. When 3 or 4 tiles of the same type become free simultaneously, evaluate the board before making your match! Choose the two tiles that unblock the most critical stacks beneath, holding the remaining pair in reserve.

Technique 4: Preventing Trapped Deadlocks

Never match tiles blindly! If you clear a pair carelessly without inspecting underlying stacks, you may accidentally trap a required matching tile beneath a deep layer, resulting in a board deadlock where zero free matches remain.

2.4 Structure of an Active Gameplay Loop

Gameplay in Mahjongg follows a disciplined, 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 table mat! A triumphant temple bell rings, total completion time is logged, and master rank badges are awarded.

2.5 Guidance Tools & Board Mechanics

Special guidance tools and structural indicators help navigate complex board states:

Feature / Tool	Visual Identifier	Operational Function & Rule Mechanics
Lantern Hint	Glowing Paper Lantern	Highlights 1 unblocked matching pair currently available on the table
Wind Breeze	Swirling Fan Icon	Rearranges all remaining tiles on the board to guarantee at least one valid match
Dewdrop Undo	Water Droplet Icon	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 Classic Solitaire (Standard Mode)

The definitive single-player experience featuring dozens of classic, handcrafted layouts. Clear boards at your own pace while tracking completion times, accuracy rates, and high score records.

2.6.2 Time Attack Sprint (Timed Challenge)

Gameplay: A high-speed race against a running 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 Meditation (Endless Mode)

Gameplay: A completely peaceful, 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 star 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 Mastery Bonus: $+2,500$ Points awarded for clearing a complete 144-tile layout without using any hints or reshuffles.
Star Rating Thresholds:
- 1 Star: Clear the entire layout without running out of moves.
- 2 Stars: Complete the layout within the target time threshold using fewer than 2 boosters.
- 3 Stars: Master the layout rapidly with zero booster assistance and high combo streaks!

2.8 Game End & Victory Conditions

A session in Mahjongg officially concludes upon reaching either of two final outcomes:

Board Cleared (Victory Condition): Every single tile is successfully matched and removed from the table. A serene victory screen displays your time, match efficiency, and earned star badges, unlocking new layouts!
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 Wind Breeze reshuffle, undo your last moves, or restart the layout.

The player who observes carefully, plans every match with wisdom, and clears layouts with calm precision earns the revered title of Grand Master of Mahjongg!

2.9 System Integrity & Field Settings

3D Board Controls: Free-look camera controls allow players to tilt, pan, and rotate the 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 star badges, and high scores sync seamlessly across mobile devices, tablets, and desktop web browsers.

Header AD

Mahjongg