Formal Specification
Official Promotion Chart — Formal Specification
China · board-race · Confidence: high
← Back to game pageImplementation Suitability
Suitability: engine-readyFidelity: directGap-fills: 3
# Sheng Guan Tu — AI-optimized specification
## General idea
A classical Chinese roll-and-move bureaucratic career board game played on a large directed graph of imperial civil service offices. Players start as unranked scholars (*Baiding* / *Tongshi*) and advance through administrative ranks (Six Ministries, Censorate, Hanlin Academy, Provincial posts) by spinning a four-sided wooden top marked with evaluation outcomes: **Virtue (德, *De*)**, **Talent (才, *Cai*)**, **Merit (功, *Gong*)**, and **Corruption (赃, *Zang*)**. The first player to reach the supreme central office (Grand Preceptor / *Taishi*) and spin a qualifying virtuous assessment achieves honorable retirement (*Ronggui Guli*) to win the game.
## Formal model
- **Abstraction taken:** None required; the board layout is directly formalized as a discrete directed multigraph where each vertex has exactly four outgoing directed edges corresponding to the four top-spin outcomes.
- **Player/agent count:** 2 to 6 players.
- **Turn model:** Sequential clockwise turns.
## Formal rules
R1. Board Graph: A directed multigraph consisting of administrative office nodes. Each node contains 4 deterministic outgoing directed edges:
R2. Setup: All players place their tokens on the starting entry node (*Baiding*).
R3. Turn Execution: On their turn, the active player spins the four-sided top. The outcome is sampled from a uniform discrete distribution:
R4. Movement & Transition:
- **Virtue (德, *De*):** Grants the highest promotion leap (skipping intermediate ranks to prestigious central departments or imperial tutor posts).
- **Talent (才, *Cai*):** Standard accelerated promotion to a superior office.
- **Merit (功, *Gong*):** Routine incremental promotion or lateral departmental transfer.
- **Corruption (赃, *Zang*):** Penalty outcome; demotes the official to a lower provincial post, strips rank, sends the player to Prison (*Yubao*), or returns them to *Baiding*.
- The player's token immediately advances along the corresponding directed edge: .
R5. Prison Node Mechanic (*Yubao*): A player in Prison must spin *De* (Virtue) or *Gong* (Pardon) to exit back to entry-level office; spinning *Zang* retains them in prison for another round.
R6. Win Condition: When a player reaches the supreme office node (*Taishi*) and subsequently spins *De* on their turn, they complete the imperial career (*Ronggui Guli*) and win the game immediately.
R7. [gap-fill] Censorate Interception: If a player reaches the Censor-in-Chief (*Yushi Dafu*), they may levy a 1-turn suspension on any opponent currently occupying a provincial magistrate post.
R8. [gap-fill] Loop-Breaking Turn Cap: If no player achieves imperial retirement within 200 total rounds, the player occupying the highest official rank (evaluated by civil service grade 1–9) is declared the winner.
R9. [gap-fill] Tiebreaker on Points: If rank grades are tied at the 200-round limit, the player with the fewest cumulative *Zang* (Corruption) penalties wins.
## Edge cases
- **Tie at the end condition:** Turns are sequential, so the first player to achieve *Ronggui Guli* wins. Under the R8 turn cap, ties are broken by rank grade, then fewest corruption demotions (R9).
- **A player with no legal move:** Not applicable; spinning the four-sided top is always mandatory and legal.
- **Repetition / cycles:** Cycles of promotion and demotion are strictly bounded by R8's 200-round limit.
- **Simultaneous claims on the same resource or position:** Multiple player tokens may occupy the same administrative office square simultaneously without collision or blocking.
- **Player elimination mid-round:** Not applicable; all players remain active regardless of demotions.
- **Resource exhaustion:** Board graph nodes are reusable and permanent.
- **Termination guarantee:** Provably terminates within 200 rounds by R8.
## State representation
- **Persistent state:** `token_positions[player_id] \in V`, `cumulative_zang_count[player_id]`, `round_counter (0..200)`.
- **Ephemeral state:** `active_player_index`, `last_spin_outcome`, `previous_position`, `new_position`.
- **Observable information:** Fully observable perfect-information game board.
## Action space
- `spin_top()`: Sample random evaluation outcome from the four-sided top.
## Playability notes
- **Single-player-vs-AI:** Highly playable as a stochastic roll-and-move race against AI bots.
- **Group games (n>4):** Scales smoothly from 2 to 6 players with zero modification to the underlying graph structure.
- **What is lost in the adaptation:** The tactile joy of spinning the carved wooden peg top on smooth porcelain, reading the classical calligraphy on the folding chart, and satirical family commentary on imperial bureaucracy.
## Implementation hints
Directed graph adjacency table. Each of the 120 nodes is stored as a 4-element integer array `dest[4]` indexed by `{0: De, 1: Cai, 2: Gong, 3: Zang}`. State transitions require only a single array lookup `pos = nodes[pos].dest[spin]`.
Download as JSON
Download the full game corpus entry for this game as structured JSON.
Download JSONCite this page
Official Promotion Chart (China). (n.d.). Games of Countries. https://gamesofcountries.com/games/cn-china/sheng-guan-tu
@misc{gamesofcountries-cn-china-sheng-guan-tu,
title = {Official Promotion Chart (China)},
year = {n.d.},
publisher = {Games of Countries},
url = {https://gamesofcountries.com/games/cn-china/sheng-guan-tu}
}