Skip to content

text-adventure

Directory actions

More options

Directory actions

More options

Latest commit

 

History

History

text-adventure

Folders and files

NameName
Last commit message
Last commit date

parent directory

..
README.md
README.md
 
 
game.test.ts
game.test.ts
 
 
game.ts
game.ts
 
 
package.json
package.json
 
 
tsconfig.json
tsconfig.json
 
 

README.md

Text adventure

AI-driven text adventure: the agent chooses actions in a small dungeon (LLM required).

Prerequisites

From the elizaOS repository root:

bun install
export OPENAI_API_KEY=your_key_here

Run

cd packages/examples/text-adventure
bun install

# Quieter logs
LOG_LEVEL=fatal bun run game.ts

# Optional persistent DB
PGLITE_DATA_DIR=./adventure-db LOG_LEVEL=fatal bun run game.ts

Test

bun test

The test suite exercises the local dungeon engine with a deterministic no-LLM playthrough. Running the interactive or autonomous CLI still requires OPENAI_API_KEY.

Features

  • Multiple rooms, items, and enemies
  • Autonomous or guided play (see game.ts for flags)
  • Uses ModelType.TEXT_SMALL for action selection

Related examples

  • packages/examples/chat/chat.ts — CLI chat
  • packages/examples/tic-tac-toe/game.ts — no-LLM minimax demo
  • packages/examples/game-of-life/game.ts — no-LLM multi-agent simulation