315-P6-Starter

The Lost Shrine - A text-adventure CLI game starter implementation.

Current Implementation Status

This is a starter implementation with basic game mechanics:

Implemented Commands

• look - Display the current room (title, description, items, exits)
• help - List available commands
• go <direction> - Move between rooms (north, east, south, west)
• quit - Exit the game

Implemented Rooms

• Cottage (starting room) - Contains map, exits north to Forest
• Forest - Contains rope, exits south to Cottage

TODO

• Add remaining rooms (Clearing, Riverbank, Hill, Bridge, Stone Gate, Dark Cave, etc.)
• Implement take and drop commands for item management
• Implement inventory command
• Implement examine command for item descriptions
• Implement use command for context-specific actions (rope, pickaxe, lantern)
• Implement light lantern command
• Add game mechanics: bridge blocking, darkness hazard, quicksand soft reset
• Add victory condition (taking the artifact)

Prerequisites

• Go toolchain (go version shows installed). Current development version: 1.22+
• (Optional) golangci-lint for linting: install via go install github.com/golangci/golangci-lint/cmd/golangci-lint@latest.

Quick Start

Run the game:

go run ./cmd/app

Or build and run:

make run

Run tests:

make test

Game Play Example

Cottage
A cozy wooden cottage. There's a table with a dusty old map.
You see: map
Exits: north
> help
Available commands:
  look - Re-print the current room
  help - List supported commands
  go <direction> - Move in a direction (north, east, south, west)
  quit - Exit the game
> go north
Forest
Tall trees surround you. A rope dangles from a branch.
You see: rope
Exits: south
> go south
Cottage
A cozy wooden cottage. There's a table with a dusty old map.
You see: map
Exits: north
> quit