zombiedice 0.1.6

快速入门

要安装，请运行通常的 pip install zombiedice（在Windows上）或 pip3 install zombiedice（在macOS/Linux上）。

您可以通过运行 python -m zombiedice（在Windows上）或 pip3 install zombiedice（在macOS/Linux上）来查看包含一些预制机器人的演示。

或者，您可以运行 import zombiedice; zombiedice.demo()

首先，您需要创建自己的僵尸。这是通过创建一个实现 turn() 方法（当轮到您的僵尸时被调用）的类来完成的。如果想要再次掷骰子，则 turn() 方法将调用 zombiedice.roll() 函数，或者返回以表示其回合结束。该 turn() 方法接受一个表示游戏状态的参数（稍后在页面上进行说明）。该类还应有一个 'name' 属性，其中包含玩家名称的字符串。（这样就可以在游戏中为多个玩家使用相同的类。）

zombiedice.roll() 函数返回一个字典列表。这些字典代表掷骰子的结果；它有 'color' 和 'icon' 键，它们可能的值为 'green'、'yellow'、'red' 和 'shotgun'、'brains' 以及 'footsteps'。列表将包含三个这样的字典，代表三次掷骰子的结果。如果玩家掷出了三个以上的霰弹枪，则该列表将为空。

以下是一个示例僵尸，它会一直掷骰子，直到掷出两个霰弹枪为止，然后停止。更多示例僵尸可以在 examples.py 文件中找到，位于 zombiedice 包内。

class StopsAt2ShotgunsZombie(object):
    """This bot keeps rolling until it reaches 2 shotguns."""
    def __init__(self, name):
        self.name = name

    def turn(self, gameState):
        shotgunsRolled = 0
        while shotgunsRolled < 2:
            results = roll()

            if results == []:
                # Zombie has reached 3 or more shotguns.
                return

            for i in results:
                # Count shotguns in results.
                if i[ICON] == SHOTGUN:
                    shotguns += 1

接下来，您需要运行一个锦标赛。创建一个调用 zombiedice.runWebGui()（用于美观的网页用户界面）或 zombiedice.runTournament()（用于纯命令行界面）的文件。一个典型的文件将类似于 demo.py 文件，位于 repo。

import zombiedice

zombies = (
    zombiedice.examples.RandomCoinFlipZombie(name='Random'),
    zombiedice.examples.MonteCarloZombie(name='Monte Carlo', riskiness=40, numExperiments=20),
    zombiedice.examples.MinNumShotgunsThenStopsZombie(name='Min 2 Shotguns', minShotguns=2)
    # Add any other zombie players here.
)

# Uncomment one of the following lines to run in CLI or Web GUI mode:
#zombiedice.runTournament(zombies=zombies, numGames=1000)
zombiedice.runWebGui(zombies=zombies, numGames=1000)

示例僵尸

模块中包含了一些示例僵尸。

• zombiedice.examples.RandomCoinFlipZombie(name) - 随机决定是否继续掷骰子或退出，概率各为50%。

• zombiedice.examples.MinNumShotgunsThenStopsZombie(name, minShotguns) - 持续掷骰子，直到掷出指定数量的霰弹枪。

• zombiedice.examples.MinNumShotgunsThenStopsOneMoreZombie(name, minShotguns) - 与 MinNumShotgunsThenStopsZombie 类似，但将再掷一次骰子。

• zombiedice.examples.HumanPlayerZombie(name) - 调用 input() 允许人类玩家与机器人对战。

• zombiedice.examples.RollsUntilInTheLeadZombie(name) - 持续掷骰子，直到成为第一名。

• zombiedice.examples.MonteCarloZombie(name, riskiness, numExperiments) - 进行蒙特卡洛模拟（numExperiments）以确定再次掷骰子会发生什么。只要模拟结果显示掷出三个霰弹枪的概率低于 riskiness，它就会再次掷骰子。

TODO

关于此模块如何工作的更多详细信息即将推出。