TextWorld

一个基于文本的游戏生成器和可扩展的沙盒学习环境，用于训练和测试强化学习（RL）代理。更多关于 TextWorld 及其创建者的信息，请访问 aka.ms/textworld。如有问题或反馈，请发送至 textworld@microsoft.com 或使用上面列出的 Gitter 频道。

安装

TextWorld 目前仅支持 Linux 和 macOS 系统上的 Python 3.9/3.10/3.11/3.12。对于 Windows 用户，可以使用 Docker 作为临时解决方案（请参阅下方的 Docker 部分）。

要求

TextWorld 需要一些系统库来支持其原生组件。在基于 Debian/Ubuntu 的系统上，可以通过以下命令安装：

sudo apt update && sudo apt install build-essential libffi-dev python3-dev curl git

在 macOS 上，可以使用：

brew install libffi curl git

注意： 我们建议用户使用虚拟环境，以避免不同项目的 Python 包相互干扰。常见的选择包括 Conda 环境和 Virtualenv

安装 TextWorld

安装 TextWorld 最简单的方法是通过 pip：

pip install textworld

或者，克隆仓库后，进入项目根目录（即 setup.py 所在的目录），运行：

pip install .

可视化

TextWorld 附带了一些用于可视化游戏状态的工具。确保通过运行以下命令安装所有依赖：

pip install textworld[vis]

然后，您需要安装 Chrome 或 Firefox 网页驱动程序（取决于您当前安装的浏览器）。如果您已经安装了 Chrome，可以使用以下命令安装 chromedriver：

pip install chromedriver_installer

当前的可视化工具包括：textworld.render 中的 take_screenshot、visualize 和 show_graph。

Docker

DockerHub 上提供了一个包含最新 TextWorld 发布版的 Docker 容器。

docker pull marccote19/textworld
docker run -p 8888:8888 -it --rm marccote19/textworld

然后，在浏览器中导航到终端中显示的 Jupyter notebook 链接。链接应该类似于：

http://127.0.0.1:8888/?token=8d7aaa...e95

注意： 有关故障排除信息，请参阅 docker 文件夹中的 README.md。

使用方法

生成游戏

TextWorld 通过 tw-make 脚本提供了一种简单的方法来生成基于文本的游戏。例如：

tw-make custom --world-size 5 --nb-objects 10 --quest-length 5 --seed 1234 --output tw_games/custom_game.z8

其中 custom 表示我们想要使用以下选项自定义游戏：--world-size 控制世界中的房间数量，--nb-objects 控制可以交互的物体数量（不包括门），--quest-length 控制获胜所需输入的最少命令数。完成后，游戏 custom_game.z8 将保存在 tw_games/ 文件夹中。

玩游戏（终端）

要玩游戏，可以使用 tw-play 脚本。例如，玩上一节生成的游戏的命令是：

tw-play tw_games/custom_game.z8

注意： 仅支持 Z-machine 游戏（*.z1 到 .z8）和 Glulx 游戏（.ulx）。

要在游戏过程中可视化游戏状态，请使用 --viewer [port] 选项。

tw-play tw_games/custom_game.z8 --viewer

一个新的浏览器标签页应该会打开并跟踪您在游戏中的进度。

玩游戏（Python + Gym 风格的 API）

以下是如何在 Python 中使用类似 Gym 的 API 与基于文本的游戏进行交互。

import textworld.gym
# 将文本游戏注册为新环境
env_id = textworld.gym.register_game("tw_games/custom_game.z8",
                                     max_episode_steps=50)

env = textworld.gym.make(env_id)  # 启动环境

obs, infos = env.reset()  # 开始新一轮
env.render()

score, moves, done = 0, 0, False
while not done:
    command = input("> ")
    obs, score, done, infos = env.step(command)
    env.render()
    moves += 1

env.close()
print("移动次数: {}; 得分: {}".format(moves, score))

注意: 要在没有Gym类API的情况下玩文本游戏，请参阅使用TextWorld玩文本游戏.ipynb

文档

有关TextWorld的更多信息，请查看文档。

Visual Studio Code

你可以安装textworld-vscode扩展，它可以为编辑.twl和.twg TextWorld文件启用语法高亮。

笔记本

查看框架提供的笔记本，了解你可以用它做什么。你需要Jupyter Notebook来运行它们。你可以通过以下命令安装：

pip install jupyter

引用TextWorld

如果你使用TextWorld，请引用以下BibTex：

@Article{cote18textworld,
  author = {Marc-Alexandre C\^ot\'e and
            \'Akos K\'ad\'ar and
            Xingdi Yuan and
            Ben Kybartas and
            Tavian Barnes and
            Emery Fine and
            James Moore and
            Ruo Yu Tao and
            Matthew Hausknecht and
            Layla El Asri and
            Mahmoud Adada and
            Wendy Tay and
            Adam Trischler},
  title = {TextWorld: A Learning Environment for Text-based Games},
  journal = {CoRR},
  volume = {abs/1806.11532},
  year = {2018}
}