Readme for Allure-0.4.2

Allure of the Stars

This is an alpha pre-release of Allure of the Stars, a near-future Sci-Fi [roguelike] 1 and tactical squad game. Long-term goals are high replayability and auto-balancing through procedural content generation and persistent content modification based on player behaviour. The game is written in [Haskell] 2 and based on the [LambdaHack roguelike engine] 3.

Compilation and installation

The game is best compiled and installed via Cabal, which also takes care of all dependencies. The latest official version of the game can be downloaded automatically by Cabal from [Hackage] 4 as follows

cabal install Allure

For a more current snapshot, download the source from [github] 5 and run Cabal from the main directory

cabal install

The best frontend (keyboard support and colours) is gtk, but if needed, you may try one of the terminal frontends with, e.g,

cabal install -fvty

To use a crude bot for testing the game, you have to compile with the standard input/output frontend, as follows

cabal install -fstd

and run the bot, for example, in the following way

BotAllure 42 20000000 | Allure > /tmp/log

You may wish to tweak the game configuration file to let the bot play longer, e.g., by making the dungeon much deeper, as in the supplied config.bot.

Savegame directory

If you don't want Allure of the Stars to write to the current directory, create a personal savegame directory (on Linux it's ~/.Allure/). and copy the scores file there. You may also want to copy the configuration file src/config.default to ~/.Allure/config and modify it, but be careful changing gameplay options --- they can easily unbalance or break the game.

Further information

For more information, visit the wiki at https://github.com/Mikolaj/Allure/wiki and see the files PLAYING.md, CREDITS and LICENSE.

Have fun!