notebooks/Handcrafting a game.ipynb

{
 "cells": [
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "[![Open In Colab](https://colab.research.google.com/assets/colab-badge.svg)](https://colab.research.google.com/github/microsoft/TextWorld/blob/main/notebooks/Handcrafting%20a%20game.ipynb)"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "# Handcrafting a text-based game with TextWorld\n",
    "This tutorial shows how to make a custom text-based game using the TextWorld's API."
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "## Prerequisite\n",
    "Install TextWorld as described in the [README.md](https://github.com/microsoft/TextWorld#readme). Most of the time, a simple `pip install` should work.\n",
    "\n",
    "<span style=\"color:red\">_*Notice here that TextWorld is installed with the `[vis]` extras to enable visual rendering of the world._</span>"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": null,
   "metadata": {},
   "outputs": [],
   "source": [
    "# For Google Colab, first install\n",
    "#!apt install chromium-chromedriver\n",
    "#!pip install selenium==3.12.0\n",
    "# then\n",
    "!pip install textworld[vis]"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "## `GameMaker`\n",
    "Let's make a game consisting of two rooms and where the goal is to place an object from the player's inventory inside a container located in the other room."
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 1,
   "metadata": {},
   "outputs": [],
   "source": [
    "import textworld\n",
    "from textworld import GameMaker\n",
    "\n",
    "# Make the generation process reproducible.\n",
    "from textworld import g_rng  # Global random generator.\n",
    "g_rng.set_seed(20180916)\n",
    "\n",
    "# GameMaker object for handcrafting text-based games.\n",
    "M = GameMaker()"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "Documentation about the `GameMaker` API can be found at\n",
    "https://textworld.readthedocs.io/en/stable/textworld.generator.maker.html."
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "#### First, define the layout of the world."
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 2,
   "metadata": {},
   "outputs": [
    {
     "data": {
      "image/png": "iVBORw0KGgoAAAANSUhEUgAAAxsAAAJYCAIAAACFB2zoAAAakUlEQVR4nO3de5xVdbn48WfPDCgjKCBCxkVAbtZLLUWlFEFQ8dbFPL8Us0TBWx1S0pM3vJRd7KiZWnkg/RmezsnETBRFixFRE/WAJirCIIMBgiBiilxyhtnnj5E5dLELD7iZ4f3+xz2z114+a/T1fX1m7TVrF2oWLQ3YEnp03b3UIwBAaZSVegAAgCZPUQEAZCkqAIAsRQUAkFXYb8ChpZ6BZmLWjOmlHgEASqNQs2jp0KFDSz0GTV5VVZW/9QNgu+VdPwCALEUFAJClqAAAshQVAECWogIAyFJUAABZigoAIEtRAQBkKSoAgCxFBQCQpagAALIUFQBAlqICAMiq+Mc3nfXUE+3atf23iy755d33bLV52E4tXLys1CNsST267l7qEYBmqK6ubvGy1xseFyMKpZ0mrXVlq912bVvqKbaYJnOO6vjPfLqmes5ee/Ur9SAAAH+uyRTVscccvXkvLC8v37KTAAD8mc0sqi9+YXhN9Zz/+NGNBx7Q//5Jd7/43KxfTbzjI3vtFRHnjzm3pnrO3RN/3rjxCZ/7bE31nBmPPVIoFMrKyr589pnTpj4498XnHps29YxRpzduNvOp39ZUz9l3n72vvHzs72Y++fQTj379gq+VlZVVVlbWVM8ZctigiLh/0t2T7p7YsP3xn/n0vb+666Xnn33+2Zl3/NftAw85uHFXs556oqZ6zicGHPSL//7PF2c/c/MPb6ypnnP1d65q3OD7136vpnrONVd/JyLOGHlaTfWcxt1ScsWmKYrvzV9WaOpn4oFtVOFPl5dSL3ubqXH+iuZ1ymMzi2r9+j9GRI8e3a/93nfnvDR31ao39913nx/ddH15efn9Ux6MiH323rt9u3YNGw897LCIuH/Kg8Vi8fJLL77ga+e1aNFi/E9uXb169cVfv2Dkaadu3Of6iLh87CX9+vZ5YsZTHTp0OPvMUcd/9tO1tbW3Tbi94b/BpPsm33vf5Ig4c9TI6665ul/fPg8/Mn3mrFkHHtD/p7eOP3zokIZd/fHdP0bEv51/XteuXebNq77jzokRceThhzecryovLx986KERcfc9kzb358ZWVGiaGq9oKCgqYOv4s+Wl1MveZmqcv6JCUUXUF+sjonevXmMu+Pq/XXTJiFFnRsQe3br17NFj7tx5NTULy8rKBg0aGBEtW7Q4dODBEXHf5Pt3bd/+5OEnRsS5Yy74/g9u/NLpZ9TW1n757LMaQqdYX4yINWvWnPSFL3159Ln3PzAlIg4bPKi2tvaqb19dX18fEeNv+f+33jahTZs2547+ckRcdsU3vjL6vNNGnXX7z/67UChc8LXzGsbbULchIsrKygcPOfIzn/t/jz72+KtLl7Ztu8snPzEgIg7ov3/btrssXbZsxpNPRcSDv/7NqLPOuerb3838HAGA7VnqOqplr70265lnI2LBgpp31qyJiE6ddouIBx58KCIOGzQoIj7xiQGVlZWLFi9+bvbz++67d0VFRX19/WuvLf9Qp04V5eVLlrzarl3bfn37NO5z8v1TGh787rnZEdGpY8e//Pd+/GP7tmrVKiLunfxAw3cemPJgRPTp3WuXXXZp3Ozueya9W1sbEcVi8a5f/ioijjn6qIg44vAhEfGre+5t2Gzx4iUPT5s+c9YzmR8FALA9SxXVH978Q+Pj9evWRURZWXlETL7/gYg4dODBZWVlhw89LCLum/xAROzcZueIKCsre+yRqU88Nu2Jx6b16NE9Ijp37ty4nzf/8N4+161bHxHl5X9lwnZt20bE+vXr161b1/CdVavebHiwy847N262YsWKxscT77q7vr7+iMOHlJWVDR40KLzlBwBsOf/E/aj+cdXzX57/8su9e/Xaf7+PDzlscGxsrLfefisi6urqzv7K6E23f+HFOf/U/v/w1lsRseOOO+64444NV1+1b//eNVuNQRYRGzbUNz5eumzZo489PnjQoZ8+7tge3fd47rnZCxe+8s8fGQDAX7G17p7wwJSHIuL0Eafu/qEPVc9/eV71/IiYPfuFurq6ioqK115b8fC06dMffXznNjsXovD226v/7g4brkzfqbIyIp559ncNIXXcxlsqfOZTx0XE8y+8uHr1++7qFxPviojzx5wbEb/81f+doOratcuQwwb133+/zT9aAGD7trWKavIDUyJi2JGHx8YTVBHxxqpVDX92d9st475xxWU//9mE71/7vbPPOqMhj/625ctXRMQ3r7z80osvXL169U0/ujkivvXNK66/7t9vv+2W4Sd9vq6u7up/v/Zv7GFq1bSVK1d27vzhd2tr79s4UkQcdeQRt4y7+bJLL978owUAtm9bq6gWLKhpOC8VGy+ianDlN799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gCxFBQCQpagAALIUFQBAlqICAMhSVAAAWYoKACBLUQEAZCkqAIAsRQUAkKWoAACyFBUAQJaiAgDIUlQAAFmKCgAgS1EBAGQpKgCALEUFAJClqAAAshQVAECWogIAyFJUAABZigoAIEtRAQBkKSoAgCxFBQCQpagAALIUFQBAlqICAMhSVAAAWYoKACBLUQEAZCkqAIAsRQUAkKWoAACyFBUAQJaiAgDIUlQAAFmKCgAgS1EBAGQpKgCALEUFAJClqAAAshQVAECWogIAyFJUAABZigoAIEtRAQBkKSoAgCxFBQCQpagAALIUFQBAlqICAMhSVAAAWYoKACBLUQEAZCkqAIAsRQUAkKWoAACyFBUAQJaiAgDIUlQAAFmKCgAgS1EBAGQpKgCALEUFAJClqAAAshQVAECWogIAyFJUAABZigoAIEtRAQBkKSoAgCxFBQCQpagAALIUFQBAlqICAMhSVAAAWYoKACBLUQEAZCkqAIAsRQUAkKWoAACyFBUAQJaiAgDIUlQAAFmKCgAgS1EBAGQpKgCALEUFAJClqAAAshQVAECWogIAyFJUAABZigoAIEtRAQBkKSoAgCxFBQCQpagAALIUFQBAlqICAMhSVAAAWYoKACBLUQEAZCkqAIAsRQUAkKWoAACyFBUAQJaiAgDIUlQAAFmKCgAgS1EBAGQpKgCALEUFAJClqAAAshQVAECWogIAyFJUAABZigoAIEtRAQBkKSoAgCxFBQCQpagAALIUFQBAlqICAMhSVAAAWYoKACBLUQEAZCkqAIAsRQUAkKWoAACyFBUAQJaiAgDIUlQAAFmKCgAgS1EBAGQpKgCALEUFAJClqAAAshQVAECWogIAyFJUAABZigoAIEtRAQBkKSoAgCxFBQCQpagAALIUFQBAlqICAMhSVAAAWYoKACBLUQEAZCkqAIAsRQUAkKWoAACyFBUAQJaiAgDIUlQAAFmKCgAgS1EBAGQpKgCALEUFAJClqAAAshQVAECWogIAyFJUAABZigoAIEtRAQBkKSoAgCxFBQCQpagAALIUFQBAlqICAMhSVAAAWYoKACBLUQEAZCkqAIAsRQUAkKWoAACyFBUAQJaiAgDIUlQAAFmKCgAgS1EBAGQpKgCALEUFAJClqAAAshQVAECWogIAyFJUAABZigoAIEtRAQBkKSoAgCxFBQCQpagAALIUFQBAlqICAMhSVAAAWYoKACBLUQEAZCkqAIAsRQUAkKWoAACyFBUAQJaiAgDIUlQAAFmKCgAgS1EBAGQpKgCALEUFAJClqAAAshQVAECWogIAyFJUAABZigoAIEtRAQBkKSoAgCxFBQCQpagAALIUFQBAlqICAMhSVAAAWYoKACBLUQEAZCkqAIAsRQUAkKWoAACyFBUAQJaiAgDIUlQAAFmKCgAgS1EBAGQpKgCALEUFAJClqAAAshQVAECWogIAyFJUAABZigoAIEtRAQBkKSoAgCxFBQCQpagAALIUFQBAlqICAMhSVAAAWYoKACBLUQEAZCkqAIAsRQUAkKWoAACyFBUAQJaiAgDIUlQAAFmKCgAgS1EBAGQpKgCALEUFAJClqAAAshQVAECWogIAyFJUAABZigoAIEtRAQBkKSoAgCxFBQCQpagAALIUFQBAlqICAMhSVAAAWYoKACBLUQEAZCkqAIAsRQUAkKWoAACyFBUAQJaiAgDIUlQAAFmKCgAgS1EBAGQpKgCALEUFAJClqAAAshQVAECWogIAyFJUAABZigoAIEtRAQBkKSoAgCxFBQCQpagAALIUFQBAlqICAMhSVAAAWYoKACBLUQEAZCkqAIAsRQUAkKWoAACyFBUAQJaiAgDIUlQAAFmKCgAgS1EBAGQpKgCALEUFAJClqAAAshQVAECWogIAyFJUAABZigoAIOt/AZX5OlGtAmIVAAAAAElFTkSuQmCC\n",
      "text/plain": [
       "<PIL.Image.Image image mode=RGB size=795x600 at 0x7FF1A86FA438>"
      ]
     },
     "execution_count": 2,
     "metadata": {},
     "output_type": "execute_result"
    }
   ],
   "source": [
    "roomA = M.new_room(\"Room A\")\n",
    "roomB = M.new_room(\"Room B\")\n",
    "corridor = M.connect(roomA.east, roomB.west)\n",
    "M.render()"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "#### Place the player somewhere."
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 3,
   "metadata": {},
   "outputs": [
    {
     "data": {
      "image/png": "iVBORw0KGgoAAAANSUhEUgAAAxsAAAJYCAIAAACFB2zoAAAetElEQVR4nO3de5yVdb3o8e9aMww3uQyaXFXgoCKm5LUsFRUz3Tu7Z2C7DLzUsdNW0Uy8t7MybbePmV1Utu12XjgqeUE0E9EQlQxNUVSI0VQEBUGuA8zMWuePETRLt/EFl7Pm/X7xevHMWs88813zB3xez/Nbzyo0PPdiwOYwaLu+lR4BACqjWOkBAADaPEUFAJClqAAAshQVAEBWYc8PHVjpGagSsx64t9IjAEBlFBqee3HkyJGVHoM2b+rUqd7rB0C75aofAECWogIAyFJUAABZigoAIEtRAQBkKSoAgCxFBQCQpagAALIUFQBAlqICAMhSVAAAWYoKACBLUQEAZNW+811nzby/vr7nN88488ZJN22xeWinCmdv2CpHFCo5yRa04aV9ZY+46rOVHgaAzarNnKP69Cc/0TB3zi67DK30IAAAb9Zmiuqf/+mITfvGmpqazTsJAMCbbGJRfemLoxvmzvn5ZT/ed5+9b7t50hOPzvrN9dcN22WXiDj1lJMa5s6ZdP21G3f+7Gc+1TB3zgPT7ykUCsVi8cSvnTDtrjueeuLR6dPuOv64sRt3++PMGQ1z5wzffbfzzz37T3988A/3//7008YVi8UuXbo0zJ1zyMEjIuK2myfdPOn61v0//clP3PKbG56c/cjsR/543dW/OmD/j2w81KyZ9zfMnbPfhz448Zr/fuKxh3/2kx83zJ1z4fe+s3GHH/3wBw1z51x84fci4vhjxzTMnbPxsLCl7dCz0hMAsLltYlGtXbsuIgYNGvjDH3x/zpNPLV26bPjw3S+79D9qampuu/2OiNh9t9161de37jzy4IMj4rbb7yiXy+eeNf60cSd36NDh8ismrFy5cvzppx075pgNx1wbEeeefebQnXe6/4GZ22yzzddOOO7Tn/pEU1PTVf/1q3K5HBE33zr5llsnR8QJxx377xdfOHTnne6+594/zpq17z57/3LC5YeOPKT1UOvWr4uIb5568nbbDXj66bnX/b/rI+KwQw9tPV9VU1Nz0IEHRsSkm27e1N8bbLrte1Z6AgA2t00sqlK5FBE7Dhlyymmnf/OMM79y3AkRscP22w8eNOipp55uaHimWCyOGHFARNR16HDgAR+JiFsn37Z1r15Hj/5CRJx0ymk/+r8//vLY45uamk782ldbQ6dcKkfE6tWrR33xyyd+46TbptweEQcfNKKpqek7372wVCpFxOVX/ueEq/6rW7duJ33jxIg457xvf/0bJ4857qu/+vU1hULhtHEnt47X0twSEcVizUGHHPbJz3z+99PvW/Diiz179vjwfh+KiH323qtnzx4vLlz4wIMzI+KOO3933Ff/93e++/3M7xEAaM9S66gWLlo06+FHImL+/IZVq1dHRO/e74uIKXf8NiIOHjEiIvbb70NdunR57vnnH31s9vDhu9XW1pZKpUWLXurTu3dtTc0LLyyor+85dOedNh5z8m23t2786dHHIqL3ttv+7c/d4wPDO3fuHBG3TJ7S+siU2++IiJ12HNKjR4+Nu0266eb1TU0RUS6Xb7jxNxHxT0ccHhEfPfSQiPjNTbe07vb88y/cPe3eP856OPOrAADas1RRvbrs1Y3baxsbI6JYrImIybdNiYgDD/hIsVg8dOTBEXHr5CkR0b1b94goFovT77nr/unT7p8+bdCggRHRv3//jcdZ9uprx2xsXBsRNTV/Z8L6nj0jYu3atY2Nja2PLF26rHWjR/fuG3d7+eWXN25ff8OkUqn00UMPKRaLB40YES75AQCbzz9wP6p3bu68P8/78593HDJkrz33OOTgg2JDYy1fsTwimpubv/b1b7xx/8efmPMPHf/V5csjolOnTp06dWpdfdWr12trtjYGWUS0tJQ2br+4cOHvp9930IgDP/Hxfx40cIdHH33smWee/cdfGQDA37Gl7p4w5fbfRsTYrxzTt0+fufP+/PTceRHx2GOPNzc319bWLlr08t3T7r339/d179a9EIUVK1b+jwdsXZnetUuXiHj4kT+1htTHN9xS4ZNHfjwiZj/+xMqVb3moidffEBGnnnJSRNz4m9dPUG233YBDDh6x9157bvqrBQDaty1VVJOn3B4RHzvs0NhwgioiXlm6tPVtd1dd+Ytvn3fOtb/+rx/98Adf++rxrXn09l566eWI+Lfzzz1r/LdWrlx56WU/i4gL/u28//j3i3511ZWjRx3V3Nx84UU/fJsj3DV12pIlS/r377e+qenWDSNFxOGHffTKX/zsnLPGb/qrBQDaty1VVPPnN7Sel4oNi6hanf9v3/2PSy5du3btqKM+N2BA//+++toxx57wTg544cX/vmTJkkEDd2hdxv6zX1xx+hln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GeN7b9t74YsL16xp7Ne3X32vXhHRpUvn7QYMmDtv3osLFjzz7DMRMXTo0NZv2XHHnSLiL395buNBBg8cHBHv22abiNh+hx1qa2sjotfW9atWrWxcs6auR3v8+HpX/QCgyl32059OnTr1iiuvLBaLf/nLc527domIcpQjolB4/f3VrY9EsRjl1qf+6iDFNyRDTYeajQ/V1L52dqYYxYhot3cQUFQA0C4MHjTo8CMOX7Vq5X9OmBARffr06dKl86KXFi1dtiwiVq1e/fzzL3ToUDegX79BgwZHxFNPPd36jU8+OSciWh/krSgqAGgvxn5lTOfOnadMmfL003OLxeLo0Ue3tLScc/bZ119//Vnjx69du3bUqC/Udew4dOjQvffeu6Gh4YILvjNx4nUXX3RxRPzLv/xLpcd/T1NUANBe1PfqNWrUqHK5/JOfXFoul0eNGjV27Nhly5ZdccUVi5csOeaYY770pS+17nn2WWcdfvjhDz/88FVX/bJb927nnnPOnnvuWdnh3+PcM533BPdMB3iH/qF7pr/HVdM9052jAgDIUlQAAFnuRwXvtruuOv+nX51c6SmAtuqkU8btf+DBlZ6CN1NUvLd8eMD6CUe8Uukptoj3T+jb0rpq8f1Hn7LfjhWeBmiz9tx7n0qPwN+hqHhveX/v6Na5SlYpvknXulixLiJim/47ffHInSo9DtBWVdPK9GqiqHhvGVBf17/3NpWeYovo2em1ovpAv0qPArQbx59wQsP8+a3bhUKhZ339sF12GTt27MCBAys6VxVSVABQ5fY/YP+ePXqWSi3z5s2bMWPG008/fe211xaL3p22OSkqAKhyo0cfPXTnnSOiubn585//3JIlS15+6eU+fftUeq6qok8BoF0olUpz585tbFxb36tXr222rvQ41cY5KgCocl8/8cSN2/369jv3vHPrOlTne4AqSFEBQJUbMeKgnj17RMQrr7wyc+bM884/76KLLhrQf0Cl56oqigoAqtxRXziqdR1VREyaNOmyyy6bOHHiqeNOrexUVcY6KgBoR8pRjoj169ZXepBq4xwVAFS5a6+9pmePnhHx6vJXZz44MyL23/+ACs9UdRQVAFS5+6bf17rRtUuXwYMHf/ZznzvggP0rO1L1UVQAULWuuPzySo/QXlhHBQCQpagAALIUFQBAlnVUVJuWpnVNq1e0rG8slcuF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qAAAshQVAECWogIAyFJUAABZigoAIEtRAQBkKSoAgCxFBQCQpagAALIUFQBAlqICAMhSVAAAWYoKACBLUQEAZCkqAIAsRQUAkKWoAACyFBUAQJaiAgDIUlQAAFmKCgAgS1EBAGQpKgCALEUFAJClqAAAshQVAECWogIAyFJUAABZigoAIEtRAQBkKSoAgCxFBQCQpagAALIUFQBAlqICAMhSVAAAWYoKACBLUQEAZCkqAIAsRQUAkKWoAACyFBUAQJaiAgDIUlQAAFmKCgAgS1EBAGQpKgCALEUFAJClqAAAshQVAECWogIAyFJUAABZigoAIEtRAQBkKSoAgCxFBQCQpagAALIUFQBAlqICAMhSVAAAWYoKACBLUQEAZCkqAIAsRQUAkKWoAACyFBUAQJaiAgDIUlQAAFmKCgAgS1EBAGQpKgCALEUFAJClqAAAshQVAECWogIAyFJUAABZigoAIEtRAQBkKSoAgCxFBQCQpagAALIUFQBAlqICAMhSVAAAWYoKACBLUQEAZCkqAIAsRQUAkKWoAACyFBUAQJaiAgDIUlQAAFmKCgAgS1EBAGQpKgCALEUFAJClqAAAshQVAECWogIAyFJUAABZigoAIEtRAQBkKSoAgCxFBQCQpagAALIUFQBAlqICAMhSVAAAWYoKACBLUQEAZCkqAIAsRQUAkKWoAACyFBUAQJaiAgDIUlQAAFmKCgAgS1EBAGQpKgCALEUFAJClqAAAshQVAECWogIAyFJUAABZigoAIEtRAQBkKSoAgCxFBQCQpagAALIUFQBAlqICAMhSVAAAWYoKACBLUQEAZCkqAIAsRQUAkKWoAACyFBUAQJaiAgDIUlQAAFmKCgAgS1EBAGQpKgCALEUFAJClqAAAshQVAECWogIAyFJUAABZigoAIEtRAQBkKSoAgCxFBQCQpagAALIUFQBAlqICAMhSVAAAWYoKACBLUQEAZCkqAIAsRQUAkKWoAACyFBUAQJaiAgDIUlQAAFmKCgAgS1EBAGQpKgCALEUFAJClqAAAshQVAECWogIAyFJUAABZigoAIEtRAQBkKSoAgCxFBQCQpagAALIUFQBAlqICAMhSVAAAWYoKACBLUQEAZCkqAIAsRQUAkKWoAACyFBUAQJaiAgDIUlQAAFmKCgAgS1EBAGQpKgCALEUFAJClqAAAshQVAECWogIAyFJUAABZigoAIEtRAQBkKSoAgCxFBQCQpagAALIUFQBAlqICAMhSVAAAWYoKACBLUQEAZCkqAIAsRQUAkKWoAACyFBUAQJaiAgDIUlQAAFmKCgAgS1EBAGQpKgCALEUFAJClqAAAshQVAECWogIAyFJUAABZigoAIEtRAQBkKSoAgCxFBQCQpagAALIUFQBAlqICAMhSVAAAWYoKACBLUQEAZCkqAIAsRQUAkKWoAACyFBUAQJaiAgDIUlQAAFmKCgAgS1EBAGQpKgCALEUFAJClqAAAshQVAECWogIAyFJUAABZigoAIEtRAQBkKSoAgCxFBQCQpagAALIUFQBAlqICAMhSVAAAWYoKACBLUQEAZCkqAIAsRQUAkKWoAACyFBUAQJaiAgDIUlQAAFmKCgAgS1EBAGQpKgCALEUFAJClqAAAshQVAECWogIAyFJUAABZigoAIEtRAQBkKSoAgCxFBQCQpagAALIUFQBAlqICAMhSVAAAWYoKACBLUQEAZCkqAIAsRQUAkKWoAACyFBUAQJaiAgDIUlQAAFmKCgAgS1EBAGQpKgCALEUFAJClqAAAshQVAECWogIAyFJUAABZigoAIEtRAQBkKSoAgCxFBQCQpagAALIUFQBAlqICAMhSVAAAWYoKACBLUQEAZCkqAIAsRQUAkKWoAACyFBUAQJaiAgDIUlQAAFmKCgAgS1EBAGQpKgCALEUFAJClqAAAshQVAECWogIAyFJUAABZigoAIEtRAQBkKSoAgCxFBQCQpagAALIUFQBAlqICAMhSVAAAWYoKACBLUQEAZCkqAIAsRQUAkKWoAACyFBUAQJaiAgDIUlQAAFmKCgAgS1EBAGQpKgCALEUFAJClqAAAshQVAECWogIAyFJUAABZigoAIEtRAQBkKSoAgCxFBQCQpagAALL+P/980dpTQLoUAAAAAElFTkSuQmCC\n",
      "text/plain": [
       "<PIL.Image.Image image mode=RGB size=795x600 at 0x7FF1C4ED6B38>"
      ]
     },
     "execution_count": 3,
     "metadata": {},
     "output_type": "execute_result"
    }
   ],
   "source": [
    "M.set_player(roomA)\n",
    "M.render()"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "#### Add two objects to Room A."
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 4,
   "metadata": {},
   "outputs": [
    {
     "data": {
      "image/png": "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tQ888MCUKVNK8uxKRVGxfplfl69vyJV6irZjfl15RFmppwDWL+dfcH7n6s5PP/308OHD99xzzz322CMi5syeExErPjG1V69eETFnzpzZc95xe88ePTOZzNy5c1ZsrUfPHhFRVVUVET2XL1dHRHOueR0+p9JTVKwfist/LYvmZY1NJR2lTckWi1FUVMA77DFoj9oetbvvPuipp5667bbbDj744C222KL3hhtExOzZs1vWmTVrVkT02bBPS0utuH3O7DnFYrF3nz4lmn39pahYP2SW/9qturK2e2VJR2lTunf+z+8twMo6dqw884wzvnvZZT//+c9/85vfDNptUN+N+j744IPbb79d167drr/++oqKiqFHDe1cXX3QQQfdf//9v//973fdddebb745Ij760eNKPf56R1EBQDs1eP/9d77zzhdeeOGO228/9rjjrrjiiquvvvoPf/hjc3PzwIEDL7zwwv79+0fEOeecU9ujx0MPP3Tbbbf17dv3vPPPO/yww0s9+3onUywW//dasJZlvrl84brj46SdSzlJG3PDi3HiP5YvF79X0lGAtSNfKEydvvyUXLHVHpXu3bOmqlPrPkHh3RMAAFI56wftxVlnnZXLeR0ltDUDN9/8hBM/W+opUFTQbowfP75QKJR6CuBD1tzcvt6kYL2lqKC9GDlyZKlHAD58K19HRQm5jgoAIJVjVADQXpz8uZPfnPZmy3JZWVmP2to99txz2LBhnTt3Lu1gbYCiAoD25cwzz6yuqm7ONY8aNWr48OFNTU1f//rXSz1Uq6eoAKB9GXLgkNoetRGx26DdTv7syRMmTCj1RG2BogKA9mXBooUR0ZRrHnn/yIjYZZddSjxQm6CoAKB9OX3YsBXLO+6446c//ekSDtNmKCoAaF8u/sY3unTuXCgUZ82aee21fxk2bNjVV11VU1tb6rlaN0UFAO3LLjvt3HIdVUSMH//6vfeOGPPimP33P6C0U7V2igoA2peRD4ysrqouFotz5s556KEHKyoqNh+4eamHavUUFW1NrlBoaMwVi8VOHcsryspKPQ7Aeueqq65qWejcuctWW231mc98pt/GG5d2pDZAUdFGNOUKsxc3PjXprXGzliyub8o1N1VG43Ybddt724371HbuWOFHHSCu/cu1pR6hzfLPDK1eoRhjZyweNX7u+NlL6hvz+WKxWIyIzKJi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FQBAKkUFAJBKUQEApFJUAACpFBUAQCpFBQCQSlEBAKRSVAAAqRQVAEAqRQUAkEpRAQCkUlQAAKkUFQBAKkUFAJBKUQEApFJUAACpFBUAQCpFBQCQSlEBAKRSVAAAqRQVAEAqRQUAkEpRAQCkUlQAAKkUFQBAKkUFAJBKUQEApFJUAACpFBUAQCpFBQCQSlEBAKRSVAAAqRQVAEAqRQUAkEpRAQCkUlQAAKkUFQBAKkUFAJBKUQEApFJUAACpFBUAQCpFBQCQSlEBAKRSVAAAqRQVAEAqRQUAkEpRAQCkUlQAAKkUFQBAKkUFAJBKUQEApFJUAACpFBUAQCpFBQCQSlEBAKRSVAAAqRQVAEAqRQUAkEpRAQCkUlQAAKkUFQBAKkUFAJBKUQEApFJUAACpFBUAQCpFBQCQSlEBAKRSVAAAqRQVAEAqRQUAkEpRAQCkUlQAAKkUFQBAKkUFAJBKUQEApFJUAACpFBUAQCpFBQCQSlEBAKRSVAAAqRQVAEAqRQUAkEpRAQCkUlQAAKkUFQBAKkUFAJBKUQEApFJUAACpFBUAQCpFBQCQSlEBAKRSVAAAqRQVAEAqRQUAkEpRAQCkUlQAAKkUFQBAKkUFAJBKUQEApFJUAACpFBUAQCpFBQCQSlEBAKRSVAAAqRQVAEAqRQUAkEpRAQCkUlQAAKkUFQBAKkUFAJBKUQEApFJUAACpFBUAQCpFBQCQSlEBAKRSVAAAqRQVAEAqRQUAkEpRAQCkUlQAAKkUFQBAKkUFAJBKUQEApFJUAACpFBUAQCpFBQCQSlEBAKRSVAAAqRQVAEAqRQUAkEpRAQCkUlQAAKkUFQBAKkUFAJBKUQEApFJUAACpFBUAQCpFBQCQSlEBAKRSVAAAqRQVAEAqRQUAkEpRAQCkUlQAAKkUFQBAKkUFAJBKUQEApFJUAACpFBUAQCpFBQCQSlEBAKRSVAAAqRQVAEAqRQUAkEpRAQCkUlQAAKkUFQBAKkUFAJBKUQEApFJUAACpFBUAQCpFBQCQSlEBAKRSVAAAqRQVAEAqRQUAkEpRAQCkUlQAAKkUFQBAKkUFAJBKUQEApFJUAACpFBUAQCpFBQCQSlEBAKRSVAAAqRQVAEAqRQUAkEpRAQCkUlQAAKkUFQBAKkUFAJBKUQEApFJUAACpFBUAQCpFBQCQSlEBAKRSVAAAqRQVAEAqRQUAkEpRAQCkUlQAAKkUFQBAKkUFAJBKUQEApFJUAACpFBUAQCpFBQCQSlEBAKRSVAAAqRQVAEAqRQUAkEpRAQCkUlQAAKkUFQBAKkUFAJBKUQEApFJUAACpFBUAQCpFBQCQSlEBAKRSVAAAqRQVAEAqRQUAkEpRAQCkUlQAAKkUFQBAKkUFAJBKUQEApFJUAACpFBUAQCpFBQCQSlEBAKRSVAAAqRQVAEAqRQUAkEpRAQCkUlQAAKkUFQBAKkUFAJBKUQEApFJUAACpFBUAQCpFBQCQSlEBAKRSVAAAqRQVAEAqRQUAkEpRAQCkUlQAAKkUFQBAKkUFAJBKUQEApFJUAACpFBUAQCpFBQCQSlEBAKRSVAAAqRQVAEAqRQUAkEpRAQCkUlQAAKkUFQBAKkUFAJBKUQEApFJUAACpFBUAQCpFBQCQSlEBAKRSVAAAqRQVAEAqRQUAkEpRAQCkUlQAAKkUFQBAKkUFAJBKUQEApFJUAACpFBUAQCpFBQCQSlEBAKRSVAAAqRQVAEAqRQUAkEpRAQCkUlQAAKkUFQBAKkUFAJBKUQEApFJUAACpFBUAQCpFBQCQSlEBAKRSVAAAqRQVAEAqRQUAkEpRAQCkUlQAAKkUFQBAKkUFAJBKUQEApFJUAACpFBUAQCpFBQCQSlEBAKRSVAAAqRQVAEAqRQUAkEpRAQCkUlQAAKkUFQBAKkUFAJBKUQEApFJUAACpFBUAQCpFBQCQSlEBAKT6fx4ANkmir1VSAAAAAElFTkSuQmCC\n",
      "text/plain": [
       "<PIL.Image.Image image mode=RGB size=795x600 at 0x7FF1C4D9A358>"
      ]
     },
     "execution_count": 4,
     "metadata": {},
     "output_type": "execute_result"
    }
   ],
   "source": [
    "note = M.new(type='o', name=\"note\")       # Provide the type and the name of the object.\n",
    "note.infos.desc = \"Bravo! You can read.\"  # Text to display when issuing command \"examine note\". \n",
    "\n",
    "supporter = M.new(type='s')  # When not provided, names are automatically generated.\n",
    "\n",
    "roomA.add(supporter)  # Supporters are fixed in place.\n",
    "roomA.add(note)       # When added directly to a room, portable objects are put on the floor.\n",
    "\n",
    "M.render()"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "##### Supported types of objects\n",
    "\n",
    "type | name | description\n",
    "--------|-----|------------\n",
    "'r' | room | can contain objects, can be connected with other rooms\n",
    "'d' | door | (un)lockable, openable/closable\n",
    "'c' | container | can hold objects, (un)lockable, openable/closable\n",
    "'s' | supporter | can hold objects\n",
    "'o' | portable object | can be carried by the player\n",
    "'k' | key | subtype of portable object, match a door or container's lock\n",
    "'f' | food | subtype of portable object, can be eaten if edible\n",
    "'oven' | oven | subtype of container, provide a heat source to cook food item\n",
    "'stove' | stove | subtype of supporter, provide a heat source to cook food item"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "#### Let's add a locked door between the two rooms."
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 5,
   "metadata": {},
   "outputs": [
    {
     "data": {
      "image/png": "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K64YNmzYV7/61QEDBtx/3/1XX311vlA49stfLi4qCiHce889p5566k033fTSyy9Nmjz51FNPeeaZZ4YNG/bgQw9961vfaun3uu4oKoC2L5HPTliYmdJYSCWWfSqdL8xqymYLoXtJon8ut4KNTJky5bnnnmtsbKysrKyoqFi4cOHIkSMXLly4xx57lJSUrMXRs6adccYZS5Z79+59xhlnVFVVvfDCC1OmTjnooIMOP+zwEMKiRQsvueSSJ554vFevnsOGDevRo8epp54aQtiw74YvHffSY488euyXv9y8hUMPOXTAgAFTpkx59913d9ppp9133722pmbYsGETJ05skXfXUhQV65c5i3L1DdmWHkXbMWdRUQiplh4F64VsIWxYFnqUhMSno6oxF6YWhenpkFnxy7PZN954o76+fuDAgf369SsqKlqwYMFbb701YcKETp067bTTTk7/tSLnnndux4qOr7322pAhQ3bbbbddd901hDBj+owQwpI7pnbt2jWEMGPGjOkzPvV4l9ouiURi5swZS7ZW26U2hFBeXh5C6LJ4uSKEkMmu+HuqrVFUrB8+PheRCpnGpnSLDqVNSRYKoaCoWCwVQnEisUxRZROhKJFIJQqZFd5EZ9y4cXV1dVtuueVmm23WfESqurp6p512mjNnzgcffNC/f/9O7WnGTGu364Bda2prdtllwKuvvnr//ffvv//+m222WfcNuoUQpk+f3rzORx99FELosUGP5pZa8viM6TMKhUL3Hj1aaOzrL0XF+uHj/+KrKspqOpuTscZ07vjJ3y2stlwuN3HixKKion79+i19gq+qqqpXr17vvPNOXV2domp1SkvLTjv11F/9+tdXXnnlVVddNWDnAb169nr66ae32WbrTp2qbrvttuLi4sMOP6xjRcV+++331FNP3XDDDTvttNPdd98dQjjmmKNbevjrHUUFsLZ8MHHivvsfXFxcnAghmUpt2Kf3QQcecMpJJ5a3to+pp9PpxsbGioqKjh07LvNUbW1tPp+fN29eiwyMSIP23nuHhx9+6623HnrwwaOOPvqyyy677rrr/v73GzOZTL9+/c4///y+ffuGEM4666ya2tpnnn3m/vvv79Wr1znnnnPwQQe39NjXO4oKYO0a+sSjvXv3WrBw4TvvjPr9H6948qmhd91xe8eKitXbWi6XS6XW9ZncXC6XyWTK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AACxFBUAQCxFBQAQS1EBAMRSVAAAsRQVAEAsRQUAEEtRAQDEUlQAALEUFQBALEUFABBLUQEAxFJUAACxFBUAQCxFBQAQS1EBAMRSVAAAsRQVAEAsRQUAEEtRAQDEUlQAALEUFQBALEUFABBLUQEAxFJUAACxFBUAQCxFBQAQS1EBAMRSVAAAsRQVAEAsRQUAEEtRAQDEUlQAALEUFQBALEUFABBLUQEAxFJUAACxFBUAQCxFBQAQS1EBAMRSVAAAsRQVAEAsRQUAEEtRAQDEUlQAALEUFQBALEUFABBLUQEAxFJUAACxFBUAQCxFBQAQS1EBAMRSVAAAsRQVAEAsRQUAEEtRAQDEUlQAALEUFQBALEUFABBLUQEAxFJUAACxFBUAQCxFBQAQS1EBAMRSVAAAsRQVAEAsRQUAEEtRAQDEUlQAALEUFQBALEUFABBLUQEAxFJUAACxFBUAQCxFBQAQS1EBAMRSVAAAsRQVAEAsRQUAEEtRAQDEUlQAALEUFQBALEUFABBLUQEAxFJUAACxFBUAQCxFBQAQS1EBAMRSVAAAsRQVAEAsRQUAEEtRAQDEUlQAALEUFQBALEUFABBLUQEAxFJUAACxFBUAQCxFBQAQS1EBAMRSVAAAsRQVAEAsRQUAEEtRAQDEUlQAALEUFQBALEUFABBLUQEAxFJUAACxFBUAQCxFBQAQS1EBAMRSVAAAsRQVAEAsRQUAEEtRAQDEUlQAALEUFQBALEUFABBLUQEAxFJUAACxFBUAQCxFBQAQS1EBAMRSVAAAsRQVAEAsRQUAEEtRAQDEUlQAALEUFQBALEUFABBLUQEAxFJUAACxFBUAQCxFBQAQS1EBAMRSVAAAsRQVAEAsRQUAEEtRAQDEUlQAALEUFQBALEUFABBLUQEAxFJUAACxFBUAQCxFBQAQS1EBAMRSVAAAsRQVAEAsRQUAEEtRAQDEUlQAALEUFQBALEUFABBLUQEAxFJUAACxFBUAQCxFBQAQS1EBAMRSVAAAsRQVAEAsRQUAEEtRAQDEUlQAALEUFQBALEUFABBLUQEAxFJUAACxFBUAQCxFBQAQS1EBAMRSVAAAsRQVAEAsRQUAEEtRAQDEUlQAALEUFQBALEUFABBLUQEAxFJUAACxFBUAQCxFBQAQS1EBAMRSVAAAsRQVAEAsRQUAEEtRAQDEUlQAALEUFQBALEUFABBLUQEAxFJUAACxFBUAQCxFBQAQS1EBAMRSVAAAsRQVAEAsRQUAEEtRAQDEUlQAALEUFQBALEUFABBLUQEAxFJUAACxFBUAQCxFBQAQS1EBAMRSVAAAsRQVAEAsRQUAEEtRAQDEUlQAALEUFQBALEUFABBLUQEAxFJUAACxFBUAQCxFBQAQS1EBAMRSVAAAsRQVAEAsRQUAEEtRAQDEUlQAALEUFQBALEUFABBLUQEAxFJUAACxFBUAQCxFBQAQS1EBAMRSVAAAsRQVAEAsRQUAEEtRAQDEUlQAALEUFQBALEUFABBLUQEAxFJUAACxFBUAQCxFBQAQS1EBAMRSVAAAsRQVAEAsRQUAEEtRAQDEUlQAALEUFQBALEUFABBLUQEAxFJUAACxFBUAQCxFBQAQS1EBAMRSVAAAsRQVAEAsRQUAEEtRAQDEUlQAALEUFQBArP8H4uOR27iGp8MAAAAASUVORK5CYII=\n",
      "text/plain": [
       "<PIL.Image.Image image mode=RGB size=795x600 at 0x7FF1C4C520F0>"
      ]
     },
     "execution_count": 5,
     "metadata": {},
     "output_type": "execute_result"
    }
   ],
   "source": [
    "door = M.new_door(corridor, name=\"door\")  # Door and room have their own \"new\" method, no need to provide the type.\n",
    "M.add_fact(\"locked\", door)  # Add a fact about the door, i.e. it is locked.\n",
    "M.render()"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "##### Supported types of facts\n",
    "\n",
    " fact/predicate | description\n",
    "----------------|------------\n",
    "__match__(key, container/door) | The `key` matches the `container/door`'s lock.\n",
    "__open__(container/door) | The `container/door` is open.\n",
    "__closed__(container/door) | The `container/door` is closed.\n",
    "__locked__(container/door) | The `container/door` is locked.\n",
    "__edible__(food) | The `food` is edible, otherwise needs to be cooked first."
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "#### Create a key object that be used to unlock the door and place on the supporter object."
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 6,
   "metadata": {},
   "outputs": [
    {
     "data": {
      "image/png": "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hMu6GCo2NubZiS/MnfOt0XjpFFu5cnXirl0UFVDEmXba9smLrkLb+U8VuvQ0m0tERDT/uo1i7xh/ke1kZWUdPXrUarVWrVo1JibGwH0RriSb1Xbq5CkRycnNWbVqlYjUqV0nLz//8ccf13X9348+mpGZOXXq1IyMjFdffTUpKWnChAlNmzadMGHihg3rZ86caTKbR40caTabRWT578sffPChyZNfnjZ1WseOHR955OHJkydPnz596tSpHv6QVwxFBa+Ua3N+vubwodS8i5+DrhkMPgEh+fbCeeuS/H0sQzo1Lv1b9OzebfeevZ998eUdt99WfHleXv5LL09ev2GTiDRr1mTSxAk7ExNfee0Nl8t16nTy9Knvbti46b+TX83Nywvw93/mqf+0a9umTB8R8HK2Avvm5fuzCqyuc58pdOmnCxyaJlUsWozdeqEN2O32TZs27d692+FwGAyGbdu2RUdHd+zYMTIy8spOfg3bsGHD6DGj3Y8DAgPvuefupk2bLl26NC0tbezYsd26d3evs379+vSMjIULF+q6ft999zds2KB161aLFy/+7bdfR40c6X750FuGNmnS5KefmmzdunXMP8ZUj63+zTffHDt61FMf7Sog9uF9nC79913Ju07mlOaSPoPR6BcSYXXKT2sT86yFl/EuTtcLz0989/1pyckpxZe/8/7U08kpvyz4acmvC3Rdn/LGm506dhgx/JabBg+cPvXdjIzMu+994Inxjy35ZcGk5ybc9+DDuXl5l/sBgUpAE9F1PceuR5v16pazfmItehWLLrqed15sFdF1/c8//9y5c2dMTMzAgQOHDRvWsmXLzMzMFStW5OfnX8XPcW1p3LjxpEmTnnnmGbPZEhUROXToLSKSnJwsItHRUe51IiIjRCQ1JdW9PCo6SkRMJlNoaFhqyt//t4wIjxARPz8/EQkPixARf3//Qrv9Kn+iq4migvfJLrBvOpyhl/oWCQajyWTxy8gpWPHHodK/iy56g/r1hg29+cWXXym+fPHiJaNGDDebzZqmjRg+bPnylcWfXbV6TVz16p06dhCRFs0TateqtWrVmtK/KVDJGDUJNmpBprN/jFqAUbNc9M+fjIyMpKSkqlWrdurUqWrVqkFBQS1atGjZsmV6evr+/fuv1vjXnIjIiM6dO/fs2XPIzUMOHT70808/i0h0dLSIFP3dMvl0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ogIAAFBFUQEAAKiiqAAAAFRRVAAAAKooKgAAAFUUFQAAgCqKCgAAQBVFBQAAoIqiAgAAUEVRAQAAqKKoAAAAVFFUAAAAqigqAAAAVRQVAACAKooKAABAFUUFAACgiqICAABQRVEBAACooqgAAABUUVQAAACqKCoAAABVFBUAAIAqigoAAEAVRQUAAKCKogIAAFBFUQEAAKiiqAAAAFRRVAAAAKooKgAAAFUUFQAAgCqKCgAAQBVFBQAAoIqiAgAAUEVRAQAAqKKoAAAAVFFUAAAAqigqAAAAVRQVAACAKooKAABAFUUFAACgiqICAABQRVEBAACooqgAAABUUVQAAACqKCoAAABVFBUAAIAqigoAAEAVRQUAAKCKogIAAFBFUQEAAKiiqAAAAFRRVAAAAKooKgAAAFUUFQAAgCqKCgAAQBVFBQAAoIqiAgAAUEVRAQAAqKKoAAAAVFFUAAAAqigqAAAAVRQVAACAKooKAABAFUUFAACgiqICAABQRVEBAACooqgAAABUUVQAAACqKCoAAABVFBUAAIAqigoAAEAVRQUAAKCKogIAAFBFUQEAAKiiqAAAAFRRVAAAAKooKgAAAFUUFQAAgCqKCgAAQBVFBQAAoIqiAgAAUEVRAQAAqKKoAAAAVFFUAAAAqigqAAAAVRQVAACAKooKAABAFUUFAACgiqICAABQRVEBAACooqgAAABUUVQAAACqKCoAAABVFBUAAIAqigoAAEAVRQUAAKCKogIAAFBFUQEAAKiiqAAAAFRRVAAAAKooKgAAAFUUFQAAgCqKCgAAQBVFBQAAoIqiAgAAUEVRAQAAqKKoAAAAVFFUAAAAqigqAAAAVRQVAACAKooKAABAFUUFAACgiqICAABQRVEBAACooqgAAABUUVQAAACqKCoAAABVFBUAAIAqigoAAEAVRQUAAKCKogIAAFBFUQEAAKiiqAAAAFRRVAAAAKooKgAAAFUUFQAAgCqKCgAAQBVFBQAAoIqiAgAAUEVRAQAAqKKoAAAAVFFUAAAAqigqAAAAVRQVAACAKooKAABAFUUFAACgiqICAABQRVEBAACooqgAAABUUVQAAACqKCoAAABVFBUAAIAqigoAAEAVRQUAAKCKogIAAFBFUQEAAKiiqAAAAFRRVAAAAKooKgAAAFUUFQAAgCqKCgAAQBVFBQAAoIqiAgAAUEVRAQAAqKKoAAAAVFFUAAAAqigqAAAAVRQVAACAKooKAABAFUUFAACgiqICAABQRVEBAACooqgAAABUUVQAAACqKCoAAABVFBUAAIAqigoAAEAVRQUAAKCKogIAAFBFUQEAAKiiqAAAAFRRVAAAAKooKgAAAFUUFQAAgCqKCgAAQBVFBQAAoIqiAgAAUEVRAQAAqKKoAAAAVFFUAAAAqigqAAAAVRQVAACAKooKAABAFUUFAACgiqICAABQRVEBAACooqgAAABUUVQAAACqKCoAAABVFBUAAIAqigoAAEAVRQUAAKCKogIAAFBFUQEAAKiiqAAAAFRRVAAAAKooKgAAAFUUFQAAgCqKCgAAQBVFBQAAoIqiAgAAUEVRAQAAqKKoAAAAVFFUAAAAqigqAAAAVRQVAACAKooKAABAFUUFAACgiqICAABQRVEBAACooqgAAABUUVQAAACqKCoAAABVFBUAAIAqigoAAEAVRQUAAKCKogIAAFBFUQEAAKiiqAAAAFRRVAAAAKooKgAAAFUUFQAAgCqKCgAAQBVFBQAAoIqiAgAAUEVRAQAAqKKoAAAAVFFUAAAAqigqAAAAVRQVAACAKooKAABAFUUFAACgiqICAABQRVEBAACooqgAAABUUVQAAACqKCoAAABVFBUAAIAqigoAAEAVRQUAAKCKogIAAFBFUQEAAKiiqAAAAFRRVAAAAKooKgAAAFUUFQAAgCqKCgAAQBVFBQAAoIqiAgAAUEVRAQAAqKKoAAAAVFFUAAAAqigqAAAAVRQVAACAKooKAABAFUUFAACgiqICAABQRVEBAACooqgAAABUUVQAAACqKCoAAABVFBUAAIAqigoAAEAVRQUAAKCKogIAAFBFUQEAAKiiqAAAAFRRVAAAAKooKgAAAFUUFQAAgCqKCgAAQBVFBQAAoIqiAgAAUEVRAQAAqKKoAAAAVFFUAAAAqigqAAAAVRQVAACAKooKAABAFUUFAACgiqICAABQRVEBAACooqgAAABUUVQAAACqKCoAAABVFBUAAIAqigoAAEAVRQUAAKCKogIAAFBFUQEAAKiiqAAAAFRRVAAAAKooKgAAAFUUFQAAgCqKCgAAQBVFBQAAoOr/AYDK5rTQL5q4AAAAAElFTkSuQmCC\n",
      "text/plain": [
       "<PIL.Image.Image image mode=RGB size=795x600 at 0x7FF1C4B57C18>"
      ]
     },
     "execution_count": 6,
     "metadata": {},
     "output_type": "execute_result"
    }
   ],
   "source": [
    "key = M.new(type=\"k\", name=\"old key\")  # Create a 'k' (i.e. key) object. \n",
    "M.add_fact(\"match\", key, door)         # Tell the game 'old key' is matching the 'door''s lock\n",
    "\n",
    "supporter.add(key)  # Add the 'old key' on the supporter.\n",
    "\n",
    "M.render()"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "#### Create the object carried by the player and the container (initially closed)."
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 7,
   "metadata": {},
   "outputs": [
    {
     "data": {
      "image/png": "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N/jUDwAAQBVFBQAAoIqiAgAAUEVRAQAAqKKoAAAAVFFUAAAAqigqAAAAVRQVAACAKooKAABAFUUFAACgiqICAABQRVEBAACooqgAAABUUVQAAACqKCoAAABVFBUAAIAqigoAAEAVRQUAAKCKogIAAFBFUQEAAKiiqAAAAFRRVAAAAKooKgAAAFUUFQAAgCqKCgAAQBVFBQAAoIqiAgAAUEVRAQAAqKKoAAAAVFFUAAAAqigqAAAAVRQVAACAKooKAABAFUUFAACgiqICAABQRVEBAACooqgAAABUUVQAAACqKCoAAABVFBUAAIAqigoAAEAVRQUAAKCKogIAAFBFUQEAAKiiqAAAAFRRVAAAAKooKgAAAFUUFQAAgCqKCgAAQBVFBQAAoIqiAgAAUEVRAQAAqKKoAAAAVFFUAAAAqigqAAAAVRQVAACAKooKAABAFUUFAACgiqICAABQRVEBAACooqgAAABUUVQAAACqKCoAAABVFBUAAIAqigoAAEAVRQUAAKCKogIAAFBFUQEAAKiiqAAAAFRRVAAAAKooKgAAAFUUFQAAgCqKCgAAQBVFBQAAoIqiAgAAUEVRAQAAqKKoAAAAVFFUAAAAqigqAAAAVRQVAACAKooKAABAFUUFAACgiqICAABQRVEBAACooqgAAABUUVQAAACqKCoAAABVFBUAAIAqigoAAEAVRQUAAKCKogIAAFBFUQEAAKiiqAAAAFRRVAAAAKooKgAAAFUUFQAAgCqKCgAAQBVFBQAAoIqiAgAAUEVRAQAAqKKoAAAAVFFUAAAAqigqAAAAVRQVAACAKooKAABAFUUFAACgiqICAABQRVEBAACooqgAAABUUVQAAACqKCoAAABVFBUAAIAqigoAAEAVRQUAAKCKogIAAFBFUQEAAKiiqAAAAFRRVAAAAKooKgAAAFUUFQAAgCqKCgAAQBVFBQAAoIqiAgAAUEVRAQAAqKKoAAAAVFFUAAAAqigqAAAAVRQVAACAKooKAABAFUUFAACgiqICAABQRVEBAACooqgAAABUUVQAAACqKCoAAABVFBUAAIAqigoAAEAVRQUAAKCKogIAAFBFUQEAAKiiqAAAAFRRVAAAAKooKgAAAFUUFQAAgCqKCgAAQBVFBQAAoIqiAgAAUEVRAQAAqKKoAAAAVFFUAAAAqigqAAAAVRQVAACAKooKAABAFUUFAACgiqICAABQRVEBAACooqgAAABUUVQAAACqKCoAAABVFBUAAIAqigoAAEAVRQUAAKCKogIAAFBFUQEAAKiiqAAAAFRRVAAAAKooKgAAAFUUFQAAgCqKCgAAQBVFBQAAoIqiAgAAUEVRAQAAqKKoAAAAVFFUAAAAqigqAAAAVRQVAACAKooKAABAFUUFAACgiqICAABQRVEBAACooqgAAABUUVQAAACqKCoAAABVFBUAAIAqigoAAEAVRQUAAKCKogIAAFBFUQEAAKiiqAAAAFRRVAAAAKooKgAAAFUUFQAAgCqKCgAAQBVFBQAAoIqiAgAAUEVRAQAAqKKoAAAAVFFUAAAAqigqAAAAVRQVAACAKooKAABAFUUFAACgiqICAABQRVEBAACooqgAAABUUVQAAACqKCoAAABVFBUAAIAqigoAAEAVRQUAAKCKogIAAFBFUQEAAKiiqAAAAFRRVAAAAKooKgAAAFUUFQAAgCqKCgAAQBVFBQAAoIqiAgAAUEVRAQAAqKKoAAAAVFFUAAAAqigqAAAAVRQVAACAKooKAABAFUUFAACgiqICAABQRVEBAACooqgAAABUUVQAAACqKCoAAABVFBUAAIAqigoAAEAVRQUAAKCKogIAAFBFUQEAAKiiqAAAAFRRVAAAAKooKgAAAFUUFQAAgCqKCgAAQBVFBQAAoIqiAgAAUEVRAQAAqKKoAAAAVFFUAAAAqigqAAAAVRQVAACAKooKAABAFUUFAACgiqICAABQRVEBAACooqgAAABUUVQAAACqKCoAAABVFBUAAIAqigoAAEAVRQUAAKCKogIAAFBFUQEAAKiiqAAAAFRRVAAAAKooKgAAAFUUFQAAgCqKCgAAQBVFBQAAoIqiAgAAUEVRAQAAqKKoAAAAVFFUAAAAqigqAAAAVRQVAACAKooKAABAFUUFAACgiqICAABQRVEBAACooqgAAABUUVQAAACqKCoAAABVFBUAAIAqigoAAEAVRQUAAKCKogIAAFBFUQEAAKiiqAAAAFRRVAAAAKooKgAAAFUUFQAAgCqKCgAAQBVFBQAAoIqiAgAAUEVRAQAAqKKoAAAAVFFUAAAAqigqAAAAVRQVAACAKooKAABAFUUFAACgiqICAABQRVEBAACooqgAAABUUVQAAACqKCoAAABVFBUAAIAqigoAAEAVRQUAAKCKogIAAFBFUQEAAKiiqAAAAFRRVAAAAKooKgAAAFUUFQAAgCqKCgAAQBVFBQAAoIqiAgAAUEVRAQAAqKKoAAAAVFFUAAAAqigqAAAAVRQVAACAKooKAABAFUUFAACgiqICAABQRVEBAACooqgAAABUUVQAAACqKCoAAABVFBUAAIAqigoAAEAVRQUAAKCKogIAAFBFUQEAAKiiqAAAAFRRVAAAAKooKgAAAFUUFQAAgCqKCgAAQBVFBQAAoIqiAgAAUEVRAQAAqKKoAAAAVFFUAAAAqigqAAAAVRQVAACAKooKAABAFUUFAACgiqICAABQRVEBAACooqgAAABUUVQAAACqKCoAAABVFBUAAIAqigoAAEAVRQUAAKCKogIAAFBFUQEAAKiiqAAAAFRRVAAAAKooKgAAAFUUFQAAgCqKCgAAQBVFBQAAoIqiAgAAUEVRAQAAqKKoAAAAVFFUAAAAqigqAAAAVRQVAACAKooKAABAFUUFAACg6v8BST7r5ceR8qAAAAAASUVORK5CYII=\n",
      "text/plain": [
       "<PIL.Image.Image image mode=RGB size=795x600 at 0x7FF1C4B3C978>"
      ]
     },
     "execution_count": 7,
     "metadata": {},
     "output_type": "execute_result"
    }
   ],
   "source": [
    "obj = M.new(type='o')  # New portable object with a randomly generated name.\n",
    "M.inventory.add(obj)   # Add the object to the player's inventory.\n",
    "\n",
    "container = M.new(type='c')      # Creating a container with a randomly generated name\n",
    "M.add_fact(\"closed\", container)  # Set the state of the container to 'closed'.\n",
    "roomB.add(container)             # Place the container in Room B\n",
    "\n",
    "M.render()"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "#### Finally, record the quest.\n",
    "Type all commands you would like to be included in the game's quest. To end recording, interrupt the kernel (the stop button above).\n",
    "\n",
    "*Hint: take old key from plate, unlock door with old key, open it, go east, open refrigerator, insert coffee cup into refrigerator, quit.*"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 8,
   "metadata": {
    "scrolled": false
   },
   "outputs": [
    {
     "name": "stdout",
     "output_type": "stream",
     "text": [
      "\n",
      "\n",
      "\n",
      "                    ________  ________  __    __  ________\n",
      "                   |        \\|        \\|  \\  |  \\|        \\\n",
      "                    \\$$$$$$$$| $$$$$$$$| $$  | $$ \\$$$$$$$$\n",
      "                      | $$   | $$__     \\$$\\/  $$   | $$\n",
      "                      | $$   | $$  \\     >$$  $$    | $$\n",
      "                      | $$   | $$$$$    /  $$$$\\    | $$\n",
      "                      | $$   | $$_____ |  $$ \\$$\\   | $$\n",
      "                      | $$   | $$     \\| $$  | $$   | $$\n",
      "                       \\$$    \\$$$$$$$$ \\$$   \\$$    \\$$\n",
      "              __       __   ______   _______   __        _______\n",
      "             |  \\  _  |  \\ /      \\ |       \\ |  \\      |       \\\n",
      "             | $$ / \\ | $$|  $$$$$$\\| $$$$$$$\\| $$      | $$$$$$$\\\n",
      "             | $$/  $\\| $$| $$  | $$| $$__| $$| $$      | $$  | $$\n",
      "             | $$  $$$\\ $$| $$  | $$| $$    $$| $$      | $$  | $$\n",
      "             | $$ $$\\$$\\$$| $$  | $$| $$$$$$$\\| $$      | $$  | $$\n",
      "             | $$$$  \\$$$$| $$__/ $$| $$  | $$| $$_____ | $$__/ $$\n",
      "             | $$$    \\$$$ \\$$    $$| $$  | $$| $$     \\| $$    $$\n",
      "              \\$$      \\$$  \\$$$$$$  \\$$   \\$$ \\$$$$$$$$ \\$$$$$$$\n",
      "\n",
      "\n",
      "\n",
      "-= Room A =-\n",
      "You find yourself in a Room A.\n",
      "\n",
      "\n",
      "\n",
      "There is an exit to the east. Don't worry, it is unblocked.\n",
      "\n",
      "There is a note on the floor.\n",
      "\n",
      "Available actions: ['drop coffee cup', 'examine coffee cup', 'examine door', 'examine note', 'examine old key', 'examine plate', 'inventory', 'look', 'put coffee cup on plate', 'take note', 'take old key from plate']\n",
      "\n",
      "> take old key from plate\n",
      "You take the old key from the plate.\n",
      "\n",
      "Available actions: ['drop coffee cup', 'drop old key', 'examine coffee cup', 'examine door', 'examine note', 'examine old key', 'examine plate', 'inventory', 'look', 'put coffee cup on plate', 'put old key on plate', 'take note', 'unlock door with old key']\n",
      "\n",
      "> unlock door with old key\n",
      "You unlock door.\n",
      "\n",
      "Available actions: ['drop coffee cup', 'drop old key', 'examine coffee cup', 'examine door', 'examine note', 'examine old key', 'examine plate', 'inventory', 'lock door with old key', 'look', 'open door', 'put coffee cup on plate', 'put old key on plate', 'take note']\n",
      "\n",
      "> open it\n",
      "You open door.\n",
      "\n",
      "Available actions: ['close door', 'drop coffee cup', 'drop old key', 'examine coffee cup', 'examine door', 'examine note', 'examine old key', 'examine plate', 'go east', 'inventory', 'look', 'put coffee cup on plate', 'put old key on plate', 'take note']\n",
      "\n",
      "> go east\n",
      "\n",
      "-= Room B =-\n",
      "You're now in a Room B.\n",
      "\n",
      "\n",
      "\n",
      "You need an unguarded exit? You should try going west.\n",
      "\n",
      "Available actions: ['close door', 'drop coffee cup', 'drop old key', 'examine coffee cup', 'examine door', 'examine old key', 'examine refrigerator', 'go west', 'inventory', 'look', 'open refrigerator']\n",
      "\n",
      "> open refrigerator\n",
      "You open the refrigerator.\n",
      "\n",
      "Available actions: ['close door', 'close refrigerator', 'drop coffee cup', 'drop old key', 'examine coffee cup', 'examine door', 'examine old key', 'examine refrigerator', 'go west', 'insert coffee cup into refrigerator', 'insert old key into refrigerator', 'inventory', 'look']\n",
      "\n",
      "> insert coffee cup into refrigerator\n",
      "You put the coffee cup into the refrigerator.\n",
      "\n",
      "Available actions: ['close door', 'close refrigerator', 'drop old key', 'examine coffee cup', 'examine door', 'examine old key', 'examine refrigerator', 'go west', 'insert old key into refrigerator', 'inventory', 'look', 'take coffee cup from refrigerator']\n",
      "\n",
      "Done after 6 steps. Score 0/0.\n"
     ]
    }
   ],
   "source": [
    "quest = M.record_quest()"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "### Check recorded quest\n",
    "Now, let's see what the generated quest description looks like. "
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 9,
   "metadata": {},
   "outputs": [
    {
     "name": "stdout",
     "output_type": "stream",
     "text": [
      "take old key from plate > unlock door with old key > open door > go east > open refrigerator > insert coffee cup into refrigerator\n",
      "\n",
      "Hey, thanks for coming over to the TextWorld today, there is something I need you to do for me. First of all, you could, like, recover the old key from the plate within the Room A. Then, insert the old key into the door in the Room A's lock to unlock it. And then, ensure that the door is open. And then, make an effort to move east. Then, open the refrigerator inside the Room B. And then, you can put the coffee cup inside the refrigerator. And if you do that, you're the winner!\n"
     ]
    }
   ],
   "source": [
    "print(\" > \".join(quest.commands))\n",
    "print(\"\\n\" + quest.desc)"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "### Trying out the game\n",
    "At any point, we can easily test the game we are currently building (if it can compile)."
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 10,
   "metadata": {},
   "outputs": [
    {
     "name": "stdout",
     "output_type": "stream",
     "text": [
      "\n",
      "\n",
      "\n",
      "                    ________  ________  __    __  ________\n",
      "                   |        \\|        \\|  \\  |  \\|        \\\n",
      "                    \\$$$$$$$$| $$$$$$$$| $$  | $$ \\$$$$$$$$\n",
      "                      | $$   | $$__     \\$$\\/  $$   | $$\n",
      "                      | $$   | $$  \\     >$$  $$    | $$\n",
      "                      | $$   | $$$$$    /  $$$$\\    | $$\n",
      "                      | $$   | $$_____ |  $$ \\$$\\   | $$\n",
      "                      | $$   | $$     \\| $$  | $$   | $$\n",
      "                       \\$$    \\$$$$$$$$ \\$$   \\$$    \\$$\n",
      "              __       __   ______   _______   __        _______\n",
      "             |  \\  _  |  \\ /      \\ |       \\ |  \\      |       \\\n",
      "             | $$ / \\ | $$|  $$$$$$\\| $$$$$$$\\| $$      | $$$$$$$\\\n",
      "             | $$/  $\\| $$| $$  | $$| $$__| $$| $$      | $$  | $$\n",
      "             | $$  $$$\\ $$| $$  | $$| $$    $$| $$      | $$  | $$\n",
      "             | $$ $$\\$$\\$$| $$  | $$| $$$$$$$\\| $$      | $$  | $$\n",
      "             | $$$$  \\$$$$| $$__/ $$| $$  | $$| $$_____ | $$__/ $$\n",
      "             | $$$    \\$$$ \\$$    $$| $$  | $$| $$     \\| $$    $$\n",
      "              \\$$      \\$$  \\$$$$$$  \\$$   \\$$ \\$$$$$$$$ \\$$$$$$$\n",
      "\n",
      "Hey, thanks for coming over to the TextWorld today, there is something I need\n",
      "you to do for me. First of all, you could, like, recover the old key from the\n",
      "plate within the Room A. Then, insert the old key into the door in the Room A's\n",
      "lock to unlock it. And then, ensure that the door is open. And then, make an\n",
      "effort to move east. Then, open the refrigerator inside the Room B. And then,\n",
      "you can put the coffee cup inside the refrigerator. And if you do that, you're\n",
      "the winner!\n",
      "\n",
      "-= Room A =-\n",
      "You find yourself in a Room A.\n",
      "\n",
      "\n",
      "\n",
      "There is an exit to the east. Don't worry, it is unblocked.\n",
      "\n",
      "There is a note on the floor.\n",
      "\n",
      "> take old key from plate\n",
      "You take the old key from the plate.\n",
      "\n",
      "> unlock door with old key\n",
      "You unlock door.\n",
      "\n",
      "> open door\n",
      "You open door.\n",
      "\n",
      "> go east\n",
      "\n",
      "-= Room B =-\n",
      "You're now in a Room B.\n",
      "\n",
      "\n",
      "\n",
      "You need an unguarded exit? You should try going west.\n",
      "\n",
      "> open refrigerator\n",
      "You open the refrigerator.\n",
      "\n",
      "> insert coffee cup into refrigerator\n",
      "You put the coffee cup into the refrigerator.\n",
      "\n",
      "\n",
      "Your score has just gone up by one point.\n",
      "\n",
      "\n",
      "                               *** The End ***\n",
      "\n",
      "You scored 1 out of a possible 1, in 7 turn(s).\n",
      "\n",
      "\n",
      "Would you like to RESTART, RESTORE a saved game, QUIT or UNDO the last command?\n",
      ">\n",
      "\n",
      "Done after 6 steps. Score 1/1.\n"
     ]
    }
   ],
   "source": [
    "# Test the game by issuing commands from the generated walkthrough.\n",
    "# You can set `walkthrough=False` if you want to play the game yourself. \n",
    "M.test(walkthrough=True)"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "### Randomly generate quests for your game"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 11,
   "metadata": {},
   "outputs": [
    {
     "data": {
      "image/png": "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\n",
      "text/plain": [
       "<PIL.Image.Image image mode=RGB size=795x600 at 0x7FF1C4CB26D8>"
      ]
     },
     "execution_count": 11,
     "metadata": {},
     "output_type": "execute_result"
    }
   ],
   "source": [
    "import copy\n",
    "M2 = copy.deepcopy(M)        # Work on a copy.\n",
    "M2.generate_distractors(10)  # Add 10 objects for the agent to interact with.\n",
    "M2.render()"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 12,
   "metadata": {
    "scrolled": false
   },
   "outputs": [
    {
     "name": "stdout",
     "output_type": "stream",
     "text": [
      "Who's got a virtual machine and is about to play through an fast paced round of TextWorld? You do! Here is your task for today. Your first objective is to retrieve the note from the floor of the Room A. With the note, put the note on the saucepan in the Room A. After that, recover the fork from the plate within the Room A. And then, throw the fork on the floor of the Room A. Then, take the teaspoon from the plate in the Room A. After getting the teaspoon, put the teaspoon on the rack in the Room A. After putting the teaspoon on the rack, pick-up the legume from the floor of the Room A. Then, rest the legume on the plate. Then, retrieve the licorice strip from the plate. After picking up the licorice strip, place the licorice strip on the floor of the Room A. Once that's all handled, you can stop!\n"
     ]
    }
   ],
   "source": [
    "M2.generate_random_quests(5, length=2)  # Generate 5 random quests of length 2.\n",
    "game = M2.build()\n",
    "print(game.objective)"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 13,
   "metadata": {
    "scrolled": false
   },
   "outputs": [
    {
     "name": "stdout",
     "output_type": "stream",
     "text": [
      "\n",
      "\n",
      "\n",
      "                    ________  ________  __    __  ________\n",
      "                   |        \\|        \\|  \\  |  \\|        \\\n",
      "                    \\$$$$$$$$| $$$$$$$$| $$  | $$ \\$$$$$$$$\n",
      "                      | $$   | $$__     \\$$\\/  $$   | $$\n",
      "                      | $$   | $$  \\     >$$  $$    | $$\n",
      "                      | $$   | $$$$$    /  $$$$\\    | $$\n",
      "                      | $$   | $$_____ |  $$ \\$$\\   | $$\n",
      "                      | $$   | $$     \\| $$  | $$   | $$\n",
      "                       \\$$    \\$$$$$$$$ \\$$   \\$$    \\$$\n",
      "              __       __   ______   _______   __        _______\n",
      "             |  \\  _  |  \\ /      \\ |       \\ |  \\      |       \\\n",
      "             | $$ / \\ | $$|  $$$$$$\\| $$$$$$$\\| $$      | $$$$$$$\\\n",
      "             | $$/  $\\| $$| $$  | $$| $$__| $$| $$      | $$  | $$\n",
      "             | $$  $$$\\ $$| $$  | $$| $$    $$| $$      | $$  | $$\n",
      "             | $$ $$\\$$\\$$| $$  | $$| $$$$$$$\\| $$      | $$  | $$\n",
      "             | $$$$  \\$$$$| $$__/ $$| $$  | $$| $$_____ | $$__/ $$\n",
      "             | $$$    \\$$$ \\$$    $$| $$  | $$| $$     \\| $$    $$\n",
      "              \\$$      \\$$  \\$$$$$$  \\$$   \\$$ \\$$$$$$$$ \\$$$$$$$\n",
      "\n",
      "Who's got a virtual machine and is about to play through an fast paced round of\n",
      "TextWorld? You do! Here is your task for today. Your first objective is to\n",
      "retrieve the note from the floor of the Room A. With the note, put the note on\n",
      "the saucepan in the Room A. After that, recover the fork from the plate within\n",
      "the Room A. And then, throw the fork on the floor of the Room A. Then, take the\n",
      "teaspoon from the plate in the Room A. After getting the teaspoon, put the\n",
      "teaspoon on the rack in the Room A. After putting the teaspoon on the rack,\n",
      "pick-up the legume from the floor of the Room A. Then, rest the legume on the\n",
      "plate. Then, retrieve the licorice strip from the plate. After picking up the\n",
      "licorice strip, place the licorice strip on the floor of the Room A. Once that's\n",
      "all handled, you can stop!\n",
      "\n",
      "-= Room A =-\n",
      "You find yourself in a Room A.\n",
      "\n",
      "\n",
      "\n",
      "There is an exit to the east. Don't worry, it is unblocked.\n",
      "\n",
      "There is a legume, a fondue and a note on the floor.\n",
      "\n",
      "> take note\n",
      "You pick up the note from the ground.\n",
      "\n",
      "> put note on saucepan\n",
      "You put the note on the saucepan.\n",
      "\n",
      "\n",
      "Your score has just gone up by one point.\n",
      "\n",
      "> take fork from plate\n",
      "You take the fork from the plate.\n",
      "\n",
      "> drop fork\n",
      "You drop the fork on the ground.\n",
      "\n",
      "\n",
      "Your score has just gone up by one point.\n",
      "\n",
      "> take teaspoon from plate\n",
      "You take the teaspoon from the plate.\n",
      "\n",
      "> put teaspoon on rack\n",
      "You put the teaspoon on the rack.\n",
      "\n",
      "\n",
      "Your score has just gone up by one point.\n",
      "\n",
      "> take legume\n",
      "You pick up the legume from the ground.\n",
      "\n",
      "> put legume on plate\n",
      "You put the legume on the plate.\n",
      "\n",
      "\n",
      "Your score has just gone up by one point.\n",
      "\n",
      "> take licorice strip from plate\n",
      "You take the licorice strip from the plate.\n",
      "\n",
      "> drop licorice strip\n",
      "You drop the licorice strip on the ground.\n",
      "\n",
      "\n",
      "Your score has just gone up by one point.\n",
      "\n",
      "\n",
      "                               *** The End ***\n",
      "\n",
      "You scored 5 out of a possible 5, in 11 turn(s).\n",
      "\n",
      "\n",
      "Would you like to RESTART, RESTORE a saved game, QUIT or UNDO the last command?\n",
      ">\n",
      "\n",
      "Done after 10 steps. Score 5/5.\n"
     ]
    }
   ],
   "source": [
    "# Test the game by issuing commands from the walkthrough.\n",
    "M2.test(walkthrough=True)"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "## Handcrafting your game"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 14,
   "metadata": {
    "collapsed": true
   },
   "outputs": [
    {
     "ename": "MissingPlayerError",
     "evalue": "Player position has not been specified. Use 'M.set_player(room)'.",
     "output_type": "error",
     "traceback": [
      "\u001b[0;31m---------------------------------------------------------------------------\u001b[0m",
      "\u001b[0;31mMissingPlayerError\u001b[0m                        Traceback (most recent call last)",
      "\u001b[0;32m<ipython-input-14-56c5509f3dbd>\u001b[0m in \u001b[0;36m<module>\u001b[0;34m\u001b[0m\n\u001b[1;32m     16\u001b[0m \u001b[0;31m# print(\"\\n\" + quest.desc)\u001b[0m\u001b[0;34m\u001b[0m\u001b[0;34m\u001b[0m\u001b[0;34m\u001b[0m\u001b[0m\n\u001b[1;32m     17\u001b[0m \u001b[0;34m\u001b[0m\u001b[0m\n\u001b[0;32m---> 18\u001b[0;31m \u001b[0mM\u001b[0m\u001b[0;34m.\u001b[0m\u001b[0mtest\u001b[0m\u001b[0;34m(\u001b[0m\u001b[0;34m)\u001b[0m  \u001b[0;31m# Try your game.\u001b[0m\u001b[0;34m\u001b[0m\u001b[0;34m\u001b[0m\u001b[0m\n\u001b[0m",
      "\u001b[0;32m/data/src/TextWorld/textworld/generator/maker.py\u001b[0m in \u001b[0;36mtest\u001b[0;34m(self, walkthrough)\u001b[0m\n\u001b[1;32m    607\u001b[0m \u001b[0;34m\u001b[0m\u001b[0m\n\u001b[1;32m    608\u001b[0m         \u001b[0;32mwith\u001b[0m \u001b[0mmake_temp_directory\u001b[0m\u001b[0;34m(\u001b[0m\u001b[0;34m)\u001b[0m \u001b[0;32mas\u001b[0m \u001b[0mtmpdir\u001b[0m\u001b[0;34m:\u001b[0m\u001b[0;34m\u001b[0m\u001b[0;34m\u001b[0m\u001b[0m\n\u001b[0;32m--> 609\u001b[0;31m             \u001b[0mgame_file\u001b[0m \u001b[0;34m=\u001b[0m \u001b[0mself\u001b[0m\u001b[0;34m.\u001b[0m\u001b[0mcompile\u001b[0m\u001b[0;34m(\u001b[0m\u001b[0mpjoin\u001b[0m\u001b[0;34m(\u001b[0m\u001b[0mtmpdir\u001b[0m\u001b[0;34m,\u001b[0m \u001b[0;34m\"test_game.ulx\"\u001b[0m\u001b[0;34m)\u001b[0m\u001b[0;34m)\u001b[0m\u001b[0;34m\u001b[0m\u001b[0;34m\u001b[0m\u001b[0m\n\u001b[0m\u001b[1;32m    610\u001b[0m \u001b[0;34m\u001b[0m\u001b[0m\n\u001b[1;32m    611\u001b[0m             \u001b[0magent\u001b[0m \u001b[0;34m=\u001b[0m \u001b[0mtextworld\u001b[0m\u001b[0;34m.\u001b[0m\u001b[0magents\u001b[0m\u001b[0;34m.\u001b[0m\u001b[0mHumanAgent\u001b[0m\u001b[0;34m(\u001b[0m\u001b[0mautocompletion\u001b[0m\u001b[0;34m=\u001b[0m\u001b[0;32mTrue\u001b[0m\u001b[0;34m)\u001b[0m\u001b[0;34m\u001b[0m\u001b[0;34m\u001b[0m\u001b[0m\n",
      "\u001b[0;32m/data/src/TextWorld/textworld/generator/maker.py\u001b[0m in \u001b[0;36mcompile\u001b[0;34m(self, path)\u001b[0m\n\u001b[1;32m    823\u001b[0m             \u001b[0mPath\u001b[0m \u001b[0mto\u001b[0m \u001b[0mthe\u001b[0m \u001b[0mgame\u001b[0m \u001b[0mfile\u001b[0m\u001b[0;34m.\u001b[0m\u001b[0;34m\u001b[0m\u001b[0;34m\u001b[0m\u001b[0m\n\u001b[1;32m    824\u001b[0m         \"\"\"\n\u001b[0;32m--> 825\u001b[0;31m         \u001b[0mself\u001b[0m\u001b[0;34m.\u001b[0m\u001b[0m_working_game\u001b[0m \u001b[0;34m=\u001b[0m \u001b[0mself\u001b[0m\u001b[0;34m.\u001b[0m\u001b[0mbuild\u001b[0m\u001b[0;34m(\u001b[0m\u001b[0;34m)\u001b[0m\u001b[0;34m\u001b[0m\u001b[0;34m\u001b[0m\u001b[0m\n\u001b[0m\u001b[1;32m    826\u001b[0m         \u001b[0moptions\u001b[0m \u001b[0;34m=\u001b[0m \u001b[0mtextworld\u001b[0m\u001b[0;34m.\u001b[0m\u001b[0mGameOptions\u001b[0m\u001b[0;34m(\u001b[0m\u001b[0;34m)\u001b[0m\u001b[0;34m\u001b[0m\u001b[0;34m\u001b[0m\u001b[0m\n\u001b[1;32m    827\u001b[0m         \u001b[0moptions\u001b[0m\u001b[0;34m.\u001b[0m\u001b[0mpath\u001b[0m \u001b[0;34m=\u001b[0m \u001b[0mpath\u001b[0m\u001b[0;34m\u001b[0m\u001b[0;34m\u001b[0m\u001b[0m\n",
      "\u001b[0;32m/data/src/TextWorld/textworld/generator/maker.py\u001b[0m in \u001b[0;36mbuild\u001b[0;34m(self, validate)\u001b[0m\n\u001b[1;32m    782\u001b[0m         \"\"\"\n\u001b[1;32m    783\u001b[0m         \u001b[0;32mif\u001b[0m \u001b[0mvalidate\u001b[0m\u001b[0;34m:\u001b[0m\u001b[0;34m\u001b[0m\u001b[0;34m\u001b[0m\u001b[0m\n\u001b[0;32m--> 784\u001b[0;31m             \u001b[0mself\u001b[0m\u001b[0;34m.\u001b[0m\u001b[0mvalidate\u001b[0m\u001b[0;34m(\u001b[0m\u001b[0;34m)\u001b[0m  \u001b[0;31m# Validate the state of the world.\u001b[0m\u001b[0;34m\u001b[0m\u001b[0;34m\u001b[0m\u001b[0m\n\u001b[0m\u001b[1;32m    785\u001b[0m \u001b[0;34m\u001b[0m\u001b[0m\n\u001b[1;32m    786\u001b[0m         \u001b[0mworld\u001b[0m \u001b[0;34m=\u001b[0m \u001b[0mWorld\u001b[0m\u001b[0;34m.\u001b[0m\u001b[0mfrom_facts\u001b[0m\u001b[0;34m(\u001b[0m\u001b[0mself\u001b[0m\u001b[0;34m.\u001b[0m\u001b[0mfacts\u001b[0m\u001b[0;34m,\u001b[0m \u001b[0mkb\u001b[0m\u001b[0;34m=\u001b[0m\u001b[0mself\u001b[0m\u001b[0;34m.\u001b[0m\u001b[0m_kb\u001b[0m\u001b[0;34m)\u001b[0m\u001b[0;34m\u001b[0m\u001b[0;34m\u001b[0m\u001b[0m\n",
      "\u001b[0;32m/data/src/TextWorld/textworld/generator/maker.py\u001b[0m in \u001b[0;36mvalidate\u001b[0;34m(self)\u001b[0m\n\u001b[1;32m    761\u001b[0m         \u001b[0;32mif\u001b[0m \u001b[0mself\u001b[0m\u001b[0;34m.\u001b[0m\u001b[0mplayer\u001b[0m \u001b[0;32mnot\u001b[0m \u001b[0;32min\u001b[0m \u001b[0mself\u001b[0m\u001b[0;34m:\u001b[0m\u001b[0;34m\u001b[0m\u001b[0;34m\u001b[0m\u001b[0m\n\u001b[1;32m    762\u001b[0m             \u001b[0mmsg\u001b[0m \u001b[0;34m=\u001b[0m \u001b[0;34m\"Player position has not been specified. Use 'M.set_player(room)'.\"\u001b[0m\u001b[0;34m\u001b[0m\u001b[0;34m\u001b[0m\u001b[0m\n\u001b[0;32m--> 763\u001b[0;31m             \u001b[0;32mraise\u001b[0m \u001b[0mMissingPlayerError\u001b[0m\u001b[0;34m(\u001b[0m\u001b[0mmsg\u001b[0m\u001b[0;34m)\u001b[0m\u001b[0;34m\u001b[0m\u001b[0;34m\u001b[0m\u001b[0m\n\u001b[0m\u001b[1;32m    764\u001b[0m \u001b[0;34m\u001b[0m\u001b[0m\n\u001b[1;32m    765\u001b[0m         \u001b[0mfailed_constraints\u001b[0m \u001b[0;34m=\u001b[0m \u001b[0mget_failing_constraints\u001b[0m\u001b[0;34m(\u001b[0m\u001b[0mself\u001b[0m\u001b[0;34m.\u001b[0m\u001b[0mstate\u001b[0m\u001b[0;34m,\u001b[0m \u001b[0mself\u001b[0m\u001b[0;34m.\u001b[0m\u001b[0m_kb\u001b[0m\u001b[0;34m)\u001b[0m\u001b[0;34m\u001b[0m\u001b[0;34m\u001b[0m\u001b[0m\n",
      "\u001b[0;31mMissingPlayerError\u001b[0m: Player position has not been specified. Use 'M.set_player(room)'."
     ]
    }
   ],
   "source": [
    "import textworld\n",
    "from textworld import GameMaker\n",
    "\n",
    "# Make the generation process reproducible.\n",
    "from textworld import g_rng  # Global random generator.\n",
    "g_rng.set_seed(20180329)\n",
    "\n",
    "# GameMaker object for handcrafting text-based games.\n",
    "M = GameMaker()\n",
    "\n",
    "# ---> Build your game here using TextWorld GameMaker's API. <---\n",
    "\n",
    "# Uncomment the following lines to record a quest.\n",
    "# quest = M.record_quest()\n",
    "# print(\" > \".join(quest.commands))\n",
    "# print(\"\\n\" + quest.desc)\n",
    "\n",
    "M.test()  # Try your game."
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "## Common Errors\n",
    "- `FailedConstraintsError`: One the constraints has failed. You need to resolve the issue before being able to compile the game. The most common issues:\n",
    "    - Two objects cannot have the exact same name. Names can be composed of multiple words.\n",
    "    - A same objects was added twice to a container, supporter, room or inventory.\n",
    "- `ValueError: Could not determine status '' of container/door ...`: You have to provide the status (a fact) of the door/container, i.e. 'open', 'closed' or 'locked'."
   ]
  }
 ],
 "metadata": {
  "kernelspec": {
   "display_name": "Python 3",
   "language": "python",
   "name": "python3"
  },
  "language_info": {
   "codemirror_mode": {
    "name": "ipython",
    "version": 3
   },
   "file_extension": ".py",
   "mimetype": "text/x-python",
   "name": "python",
   "nbconvert_exporter": "python",
   "pygments_lexer": "ipython3",
   "version": "3.7.3"
  }
 },
 "nbformat": 4,
 "nbformat_minor": 2
}