Skip to content

v2 Japanese

Jump to bottom
github-actions[bot] edited this page Mar 30, 2026 · 8 revisions

Python 3.10以上に対応しています。

本ライブラリには日本麻雀（立直麻雀）用の様々なツール（シャンテン数計算、和了判定、点数計算）が含まれています。

立直麻雀の点数計算

本パッケージは立直麻雀の手牌詳細（飜、符、役、点数）を計算するために使用できます。

以下のオプション機能をサポートしています:

機能 キーワード引数 デフォルト値
喰い断を有効にするかどうか has_open_tanyao False
赤ドラを有効にするかどうか has_aka_dora False
ダブル役満（四暗刻単騎など）を有効にするかどうか has_double_yakuman True
非役満役の累計飜数の上限設定（数え役満/数え三倍満/上限なし） kazoe_limit HandConstants.KAZOE_LIMITED
切り上げ満貫を有効にするかどうか kiriage False
喰い平和形ロンに2符を追加するかどうか fu_for_open_pinfu True
平和のツモ符を有効にするかどうか fu_for_pinfu_tsumo False
人和を役満とするかどうか（無効の場合は5飜） renhou_as_yakuman False
大車輪（門前清 22334455667788筒）を有効にするかどうか has_daisharin False
色違いの大車輪（索子：大竹林、萬子：大数隣）を有効にするかどうか has_daisharin_other_suits False
オープン立直への放銃を役満にするかどうか has_sashikomi_yakuman False
役満複合の上限を6にするかどうか（最高 192000 点） limit_to_sextuple_yakuman True
大七星（字一色七対子）を有効にするかどうか has_daichisei False
八連荘に役が必要かどうか paarenchan_needs_yaku True

コードはtenhou.net（天鳳）鳳凰卓の牌譜26,148,038局で検証済みです。

したがって、本パッケージの手牌計算機は天鳳の手牌計算と同様に動作すると言えます。

使い方

次の手牌の点数を計算してみましょう:

image

断么九ロン

from mahjong.hand_calculating.hand import HandCalculator
from mahjong.tile import TilesConverter
from mahjong.hand_calculating.hand_config import HandConfig
from mahjong.meld import Meld

# we had to use all 14 tiles in that array
tiles = TilesConverter.string_to_136_array(man='22444', pin='333567', sou='444')
win_tile = TilesConverter.string_to_136_array(sou='4')[0]

result = HandCalculator.estimate_hand_value(tiles, win_tile)

print(result.han, result.fu)
print(result.cost['main'])
print(result.yaku)
for fu_item in result.fu_details:
    print(fu_item)

出力:

1 40
1300
[Tanyao]
{'fu': 30, 'reason': 'base'}
{'fu': 4, 'reason': 'closed_pon'}
{'fu': 4, 'reason': 'closed_pon'}
{'fu': 2, 'reason': 'open_pon'}

ツモの場合

result = HandCalculator.estimate_hand_value(tiles, win_tile, config=HandConfig(is_tsumo=True))

print(result.han, result.fu)
print(result.cost['main'], result.cost['additional'])
print(result.yaku)
for fu_item in result.fu_details:
    print(fu_item)

出力:

4 40
4000 2000
[Menzen Tsumo, Tanyao, San Ankou]
{'fu': 20, 'reason': 'base'}
{'fu': 4, 'reason': 'closed_pon'}
{'fu': 4, 'reason': 'closed_pon'}
{'fu': 4, 'reason': 'closed_pon'}
{'fu': 2, 'reason': 'tsumo'}

副露がある場合

from mahjong.hand_calculating.hand_config import OptionalRules

melds = [Meld(meld_type=Meld.PON, tiles=TilesConverter.string_to_136_array(man='444'))]

result = HandCalculator.estimate_hand_value(tiles, win_tile, melds=melds, config=HandConfig(options=OptionalRules(has_open_tanyao=True)))

print(result.han, result.fu)
print(result.cost['main'])
print(result.yaku)
for fu_item in result.fu_details:
    print(fu_item)

出力:

1 30
1000
[Tanyao]
{'fu': 20, 'reason': 'base'}
{'fu': 4, 'reason': 'closed_pon'}
{'fu': 2, 'reason': 'open_pon'}
{'fu': 2, 'reason': 'open_pon'}

立直と裏ドラ

裏ドラ表示牌は ura_dora_indicators パラメーターで指定できます。裏ドラは立直後の和了の場合のみカウントされます。

tiles = TilesConverter.string_to_136_array(man='22444', pin='333567', sou='444')
win_tile = TilesConverter.string_to_136_array(sou='4')[0]
dora_indicators = TilesConverter.string_to_136_array(man='1')
ura_dora_indicators = TilesConverter.string_to_136_array(pin='2')

result = HandCalculator.estimate_hand_value(
    tiles,
    win_tile,
    dora_indicators=dora_indicators,
    ura_dora_indicators=ura_dora_indicators,
    config=HandConfig(is_riichi=True, is_tsumo=True),
)

print(result.han, result.fu)
print(result.yaku)

出力:

10 40
[Menzen Tsumo, Riichi, Tanyao, San Ankou, Dora 2, Ura Dora 3]

シャンテン数計算

シャンテン数はテンパイ（あと1枚で和了）に到達するまでに必要な最小の牌交換回数を示します。0 はテンパイ、-1 は既に和了形（完成形）であることを意味します。

