CSCI527 Mahjong Agent Repo
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.