MicroRealms

Introduction

MicroRealms is a minimal adventure game in the style of games like Dungeons and Dragons. It was written for a microcontroller (NXP's LPC810) with a UART interface but could be ported to another platform quite easily (rewrite the contents of serial.c). Given the very limited resources typically found in a microcontroller (the LPC810 has 4kB or Flash memory and 1kB of RAM) lots of imagination is required to fully appreciate the game. Many games have hidden "easter eggs" i.e. some additional feature that is only revealed after you perform a particular sequence of operations. The easter egg in MicroRealms is that it contains a game within a game. This "hidden" game is a challenge to all to improve (or port) MicroRealms within the limited program and data space available.
Special thanks to Sam Duignan and Oran Duignan for design, test and demonstration.

Code

Code is available for download here

Game play

Realm is displayed in ASCII characters as shown here. The player is represented by an '@' symbol. The map legend shows the meaning of the other symbols. Generally capital letters represent BAD GUYS (apart from X - the exit) while lower case letters are good things. You can view the map during the game however be aware - each look at the map costs you a gold piece and the goal of the game is to amass as much gold as possible. If you need help at any point press H.

System requirements

You don't have to compile the game, a compiled version is provided in main.elf. You need a chip: the LPC810 - I got mine from Farnell at around 1 euro each) and a USB to serial converter. A breadboard (protoboard) is required along with a couple of resistors and buttons. (See circuit diagram). The next thing you need to do is to get the program on to the chip. I use lpc2isp for this. In order to compile the game you need a cross compiler for the ARM Cortex processor. You can get one for your platform here: https://launchpad.net/gcc-arm-embedded
You will also need some version of GNU make. On a Debian based Linux system (including Ubuntu) install the build-essential package. On a Windows system install MinGW and its MSYS component.

Combat

When you encounter a bad guy you can choose to fight (f) or run away (press any other key) When fighting you can cast spells if you have enough magic points. The damage you do with each spell consists of two parts. One part is as specified in the table below. An additional "random" amount of damage up to 10 health points is also included. When you strike an opponent with a weapon or your fist you do certain amount of damage (as outlined in the table below) as well as a random amount the size of which depends on your strength points. You lose one strength point for each blow.

Spell damage

Spell	Ogre	Troll	Dragon	Cost(magic points)
Fire	20	10	5	10
Freeze	10	20	5	20
Lightning bolt	15	10	25	30

Weapon damage

Weapon	Ogre	Troll	Dragon	Hag
Fist	5	5	2	10
Axe	10	10	5	25
Sword	5	15	10	25
Flail	10	15	5	15

Damage done by bad guys to you

Ogre	Troll	Dragon	Hag
20	10	30	15

Construction

You will need a breadboard (proto-board), two LED's, 3 470ohm resistors, an LPC810 (LPC810M021FN8FP in Farnell's catalog), two normally open momentary push buttons and some wire. You will also need a USB to serial converter that outputs a 3.3V supply (this should cost around 5 Euro if you shop online. Assemble the board as shown below, connect to your PC and you should be set to program the chip and play. In-System-Programming requires you to hold down both ISP and Reset buttons. Release the Reset button first and the internal bootloader in the LPC810 will detect that you have the ISP pin pulled to 0V. This will cause the chip to startup in ISP mode allowing the lpc2isp utility write to it.