{"data":{"kind":"file","path":"README.md","version_id":"giqjyfxow7lqgluuuejydluy","entry":{"name":"README.md","path":"README.md","is_directory":false,"size":2769,"modified_at":"2026-08-04T06:46:51.420000","content_hash":"1c226b93823e0fb5e044dd098ba0d905cbbc93a5dc9723818eb4a253d26eee4e"},"entries":[],"content":"# Text Adventure Game (Zork-like)\n\nA multi-turn text adventure game environment for evaluating LLM capabilities in interactive fiction. Inspired by classic text adventures like Zork, this environment tests problem-solving, spatial reasoning, puzzle-solving, and narrative engagement.\n\n## Environment Overview\n\nThe agent explores an ancient underground palace with 9 interconnected rooms, each containing items, puzzles, and secrets. The goal is to navigate the dungeon, solve puzzles, collect items, and find the legendary Ruby of the Ancients.\n\n### Rooms\n\n| Room | Description |\n|------|-------------|\n| Entrance Hall | Starting room with an oak door riddle |\n| Portrait Gallery | Gallery with a knight statue missing its sword |\n| Dusty Library | Contains a journal with clues and a hidden bookshelf |\n| Secret Study | Hidden alchemist's room with the enchanted sword |\n| Dark Cellar | A combination-locked iron chest |\n| Abandoned Workshop | A machine that needs a golden gear |\n| Moonlit Garden | A knight guardian blocks the treasure gate |\n| Treasure Chamber | Final room with the legendary Ruby |\n\n### Puzzles\n\n1. **Entrance Riddle** — \"I have cities but no houses...\" (Answer: map)\n2. **Library Secret** — Pull the right book to reveal a hidden passage\n3. **Cellar Combination** — Moon, Star, Sun (based on inscription clues)\n4. **Garden Gate** — Present the enchanted sword to the knight guardian\n\n### Evaluation Metrics\n\n- **Rooms Explored** (20%) — How many of the 9 rooms were visited\n- **Puzzles Solved** (30%) — Number of puzzles correctly solved\n- **Items Collected** (20%) — Useful items gathered during exploration\n- **Treasure Found** (20%) — Whether the final treasure was reached\n- **Narrative Engagement** (10%) — Sustained interaction throughout the game\n\n## Usage\n\n```python\nimport verifiers as vf\n\nenv = vf.load_environment(\"phamminh/text-adventure-game\")\n```\n\n### With custom settings\n\n```python\nenv = vf.load_environment(\"phamminh/text-adventure-game\", max_turns=40)\n```\n\n## Game Commands\n\n| Command | Description |\n|---------|-------------|\n| `GO <direction>` | Move north/south/east/west |\n| `TAKE <item>` | Pick up an item |\n| `USE <item>` | Use an item from inventory |\n| `USE <item> ON <target>` | Use item on something |\n| `LOOK` | Examine the room |\n| `INVENTORY` | Check inventory |\n| `EXAMINE <thing>` | Look closely at something |\n| `SOLVE <answer>` | Answer a puzzle |\n| `PULL/TURN/PUSH <object>` | Interact with objects |\n\n## Design Notes\n\n- Multi-turn environment with stateful game engine\n- Hidden rooms require specific actions to unlock\n- Items must be collected and used in the correct sequence\n- Puzzles require reading environmental clues carefully\n- 30-turn default limit encourages efficient exploration\n","encoding":"utf-8","truncated":false,"total_bytes":2769},"status":null}