View Code? Open in Web Editor NEW

An RPG text adventure written in Go for educational purposes. It features colors (on the terminal) and game pictures (on a Sense HAT).

License: Other

Go 69.68% Python 15.55% Makefile 14.77%

picventure's Introduction

Picventure

The RPG text adventure project from under raspberrypi.org implemented in Go for educational purposes. It features colors (on the terminal) and game pictures (on a Sense HAT). The latter is locally exposed as a "web service" (called "picservice") and loosely coupled to the game implementation. The idea is to also demo microservices to kids.

Design

Environments

Developed on a Raspberry Pi 400:

$ uname -a
Linux raspi400 5.8.0-1010-raspi #13-Ubuntu SMP PREEMPT Wed Dec 9 17:14:07 UTC 2020 aarch64 aarch64 aarch64 GNU/Linux
$ go version
go version go1.14.7 linux/arm64

Also tested on a Lenovo ThinkPad X250:

$ uname -a
Linux x250 4.15.0-135-generic #139-Ubuntu SMP Mon Jan 18 17:38:24 UTC 2021 x86_64 x86_64 x86_64 GNU/Linux
$ go version
go version go1.16 linux/amd64

Make

$ make
usage: make <target>

  where <target> is one of the following

    all         to run all on both, picservice and rpg

    help        to show this text

$ make all
# ...

Play

Start picservice

Open a shell in this directory, then:

$ cd picservice && GIN_MODE=release ./picservice
INFO[0000] picservice start...

Start picventure

Open a separate shell in this directory, then:

$ cd rpg && ./picventure 
Picventure - A colorful RPG adventure (with optional pictures)
==============================================================

Get to the Garden with a key and a potion
Avoid the monsters!

Commands:
  go "direction"    (where "direction" is one of the following: north, east, south, west)
  get "item"
  exit
---------------------------
You are in the Hall
You see a key
Inventory:
---------------------------
>