Here's a quick intro to installing and playing (the current version of) PlomRogue. I assume you have already have installed the following:
- a Unix-like operating system (so far, I've tested PlomRogue only on some Debian and Arch Linux systems)
- some (virtual) terminal / shell console (such as xterm)
- the ncurses library and its headers (ncurses.h)
- some means to get and extract the PlomRogue source files (a working internet connection; git, or unzip and a download tool like wget)
- gcc (4.7+)
First, start up your terminal. Then, if you got git on your system, do this:
$ git clone https://github.com/plomlompom/plomrogue $ cd plomrogue/
You don't have git? Then download and unzip the source files from https://github.com/plomlompom/plomrogue/archive/master.zip like this (I assume you have unzip and wget installed):
$ wget https://github.com/plomlompom/plomrogue/archive/master.zip $ unzip master.zip $ cd plomrogue-master/
Now let's build and start the game:
$ ./redo $ ./roguelike
If nothing happens, read ./log for error messages of ./roguelike.
Make redo may have failed to build ./plomrogue-server and ./plomrogue-client. That's interesting! Leave a message in the comments with your configuration then. Or send me an e-mail to <firstname.lastname@example.org>. (If you played previously, give ./roguelike a while to start. It will then try to re-play your old game from the ./record file first.)
How to play
You'll now see something like this:
There's different windows, with their titles on top. One title is surrounded by two dollar signs ("$"). This is the title of the "active" window. Some keybindings are available on all windows. Others are available only for the active window. The window on the left lists available keybindings. The ">"/"<" keys move the active window selection forward/backward.
Initially, the "Map" window is active. That is a good place to start. Check it out: "@" is your player character. "." dots are ground you can move on. "~" tildes mark sea tiles, over which you cannot move. "S", "z" and "a" are different kinds of enemies. "#", "%" and "m" are different kinds of items you can pick up.
To attack enemies, just move into the square they stand on. So far, there is not much to do but this: Kill enemies, and avoid getting killed by them. Look out for "m" items. Those are "MAGIC MEAT" that you can consume, to gain hitpoints. (You must switch to the "Inventory" window for doing that.)
The game is saved in the ./record file. Delete this file to start over in a new world.
There's more stuff to describe. You can replay your playing record with ./roguelike -s. Windows and keybindings can be managed in bizarre ways. There are configuration files for all lifeforms and objects. ./roguelike hides a server client architecture to break up. I will talk about such things in other posts. If you are urgently interested, you can read the README.