calculate_shanten は一般形、七対子、国士無双の3つの形のシャンテン数を計算し、最小値を返します。各形のシャンテン数を個別に計算することもできます。

from mahjong.shanten import Shanten
from mahjong.tile import TilesConverter

# 一般形、2シャンテン
tiles = TilesConverter.string_to_34_array(man='13569', pin='123459', sou='443')
print("一般形シャンテン数:", Shanten.calculate_shanten(tiles))

# テンパイ（0シャンテン、あと1枚で和了）
tiles = TilesConverter.string_to_34_array(sou='111345677', pin='11', man='567')
print("テンパイ:", Shanten.calculate_shanten(tiles))

# 和了形（-1シャンテン、既に完成）
tiles = TilesConverter.string_to_34_array(sou='111234567', pin='11', man='567')
print("和了形:", Shanten.calculate_shanten(tiles))

# 各形のシャンテン数を個別に計算
tiles = TilesConverter.string_to_34_array(sou='114477', pin='114477', man='76')
print("七対子シャンテン数:", Shanten.calculate_shanten_for_chiitoitsu_hand(tiles))

tiles = TilesConverter.string_to_34_array(sou='129', pin='19', man='19', honors='1234567')
print("国士無双シャンテン数:", Shanten.calculate_shanten_for_kokushi_hand(tiles))

出力:

一般形シャンテン数: 2
テンパイ: 0
和了形: -1
七対子シャンテン数: 0
国士無双シャンテン数: 0

和了判定

和了判定は、与えられた手牌が完成形（4面子1雀頭、七対子、国士無双）かどうかを判定します。牌の構成のみを検証し、役や点数の判定は行いません。シャンテン数が-1かどうかを確認するよりも高速なため、手牌が完成形かどうかだけを確認したい場合はAgari.is_agari()を使用してください。

from mahjong.agari import Agari
from mahjong.tile import TilesConverter

# 完成形：123s 456s 789s 123p 33m
tiles = TilesConverter.string_to_34_array(sou='123456789', pin='123', man='33')
print("一般形:", Agari.is_agari(tiles))

# 未完成形：123s 456s 789s 12345p
tiles = TilesConverter.string_to_34_array(sou='123456789', pin='12345')
print("未完成形:", Agari.is_agari(tiles))

# 七対子：1133557799s 1199p
tiles = TilesConverter.string_to_34_array(sou='1133557799', pin='1199')
print("七対子:", Agari.is_agari(tiles))

# 国士無双：19s 19p 199m 1234567z
tiles = TilesConverter.string_to_34_array(sou='19', pin='19', man='199', honors='1234567')
print("国士無双:", Agari.is_agari(tiles))

# 副露あり（槓子）：1111m 123456789p 22s
tiles = TilesConverter.string_to_34_array(man='1111', pin='123456789', sou='22')
open_set = [0, 0, 0, 0]  # 一萬の槓子（34牌形式のインデックス0）
print("副露あり（槓子）:", Agari.is_agari(tiles, [open_set]))

出力:

一般形: True
未完成形: False
七対子: True
国士無双: True
副露手（槓子）: True

青天井ルール

from mahjong.hand_calculating.hand import HandCalculator
from mahjong.hand_calculating.hand_config import HandConfig
from mahjong.hand_calculating.scores import Aotenjou
from mahjong.tile import TilesConverter
from mahjong.meld import Meld
from mahjong.constants import EAST

tiles = TilesConverter.string_to_136_array(honors='111133555566667777')
win_tile = TilesConverter.string_to_136_array(honors='3')[0]

melds = [
    Meld(meld_type=Meld.KAN, tiles=TilesConverter.string_to_136_array(honors='1111'), opened=False),
    Meld(meld_type=Meld.KAN, tiles=TilesConverter.string_to_136_array(honors='5555'), opened=False),
    Meld(meld_type=Meld.KAN, tiles=TilesConverter.string_to_136_array(honors='6666'), opened=False),
    Meld(meld_type=Meld.KAN, tiles=TilesConverter.string_to_136_array(honors='7777'), opened=False),
]

result = HandCalculator.estimate_hand_value(
    tiles,
    win_tile,
    melds=melds,
    dora_indicators=TilesConverter.string_to_136_array(honors='4444'),
    ura_dora_indicators=TilesConverter.string_to_136_array(honors='7777'),
    scores_calculator_factory=Aotenjou,
    config=HandConfig(
        is_riichi=True,
        is_tsumo=True,
        is_ippatsu=True,
        is_haitei=True,
        player_wind=EAST,
        round_wind=EAST,
    ),
)

print(result.han, result.fu)
print(result.cost['main'])
print(result.yaku)
for fu_item in result.fu_details:
    print(fu_item)

出力:

103 160
12980742146337069071326240823050300
[Menzen Tsumo, Riichi, Ippatsu, Haitei Raoyue, Yakuhai (seat wind east), Yakuhai (round wind east), Daisangen, Suu Kantsu, Tsuu Iisou, Suu Ankou Tanki, Dora 16, Ura Dora 16]
{'fu': 32, 'reason': 'closed_terminal_kan'}
{'fu': 32, 'reason': 'closed_terminal_kan'}
{'fu': 32, 'reason': 'closed_terminal_kan'}
{'fu': 32, 'reason': 'closed_terminal_kan'}
{'fu': 20, 'reason': 'base'}
{'fu': 2, 'reason': 'pair_wait'}
{'fu': 2, 'reason': 'tsumo'}

Documentation

v2

v1

Home

Clone this wiki locally