pyhtzee

支持常规Yahtzee规则（最高1480）、Joker规则（最高1575）和Yatzy（又称北欧Yahtzee规则，最高305）的游戏引擎。示例代码

from pyhtzee import Pyhtzee
from pyhtzee.classes import Category, Rule
from pyhtzee.utils import category_to_action_map, dice_roll_to_action_map

pyhtzee = Pyhtzee(rule=Rule.FREE_CHOICE_JOKER)
print(pyhtzee.dice)

这显示了骰子

[2, 5, 6, 1, 6]

接下来重掷骰子1、2和5

action = dice_roll_to_action_map[(True, True, False, False, True)]
pyhtzee.take_action(action)
print(pyhtzee.dice)

现在我们有两组

[4, 6, 6, 1, 1]

让我们只重掷第一颗骰子，看看我们是否能得到一个满贯

action = dice_roll_to_action_map[(True, False, False, False, False)]
pyhtzee.take_action(action)
print(pyhtzee.dice)

bingo!

[6, 6, 6, 1, 1]

现在让我们选择满贯的动作并查看计分卡

action = category_to_action_map[Category.FULL_HOUSE]
reward = pyhtzee.take_action(action)
print(f'Reward: {reward}, Scorecard: {pyhtzee.scores}')

这显示我们获得了25分的奖励，这可以在计分卡中确认

Reward: 25, Scorecard: {<Category.FULL_HOUSE: 8>: 25}

开发者指南

Pipenv推荐用于设置开发环境。在安装pipenv之前，建议创建一个包含以下内容的.env文件

PYTHONPATH=.

要安装pipenv和所需的依赖项，请运行以下命令

pip install pipenv
pipenv install -r requirements.txt
pipenv shell

更新依赖项

requirements.txt是使用pip-compile动态生成的。要重新生成requirements.txt文件，请运行以下命令

pip-compile -U --output-file requirements.txt setup.py requirements-dev.in

Pre-commit钩子

本项目使用Git pre-commit钩子，由pre-commit提供。要安装，请运行以下命令

pre-commit install