wchan757 / phoenix

CSCI527

CSCI527 Mahjong Agent Repo

AI Documentation

A guide to create AI agent

ai.erase_state()

erase_state is called in table.py for round initialization

ai.init_hand()

init_hand is called in player.py for hand initialization

ai.draw_tile(tile_136)

• tile_136: list of int, 136_array. Generate from TilesConverter.string_to_136_array

tile_to_discard, with_riichi = ai.discard_tile(discard_tile)

• discard_tile: int, 136_tile. Generated from TilesConverter.string_to_136_array[0]. A previous suggestion from ai.try_to_call_meld() or riichi rules. Can be none.
• tile_to_discard: int, 136_tile. Generated from TilesConverter.string_to_136_array[0].
• with_riichi: bool. Should call riichi after tile discard.

ai.kan.should_call_kan(tile, open_kan, from_riichi)

• tile: int, 136_tile. Generated from TilesConverter.string_to_136_array[0].
• open_kan: bool. False for 暗杠.
• from_riichi: bool. Already riichi.
• return: bool. Should call kan.

ai.should_call_win(tile, is_tsumo, enemy_seat, is_chankan)

• tile: int, 136_tile. Generated from TilesConverter.string_to_136_array[0].
• is_tsumo: bool. True for 自摸.
• enemy_seat: int. Generated from player.table.get_players_sorted_by_scores()[x] 放铳者
• is_chankan: bool. True for 抢杠.
• return: bool. Should call win.

ai.should_call_kyuushu_kyuuhai()

• return: bool. Should call kyuushu_kyuuhai(九种九牌).

meld, discard_option = self.ai.try_to_call_meld(tile, is_kamicha_discard)

• tile: int, 136_tile. Generated from TilesConverter.string_to_136_array[0].
• is_kamicha_discard： bool. Discard tile is from opponent on the left(上家).
• meld: meld==none for skip. meld.type=MeldPrint.CHI\PON, meld.tiles=list of int, size of 3, 136_array. meld.opened=bool.
• discard_option: int, 136_tile. Tile to discard.

ai.enemy_called_riichi(player_seat)

• player_seat: int.