Formal Specification
Wheel of Eternity (Zodiac tile game) — Formal Specification
Mongolia · tile · Confidence: low
← Back to game pageImplementation Suitability
Suitability: engine-readyFidelity: directGap-fills: 2
# Khorol — AI-optimized specification
## General idea
A 4-player partnership trick-taking and meld game played with a 60-tile deck divided into Master/Buddhist tiles (*Deed mod*) and Earth/Zodiac tiles (*Gazar mod*). Master tiles strictly beat Earth tiles, and Earth tiles rank in calendar zodiac order (Mouse down to Pig). Strategic depth centers on trick management, trump timing, and building 4-of-a-kind sets ("Gers" / *ger barikh*).
## Formal model
- **Abstraction taken:** Direct discrete tile/card formalization. The 60-tile set is modeled as unique discrete elements: 3 suits of Master tiles (4 Khorol, 4 Chandmani, 4 Ölziy) and 12 ranks of Earth tiles (4 copies each of Mouse..Pig).
- **Player/agent count:** 4 agents seated in partnership pairs: Team A (P0, P2) vs. Team B (P1, P3).
- **Turn model:** Sequential discrete trick-taking turns, clockwise rotation.
## Formal rules
R1. Setup: 60 tiles are shuffled and dealt equally: 15 tiles to each of the 4 agents.
R2. Tile ranking hierarchy:
- Rank 1 (Highest Master): `Khorol` (4 tiles)
- Rank 2: `Chandmani` (4 tiles)
- Rank 3: `Ölziy` (4 tiles)
- Ranks 4–15 (Earth/Zodiac, highest to lowest): `Mouse` > `Ox` > `Tiger` > `Rabbit` > `Dragon` > `Snake` > `Horse` > `Sheep` > `Monkey` > `Rooster` > `Dog` > `Pig` (4 tiles each).
R3. Pre-play Meld Declaration (*Ger barikh*):
- Before the first trick, any agent holding all 4 identical copies of any tile may reveal them to declare a completed "Ger" (+4 bonus points). Holding 4 Horses awards +8 bonus points (*Lucky Four Horses*).
R4. Trick structure:
- The lead player plays a combination `C` of 1, 2, or 3 matching identical tiles (Single, Pair, or Triplet) from hand.
- In clockwise order, each subsequent player must play an equal quantity `|C|` of tiles.
- Following/Beating rule: To win the trick, a player must play a higher-ranking tile/set of the same quantity. If unable or unwilling to beat, the player discards any `|C|` tiles face-up into the trick.
R5. Trick resolution: The player who played the strictly highest-ranking tile/set wins all tiles played in that trick, stores them in their partnership trick pile, and leads the next trick.
R6. [gap-fill] Equal-rank resolution: If two players play identical-ranking tiles in the same trick, the first-played tile takes precedence and wins.
R7. End of hand & scoring:
- A hand ends when all 15 tricks/cards have been played.
- Scoring: Partnership score = `tricks_won + sum(ger_bonuses)`.
R8. [gap-fill] Match target: Matches are played to a target threshold of 30 points across multiple hands. The partnership that reaches 30 points first wins.
## Edge cases
- Tie at the end condition: If both partnerships reach >= 30 points on the same hand, the team with the higher score wins; if exactly tied, another hand is played.
- A player with no legal move: Not applicable — a player must always discard `|C|` tiles if they cannot beat the lead.
- Repetition / cycles: Hand sizes decrease by `|C|` on every trick; exactly 15 card-plays empty all hands, guaranteeing termination.
- Simultaneous claims on the same resource: Not applicable — turns and trick plays are strictly sequential.
- Player elimination mid-round: Not applicable — all 4 players remain active throughout.
- Resource exhaustion: Hand exhaustion triggers end-of-hand scoring.
- Termination guarantee: Provably terminates in exactly 15 trick cycles per hand.
## State representation
- Persistent state: `team_scores` (map of Team -> integer), `hand_number` (integer), `target_score` (30).
- Per-hand state: `hands` (map of Player -> multiset of tile IDs, size 0..15), `partnership_captured_tiles` (list of tiles), `active_lead_player` (0..3).
- Per-trick ephemeral state: `lead_combination_size` (1..3), `played_tiles_in_trick` (list of `(player_id, tiles)`), `current_winning_player`.
- Observable information: Hand tiles are private to the holding agent; declared Gers, played trick cards, and captured totals are public.
## Action space
- `declare_ger(tile_rank)`: Reveal 4 identical tiles in hand during pre-play phase.
- `lead_trick(tiles)`: Play 1, 2, or 3 matching tiles from hand.
- `follow_trick(tiles)`: Play equal quantity of tiles (higher rank to contest, or discard).
## Playability notes
- Single-player-vs-AI: Natural — 1 human partnered with 1 AI agent vs. 2 AI opponents.
- Group games (n>4): Adaptable to 3 players (12 tiles dealt, remaining tiles form a 24-tile draw pool) or 5 players.
- Physical-skill games: Deterministic card/tile game with imperfect information.
- What is lost in the adaptation: The physical carving texture of wooden tiles and the festive New Year atmosphere in the yurt.
## Implementation hints
Standard trick-taking engine representation (similar to Tichu or Sheng Ji). Milestone 1: single-hand trick evaluator and tile ranking comparator; Milestone 2: partnership AI with basic trick-counting and suit-tracking heuristics.
Download as JSON
Download the full game corpus entry for this game as structured JSON.
Download JSONCite this page
Khorol (Mongolia). (n.d.). Games of Countries. https://gamesofcountries.com/games/mn-mongolia/khorol
@misc{gamesofcountries-mn-mongolia-khorol,
title = {Khorol (Mongolia)},
year = {n.d.},
publisher = {Games of Countries},
url = {https://gamesofcountries.com/games/mn-mongolia/khorol}
}