Skip to main content
Formal Specification

Official Promotion Chart — Formal Specification

China · board-race · Confidence: high

← Back to game page

Implementation 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 G=(V,E) consisting of |V|=120 administrative office nodes. Each node u∈V contains 4 deterministic outgoing directed edges: out(u)={eDe(u),eCai(u),eGong(u),eZang(u)} R2. Setup: All players place their tokens on the starting entry node vstart=Commoner / Scholar (*Baiding*). R3. Turn Execution: On their turn, the active player spins the four-sided top. The outcome O∈{De,Cai,Gong,Zang} is sampled from a uniform discrete distribution: P(O=De)=P(O=Cai)=P(O=Gong)=P(O=Zang)=0.25 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: pos(t+1)=eO(pos(t)). 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 vsupreme=Grand Preceptor (*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 JSON
Cite 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}
}