package mjxproto

Get desktop application:
View/edit binary Protocol Buffers messages

• rpc TakeAction (Observation, Action)

  mjx.proto:6

  message Observation

  mjx.proto:120

  • int32 who = 1

  • optional PublicObservation public_observation = 2

  • optional PrivateObservation private_observation = 3

  • optional RoundTerminal round_terminal = 4

  • repeated Action legal_actions = 5

Used as response type in: Agent.TakeAction

Used as field type in: Observation

• ActionType type = 1

  tile open DISCARD Yes No TSUMOGIRI Yes No RIICHI No No TSUMO Yes No CLOSED_KAN No Yes ADDED_KAN No Yes KYUSYU No No NO No No CHI No Yes PON No Yes OPEN_KAN No Yes RON Yes No

• int32 who = 2

  0:起家, ..., 3:ラス親

• uint32 tile = 3

  Indicates the tile id (0 ~ 135)

• uint32 open = 4

  Each open (鳴き) is encoded by Tenhou format. See https://github.com/NegativeMjark/tenhou-log#meld-format

Used in: Action

• ACTION_TYPE_DISCARD = 0

  After draw

• ACTION_TYPE_TSUMOGIRI = 1

• ACTION_TYPE_RIICHI = 2

• ACTION_TYPE_CLOSED_KAN = 3

• ACTION_TYPE_ADDED_KAN = 4

• ACTION_TYPE_TSUMO = 5

• ACTION_TYPE_ABORTIVE_DRAW_NINE_TERMINALS = 6

  九種九牌

• ACTION_TYPE_CHI = 7

  After other's discard

• ACTION_TYPE_PON = 8

• ACTION_TYPE_OPEN_KAN = 9

• ACTION_TYPE_RON = 10

• ACTION_TYPE_NO = 11

• ACTION_TYPE_DUMMY = 99

  Dummy used only to check connection and share round terminal information

Used in: PublicObservation

• EventType type = 1

  Publicly observable event, which include 1. publicly observable and actually realized actions taken by all layers 2. publicly observable state transitions made by envionment Note that "No" action is **NOT** collected as event since it's not publicly observable. Also, "Chi" prevented by other player's "Pon/Ron" is also **NOT** collected in event_history. Drawn tile does not use tile entry because it's not publicly observable. Only the fact that the player drew something is collected. Table. Is who/tile/open entry set? who tile open 0. DISCARD Yes Yes No 1. TSUMOGIRI Yes Yes No 2. RIICHI Yes No No 3. CLOSED_KAN Yes No Yes 4. ADDED_KAN Yes No Yes 5. TSUMO Yes Yes No 6. ABORTIVE_DRAW_NINE_TERMINALS Yes No No 7. CHI Yes No Yes 8. PON Yes No Yes 9. OPEN_KAN Yes No Yes 10. RON Yes Yes No 12. DRAW Yes No No 13. RIICHI_SCORE_CHANGE Yes No No 14. NEW_DORA No Yes No 15. ABORTIVE_DRAW_FOUR_RIICHIS No No No 16. ABORTIVE_DRAW_THREE_RONS No No No 17. ABORTIVE_DRAW_FOUR_KANS No No No 18. ABORTIVE_DRAW_FOUR_WINDS No No No 19. EXHAUSTIVE_DRAW_NORMAL No No No 20. EXHAUSTIVE_DRAW_NAGASHI_MANGAN No No No

• int32 who = 2

• uint32 tile = 3

• uint32 open = 4

Used in: Event

• EVENT_TYPE_DISCARD = 0

  Publicly observable actions

• EVENT_TYPE_TSUMOGIRI = 1

  ツモ切り, Tsumogiri

• EVENT_TYPE_RIICHI = 2

• EVENT_TYPE_CLOSED_KAN = 3

• EVENT_TYPE_ADDED_KAN = 4

• EVENT_TYPE_TSUMO = 5

• EVENT_TYPE_ABORTIVE_DRAW_NINE_TERMINALS = 6

• EVENT_TYPE_CHI = 7

• EVENT_TYPE_PON = 8

• EVENT_TYPE_OPEN_KAN = 9

• EVENT_TYPE_RON = 10

• EVENT_TYPE_DRAW = 12

  State transitions made by environment. There is no decision making by players. 11 is skipped for the consistency to ActionType

• EVENT_TYPE_RIICHI_SCORE_CHANGE = 13

• EVENT_TYPE_NEW_DORA = 14

• EVENT_TYPE_ABORTIVE_DRAW_FOUR_RIICHIS = 15

  四家立直

• EVENT_TYPE_ABORTIVE_DRAW_THREE_RONS = 16

  三家和了

• EVENT_TYPE_ABORTIVE_DRAW_FOUR_KANS = 17

  四槓散了

• EVENT_TYPE_ABORTIVE_DRAW_FOUR_WINDS = 18

  四風連打

• EVENT_TYPE_EXHAUSTIVE_DRAW_NORMAL = 19

  通常流局

• EVENT_TYPE_EXHAUSTIVE_DRAW_NAGASHI_MANGAN = 20

  流し満貫

• uint64 game_seed = 1

• repeated string player_ids = 2

  Sorted by the dealer order (起家, ..., ラス親)

• map<string, int32> tens = 3

• map<string, int32> rankings = 4

  ranking in {1, 2, 3, 4}

Used in: PrivateObservation, TenpaiHand, Win

• repeated uint32 closed_tiles = 1

• repeated uint32 opens = 2

  [1st open, 2nd open, ...]

Used in: State

• uint64 game_seed = 1

• repeated uint32 wall = 2

• repeated uint32 ura_dora_indicators = 3

  len(ura_dora_indicators) = 1 + # of Kan

Used in: RoundTerminal

• repeated TenpaiHand tenpais = 1

• repeated int32 ten_changes = 2

  Required for Tenhou mjlog.

Used in: Observation, State

• int32 who = 1

• optional Hand init_hand = 2

• repeated uint32 draw_history = 3

• optional Hand curr_hand = 4

Used in: Observation, State

• string game_id = 1

• repeated string player_ids = 2

  Sorted by the dealer order (起家, ..., ラス親)

• optional Score init_score = 3

  public info

• repeated uint32 dora_indicators = 4

  len(dora_indicators) = 1 + # of Kan

• repeated Event events = 5

Used in: Observation, State

• optional Score final_score = 1

• repeated Win wins = 2

  Empty if no one wins

• optional NoWinner no_winner = 3

  Empty if a winner exists

• bool is_game_over = 4

Used in: PublicObservation, RoundTerminal

• uint32 round = 1

• uint32 honba = 2

• uint32 riichi = 3

  For final score, riichi = 0 if someone wins (or at the end of game)

• repeated int32 tens = 4

  Following rule holds for all rounds: sum(score.ten) + score.riichi * 1000 == 100000

• optional HiddenState hidden_state = 1

• optional PublicObservation public_observation = 2

• repeated PrivateObservation private_observations = 3

• optional RoundTerminal round_terminal = 4

Used in: NoWinner

• int32 who = 1

• optional Hand hand = 2

Used in: RoundTerminal

• int32 who = 1

• int32 from_who = 2

• optional Hand hand = 3

• uint32 win_tile = 4

• uint32 fu = 5

• uint32 ten = 6

• repeated int32 ten_changes = 7

  Required for Tenhou mjlog.

• repeated uint32 yakus = 8

• repeated uint32 fans = 9

• repeated uint32 yakumans = 10

• repeated uint32 ura_dora_indicators = 11

  set if this player is under riichi