Skip to content
Browse files

Update game docs

  • Loading branch information...
1 parent df1f148 commit b7c85832e881de5d864cfab35b051799cdad252d @Mikolaj Mikolaj committed
Showing with 40 additions and 33 deletions.
  1. +1 −1 Allure.cabal
  2. +37 −30 PLAYING.md
  3. +2 −2 README.md
View
2 Allure.cabal
@@ -10,7 +10,7 @@ author: Andres Loeh, Mikolaj Konarski and others
maintainer: Mikolaj Konarski <mikolaj.konarski@funktory.com>
description: This is an alpha release of Allure of the Stars,
a near-future Sci-Fi roguelike and tactical squad game.
- The game is barely playable at this stage and not yet
+ The game is barely fun at this stage and not yet
really Sci-Fi. See the wiki for design notes and contribute.
.
Long term goals are high replayability and auto-balancing
View
67 PLAYING.md
@@ -1,32 +1,33 @@
Playing Allure of the Stars
===========================
-Playing Allure of the Stars involves walking around a Solar System space-ship,
-alone or in a party of trusted crew-members, gaining access to new levels,
-bumping into hostile intruders, doors and walls, gathering technical resources
-and making creative use of them. The bloodthirsty alien monsters do the same,
-intelligence allowing, while tirelessly chasing the noble heroes
-by smell and sight.
+Playing Allure of the Stars involves walking around an abandoned
+Solar System space-ship, alone or in a party of trusted crew-members,
+setting up ambushes, hiding in shadow, covering tracks,
+breaking through to deeper spaceship decks, bumping into
+hostile intruders, doors and walls, gathering technical resources
+and making creative use of them. The bloodthirsty alien monsters
+and their horrible minions do the same, intelligence allowing,
+while tirelessly chasing the stranded heroes by smell and sight.
Once the few basic command keys and on-screen symbols are learned,
mastery and enjoyment of the game is the matter of tactical skill
and literary imagination. To be honest, a lot of imagination is required
-right now, but the game is already playable and winnable.
+at this stage, but the game is already playable and winnable.
Contributions welcome.
Terrain
-------
-The goal of the hero is to explore the spaceship, battle the horrors within,
-gather as much gold coins and precious gems as possible, and escape
-to tell the tale. The spaceship consists of many levels covered with varying
-terrain of the following basic kinds:
+The goal of the hero is to explore an old, once luxurious space liner,
+battle the horrors within, gather as much gold coins and precious gems
+as possible, and escape to tell the tale. The spaceship consists
+of many levels covered with varying terrain of the following basic kinds:
terrain type on-screen symbol
floor .
wall #
- pillar O
stairs up <
stairs down >
open door '
@@ -35,11 +36,11 @@ terrain of the following basic kinds:
The game world is persistent, i.e., every time the player visits a level
during a single game, the level layout is the same. Some items
aid in exploration, e.g., a ring of searching improves the speed
-of finding hidden doors by heroes and monsters. The higher the magical
+of finding hidden doors by heroes and monsters. The higher the ability
bonus displayed for this and other items, the more effective it is.
Only the best item carried in a hero's or monster's inventory counts.
You can throw the rest away, but beware that your adversaries may pick it up
-and use it against you.
+and use it against your party.
Keys
@@ -62,8 +63,9 @@ of curses, terminfo and terminal emulators. Vi keys should work regardless.)
Melee, searching for secret doors and opening closed doors can be done
by bumping into a monster, a wall and a door, respectively.
-Below are the default keys for major commands. Those of them that take
-player time are marked with a *.
+Below are the default keys for major commands. The last four commands
+are specialized versions of 'a' and 'p', offering narrower default item choice.
+The commands that take player time are marked with a *.
key command
< ascend a level*
@@ -71,22 +73,27 @@ player time are marked with a *.
? display help
Q quit without saving
X save and exit the game
- a apply an applicable*
+ a apply a consumable*
c close a door*
d drop an object*
g get an object*
i display inventory
- p project a projectable*
+ p project a projectile*
+ q quaff a drink*
+ r read a comm*
+ t throw a missile*
+ z zap a mechanism*
To make a ranged attack, you need to set your target first, using
targeting mode. Note that the target, for the few commands that require any,
-is indicated by the targeting cursor, but the origin of a command
---- the hero that performs it --- is unaffacted by targeting. For example,
+is indicated by the targeting cursor. The origin of a command
+--- the hero that performs it --- is unaffected by targeting. For example,
not the targeted door, but one adjacent to the selected hero is closed by him.
+
To avoid confusion, commands that take time are blocked when targeting
-a remote level (when the cursor is on a different level than the selected hero).
-The targeting commands and all the less used commands are listed below.
-None of them takes hero time.
+at a remote level (when the cursor is on a different level
+than the selected hero). The targeting commands and all the less used
+commands are listed below. None of them takes hero time.
key command
ESC cancel action
@@ -119,7 +126,7 @@ The hero is not alone in the spaceship. Monsters roam the dark halls
and crawl from damp air-ducts day and night. While heroes pay attention
to all other party members and take moves sequentially, one after another,
monsters don't care about each other and all move at once,
-sometimes brutally colliding by mistake.
+sometimes brutally colliding by accident.
When the hero bumps into a monster or a monster attacks the hero,
melee combat occurs. The best weapon carried by each opponent
@@ -132,11 +139,11 @@ This gives the opponent a free blow, but can improve the tactical situation
or aid escape.
Throwing weapons at targets wounds them, consuming the weapon in the process.
-Target a monster with the '*' key from the top keboard row or from kepad.
+Target a monster with the '*' key from the top keyboard row or from keypad.
You may throw any object in your possession (press '?' to choose
an object and press it again for a non-standard choice) or on the floor
(press '-'). Only objects of a few kinds inflict any damage.
-Whenever a monster or a hero hit points reach zero, the combatant dies.
+Whenever the monster's or hero's hit points reach zero, the combatant dies.
When the last hero dies, the game ends.
@@ -145,10 +152,10 @@ On Winning and Dying
You win the game if you escape the spaceship alive. Your score is
the sum of all gold coins you've plundered plus 100 gold for each gem.
-Only the loot in possession of the party members on level 1 counts
-(the rest is considered MIA).
+Only the loot in possession of the party members on the current level
+counts (the rest of the party is considered MIA).
If all heroes die, your score is halved and only the treasure carried
by the last standing hero counts. You are free to start again
-from the first level, but all your wealth and items
-are gone and the spaceship and it's treasure look differently.
+from a different entrance to the spaceship, but all your previous wealth
+is gone and fresh, undaunted enemies bar your way.
View
4 README.md
@@ -18,8 +18,8 @@ automatically by Cabal from [Hackage] [4] as follows
cabal install Allure
-For a more current snapshot, install a matching recent snapshot
-of the LambdaHack library, download the game source from [github] [3]
+For a newer version, install a matching LambdaHack library snapshot
+from a development branch, download the game source from [github] [3]
and run 'cabal install' from the main directory.

0 comments on commit b7c8583

Please sign in to comment.
Something went wrong with that request. Please try again.