view xrogue/README.TXT @ 238:e1cd27c5464f

arogue7, xrogue: improve the handling of the arguments to fuses. fuse() now expects a pointer as the argument to a fuse function. If this is one of the functions that takes int, fuse() follows the pointer and stores that value in the f_list slot, in the integer field of the argument union. When the fuse goes off, do_fuses() recognizes the function and passes it the integer field instead of the pointer. This has the disadvantage of hard-coding the functions that require int in daemon.c, but since the int is copied into f_list, it no longer has to be in static or global memory, which simplifies several files.
author John "Elwin" Edwards
date Fri, 11 Mar 2016 17:40:00 -0500
parents e6179860cb76
children
line wrap: on
line source

    Welcome to XRogue
    http://roguelike.sourceforge.net/xrogue

    XRogue: Expeditions into the Dungeons of Doom
    Copyright (C) 1991 Robert Pietkivitch
    All rights reserved.
    
    Based on "Advanced Rogue"
    Copyright (C) 1984, 1985 Michael Morgan, Ken Dalka and AT&T
    All rights reserved.

    Based on "Rogue: Exploring the Dungeons of Doom"
    Copyright (C) 1980, 1981 Michael Toy, Ken Arnold and Glenn Wichman
    All rights reserved.
    
    See the file LICENSE.TXT for full copyright and licensing information.


XRogue: Expeditions into the Dungeons of Doom
---------------------------------------------

Introduction:

Rogue was introduced at the University of California at Berkeley as a
screen-oriented fantasy game.  The game had 26 types of monsters that
the player could meet while exploring a Dungeon generated by the computer.
Scrolls, potions, rings, wands, staves, armor, and weapons helped the
player to battle these monsters and to gain gold, the basis for scoring.

The version of rogue described in this guide has been expanded to include
over 200 monsters with many new capabilities and has been renamed xrogue.
Many of the monsters are intelligent and they, like the player, must avoid
traps and decide when it is better to fight or to run.  There are also a
number of new commands in this version not found in previous versions.

The game contains monsters, spells, weapons, armor, potions, and other
magical items that you will discover during your quest.  The Dungeon's
geography changes with every game and although many magical items have
certain identifiable properties, such as turning the player invisible,
the physical manifestation of the magic changes each game.  A red potion,
for example, will cause the same reaction throughout a given game but
it may be a completely different potion in a new game.

Entering the Dungeon with only a little food, armor, and a weapon, the
player must develop a good strategy of when to fight, when to run, and
how to best use any magical item found in the Dungeon.  To make things
interesting the player has a quest to return one of several unique and
magical artifacts which are rumored to lie deep within the Dungeon.
Returning with this artifact to the surface brings great honor.

However, after finding the artifact, the player may wish to continue
his quest deeper into the Dungeon to match wits with an arch-devil, a
demon-prince, or perhaps Charon the Boatman.  Defeating such a creature
will gain the player many experience points which is the basis for
scoring in xrogue.  It is very difficult to return from the Dungeons
of Doom alive.  Very few players have won this game.

Character Classes:

Before placing the player in the Dungeon, the game requests that you
select what type of character they would like to be: Fighter, Paladin,
Ranger, Magic-User, Cleric, Thief, Assassin, Druid, or Monk.

    The Fighter

A Fighter has the best odds at winning battles with monsters.  At high
experience levels, the Fighter is able to attack his opponent multiple
times in a single turn.  Strength is the main attribute of the Fighter.

    The Magic-User

A Magic-User is able to cast spells.  Intelligence is the main attribute.
The number of spells a Magic-User can cast increases as he gains in
experience points and in intelligence.  His spell casting ability allows
him to identify any item in the Dungeon.  16 spells.

    The Cleric

A Cleric is able to pray for assistance in battle.  Wisdom is the main
attribute.  The number of prayers granted to the Cleric increases as he
gains in experience points and in wisdom.  Clerics can affect (turn) the
undead monsters to avoid battle.  Ie., zombies, ghouls, etc.  If the
Cleric is very powerful relative to the undead monster, turning it will
utterly destroy it.  16 prayers.

    The Paladin

A Paladin is a type of holy warrior, being a cross between a Cleric
and a Fighter.  He is able to pray and affect the undead like the Cleric
and fight like the Fighter, but both to a lesser extent.  He is on the
side of all that is righteous and good and would never attack a monster
that has not attacked him first.  If he happens to kill such a monster,
inadvertantly or otherwise, he will begin to feel increasingly uneasy.
If he kills too many such monsters, he will face karmic retaliation and
be reduced to a mere Fighter, minus all of the Cleric's ability.
Charisma is the main attribute with Wisdom second.

    The Ranger

A Ranger is a type of mystical warrior, being a cross between the
Magic-User and Fighter.  Like the Paladin, he is on the side of all
that is righteous and good and would never attack a monster that
has not attacked him first.  A Ranger is able to cast spells like the
Magic-User and fight like the Fighter, but both to a lesser extent.
Charisma is the main attribute with Intelligence second.

    The Thief

A Thief is exceptionally dexterous and has great skill at being able
to set a traps for and/or rob (steal) items from monsters.  Thieves have
the ability to detect all the gold and hidden traps on each level of
the Dungeon.  Their dexterous nature gives Thieves the ability to move
very quietly, so they are not as likely as to wake up sleeping monsters
as are the other character types.  If a Thief manages to sneak up on a
creature without waking it he may be able to backstab the monster.  The
damage from a backstab is greatly increased based upon the experience
level.  Dexterity is the main attribute.

    The Assassin

An Assassin is a person trained in the art of killing monsters by
surprise.  He has some of the abilities of the Thief, but he cannot
sense traps or backstab.  Instead, the Assassin has the chance to kill
an opponent outright with one deadly blow.  He can recognize and use
poison found in the Dungeon on his weapon, thereby, making his next
attack exceptionally lethal.  Dexterity is the main attribute.

    The Druid

A Druid is a type of magical warrior, being a cross between the Cleric
and the Magic-User.  A Druid can chant both spells and prayers plus a
few of his own.  The number of chants available to the Druid increases
as he gains in experience points and in Wisdom.  Wisdom is the main
attribute.  16 chants.

    The Monk

A Monk is trained in the martial arts.  He wears no armor and does not
need a weapon (although using them is not forbidden).  As the Monk gains
in experience points his natural defense or ability to dodge attackers
increases.  The Mong is a cross between the Druid and Fighter, so he
can chant and also fight like the Fighter, but both to a lesser extent.
Constitution is the main attribute, with wisdom second.

Attributes Of The Charaters:

Strength - The primary attribute for encumberance.

Intelligence - The primary attribute for casting spells.

Wisdom - The primary attribute for prayers and chanting.

Dexterity - The primary attribute for stealthiness.

Charisma - The primary attribute for good will.  High Charisma also
           affects the cost of objects when making transactions.

Constitution - The primary attribute for health.  High Constitution
               affects the amount of hit points you receive when
               moving up in experience levels.

Note: The Ranger, Paladin, and Monk do not receive their "special"
magical abilities until they have advanced a few experience levels.

Experience Levels:

Characters gain experience points mostly from killing monsters.  Other
actions, such as stealing items from monsters, backstabbing, and turning
monsters, also add extra experience points.  Each character type gains
experience points and moves up in experience levels at different rates.
Moving up in experience levels adds extra hit points to the character
which determines how many "hits" he can take before being killed.

Allocating Attribute Points To The Characters:

A player starts with 75 attribute points to distribute in to the character
he has chosen to play.  When you are prompted to distribute the attribute
points, the screen displays the minimum and maximum allowable values for
that particular attribute.  The player can type a backspace (Ctrl-H) to go
back and change a previous value and typing an escape (ESC) sets all the
remaining attributes to the maximum value possible, given the number of
remaining attribute points to be distributed.

THE SCREEN

During the normal course of play, the screen consists of three separate
sections:  the top line, the bottom two lines, and the remaining screen
in the middle.  The top line reports actions which occur during the game,
the middle section depicts the Dungeon, and the bottom two lines describe
the player's current condition.

Whenever anything happens to the player, such as finding a scroll, hitting
a monster, or being hit by a monster, a short report appears on the top
line of the screen.  When you see the word 'More' on the top line, that
means you must press the space key to continue.

The following items may be found within the Dungeon. Some of them have
more than one interpretation, depending upon whether your character
recognizes them or not.

|  A wall of a room.
-  A wall of a room.
*  A pile of gold.
%  A way to another level.
+  A doorway.
.  The floor in a room.
#  The floor in a passageway.
    Solid rock (denoted by a space).
^  The entrance to a Trading Post
@  The player.
_  The player, when invisible.
:  Some food.
!  A flask containing a potion.
?  A sealed scroll.
=  A ring.
)  A weapon.
]  Some armor.
;  A miscellaneous magic item
,  An artifact
/  A wand or a staff.
 >  A trapdoor leading to the next level
{  An arrow trap
$  A sleeping gas trap
}  A beartrap
~  A trap that teleports you somewhere else
`  A poison dart trap
"  A shimmering magic pool
'  An entrance to a maze
$  Any magical item. (During magic detection)
 >  A blessed magical item. (During magic detection)
<  A cursed magical item. (During magic detection)

Monsters are depicted as letters of the alphabet.  Note that all letters
denote multiple monsters, depending on which level of the Dungeon you are
on.  The player may identify a current monster by using the identify
command ('/') or the clarify command ('=').

The bottom two lines of the screen describe the player's current status.
The first line gives the player's characteristics:

Intelligence, Strength, Wisdom, Dexterity, Charisma, and Constitution
all have a normal maximum value of 50 points, but they can go higher if
augmented by a ring.  Encumberance is a measurement of how much the player
can carry versus how much he is currently carrying. The more you carry
relative to your maximum encumberance causes you to use more food.  The
attribute of Strength fortifies one's encumberance.

The player's current number of hit points are denoted as (Hp) and it is
followed in parentheses by the player's current maximum hit points.  Hit
points express the player's survivability.  As a player heals by resting,
using potions, or spells, the player's current hit points gradually increase
until they reach the current maximum.  This maximum number will be increased
each time a player goes up an experience level.  If the player's current hit
points reach 0, the player becomes "metabolically challenged".

The player's armor class is denoted as (Ac).  This number describes the
amount of protection provided by the armor, cloaks, and/or rings currently
worn by the player. It is also affected by high or low dexterity.  Wearing
no armor is equivalent to an armor class of 10 (Monk excepted).  The lower
the armor class number, the better.

The player's current experience level is denoted as (Exp), followed by
the player's experience points.  A new experience level brings extra hit
points and possibly added abilities, such as new spells for a Magic-user,
new prayers for a Cleric, and new chants for a Druid.  There are a total
of 26 experience levels per character.

Commands:

A player can invoke most commands by typing in a single character.
Some commands, however, require a direction, in which case the player
types the command character followed by a directional letter.  Many
commands can be prefaced by a number, indicating how many times the
command should be executed.

When the player invokes a command referring to an item in the player's
pack (such as reading a scroll), the game prompts for the item.  The
player can then type the letter associated with the item.  Typing a '*'
will produce a list of eligible items.

A list of basic games commands:

?  Preceding a command by a '?' produces a brief explanation of the
    command.  The command '?*' gives an explanation of all the commands.
    A '?@' gives information on things you encounter (rock, forest, etc).
/  Preceding a symbol by a '/' identifies the symbol.
=  Clarify.  After typing an '=' sign, the player can use the movement
    keys to position the cursor anywhere on the current level.  As long
    as the player can normally see the selected position, the game will
    identify whatever is there.
h  Move one position to the left.
j  Move one position down.
k  Move one position up.
l  Move one position to the right.
y  Move one position to the top left.
u  Move one position to the top right.
b  Move one position to the bottom left.
n  Move one position to the bottom right.
H  Run to the left until reaching something interesting.
J  Run down until reaching something interesting.
K  Run up until reaching something interesting.
L  Run to the right until reaching something interesting.
Y  Run to the top left until reaching something interesting.
U  Run to the top right until reaching something interesting.
B  Run to the bottom left until reaching something interesting.
N  Run to the bottom right until reaching something interesting.

 >  Go down the stairs to the next level or enter the outer region if you
    are standing upon the wormhole trap (must be "flying" for this to work).
<  Go up the stairs to the next level or enter the outer region if you are
    standing upon the wormhole trap (must be "flying" for this to work).

*  Count the gold in the player's pack.
!  Escape to the shell level.
$  Price an item at the Trading Post.
#  Buy an item at the Trading Post.
%  Sell an item at the Trading Post.
.  This command (a period) causes the player to rest one turn.
^  This command sets traps and is limited to Thieves and Assassins.  If the
    command is successful the game will ask the player for the trap type and
    sets it where the player is standing.
a  Affect the undead.  This command is restricted to Clerics and Paladins
    and must be followed by a directional letter.
A  Choose your quest item (at game startup only!).
c  This command is restricted to Druids and Monks and it produces a list of
    available chants.  The player can select one of the displayed chants and
    if the player's energy level is sufficiently high, "chant" it.  The more
    complicated the spell, the more energy it will take.
C  This command is restricted to Magic-Users and Rangers and it produces a
    list of available spells.  The player can select one of the displayed
    spells and if the player's energy level is sufficiently high, "cast" it.
    The more complicated the spell, the more energy it will take.
d  Drop an item from the player's pack.
D  Dip something into a magic pool.
e  Eat some food from the player's pack.
f  When this command is preceded with a directional command, the player will
    move in the specified direction until he crosses something interesting.
F  Frighten a monster.  Not available to all characters.  This command
    loses it's power at around level 10.
g  Give away or trade a slime-mold for food with a monster.
G  This command is restricted to Thieves and Assassins.  It causes the game
    to display all of the gold on the current level.
i  Display an inventory of the player's pack.
I  This command prompts for an item from the player's pack and displays
    the inventory information for that item.
m  When the player types this command, you are prompted to mark an item
    with a one-line name.
o  Typing this command causes the game to display all the settable options.
    The player can then examine them or change (some of) them
O  Display your current character type and quest item.
p  This command is restricted to Clerics and Paladins and it produces a
    list of available prayers.  The player can then select one of the
    displayed prayers and if the player's energy level is sufficiently high,
    "pray" it.  The more complicated the prayer, the more energy it will 
take.
P  Pick up the items currently under the player.
q  Quaff a potion from the player's pack.
Q  Quit without saving the game.
r  Read a scroll from the player's pack.
s  Search for a secret door or a trap in the circle surrounding the player.
S  Save your game to play at a later time.
t  This command prompts for an object from the players pack.  The player
    then can throw the object in the specified direction.
T  Take off whatever the player is wearing.
v  Print the current xrogue version number.
w  Wield a weapon from the player's pack.
W  Wear some armor, ring, or a miscellaneous magic item from the player's
    pack.  The player can wear a maximum of 8 rings.
X  This command is restricted to Thieves only.  It causes the game to 
display
    all of the hidden traps on the current level.
z  This command prompts for a wand or staff from the player's pack and zaps
    it in the specified direction.
+  Fortune cookie! (Note: if you play xrogue over a modem, typing three
    consecutive '+' will tell your modem to enter "command" mode.  See your
    modem manual on how to return from this mode).

Escape  Pressing the Escape key will cancel the current command.
Ctrl-B  Check your current score.  Scoring is based on experience points
         and gold.  However, gold is not that important and 10% is hacked
         off if a player is killed.
Ctrl-E  Check your current food level.  This command is used when you want
         to see just how much food you have remaining in your stomach.  A
         full stomach is measured to be about 2000(2100).  As you play the
         game, this level drops until you become hungry at about 200(2100).
         A food level over 2000(2100) makes the character satiated, and a
         level under 200(2100) makes the character hungry, then weak, and
         finally fainting.  A level of 2000(2100) is the most the character
         can eat, a full, satisfied stomach!
Ctrl-L  Redraw the screen.
Ctrl-N  When the player types this command, the game prompts you to type a
         one-line name for a monster or for an item in the player's pack
         To name a monster, position the cursor over the desired monster and
         rename it.
Ctrl-O  Display the current "affects" on the player (such as slow, phased,
         confused, extra sight, flying, dancing, etc.).
Ctrl-R  Repeat last message displayed on the top line of the screen.
Ctrl-T  This command is restricted to Thieves and Assassins.  It must be
         followed by a directional letter.  If a monster is standing next to
         the player in the specified direction, the effect is to steal an
         item from the monster's pack.  If successful, the monster does not
         notice anything, but if the player is unsuccessful, there is a 
chance
         the monster will suddenly wake up and attack.
Ctrl-U  Use a magic item in the player's pack.

There is no explicit attack command.  If a player wishes to do battle with a
monster, the player simply moves onto the spot where the monster is 
standing.
Whatever the player is wielding will be used as the player's weapon.

As the player moves across items, the game automatically picks them up and
places them into the player's pack.  If there is no room left in the pack,
the item is left on the floor.  Setting the "pickup" option to "NO" will
allow the player to pick up items at will using the 'P' command.

All actions except for bookkeeping commands, such as taking an inventory,
take time.  The amount of time varies with the command.  Swinging a weapon,
for example, takes more time than simply moving; so a monster could move
several spaces in the time it takes the player to make one attack.  The
time it takes to swing a weapon also varies based on the bulk of the weapon,
and the time it takes to simply move one space varies with the type of armor
worn and the player's level of encumberance.  Movement is always faster when
the player is "flying".

Actions also take time and some of them can be disrupted.  If the player is
casting a spell for example, and gets hit before finishing it, the spell is
lost.  Similarly, the player might choke if hit while trying to eat.  These
same rules apply to monsters as well.

Some of the rooms in the Dungeon possess a natural light source.  In most
other rooms and in corridors, the player can see only those things within
a one-space radius around the player.  Dark rooms can be lit with magical
light or by fire beetles and other monsters.

The player can wield only one weapon at a time.  When a player attacks
a monster, the amount of damage depends on the particular weapon he is
wielding.  To fire a projectile weapon, such as a crossbow or a short bow,
the player should wield the bow and throw the bolt or arrow at the monster.

A weapon may be cursed or blessed which will affect the likelihood of you
hitting a monster with it and the damage that it will inflict on the 
monster.
If the player has identified the weapon he is using, the "to hit" and the
"to damage" bonuses appear (in that order) before the weapons name in the
inventory listing.  A positive bonus indicates a blessed weapon, and a
negative bonus usually indicates a cursed or misguided weapon.  A player
cannot release a cursed weapon until a remove curse scroll is read or cast
by magical means.

After the player has identified a suit of armor, the protection bonus 
appears
before the armors name in the inventory listing.  If the bonus is positive
the armor is blessed but if it is negative, the armor is probably cursed.
The player cannot remove a cursed suit of armor until a remove curse scroll
is read or cast by magical means.

Some monsters can corrode your armor!  If such a monster hits a player
when the player is wearing metal armor, the armor will lose some of its
protective value.  This same corrosive property also applies to weapons
when a player hits a monster with this ability.  Search for a scroll of
"protection" to guard against corrosion of your armor and weapon.

A player will find many potions and scrolls in the Dungeon.  Reading a
scroll or quaffing a potion will usually cause some magical occurrence.
Potions and scrolls may be either cursed or blessed.  In this version of
xrogue, Monster Confusion scrolls will turn your hands a variety of colors.
A blessed Magic Mapping scroll shows very detailed maps.  A scroll of
Genocide works within the dungeon as well as in the outer region.  A
scroll of blessed Teleportation will teleport you "upward" a few levels.
Blessed Remove Curse will cause certain monsters to panic if the scroll
is read near them.  Charm Monster will let you charm several monsters.

The player can wear a maximum of eight rings.  Some of them have a magical
effect on the player as long as they are worn.  Some rings also speed up
the player's metabolism, making the player require food more often.  Rings
can be cursed or blessed and the player cannot remove a cursed ring until
a remove curse scroll is read or cast.

Wands, rods, and staves help a player in battle and affect the Dungeon.
A player uses the "z" (zap) command to use a wand either to shoot at a
monster, teleport, or to light up a dark room.  Wands can be cursed or
blessed.

A player must be frugal with his food.  Both moving and searching through
the Dungeon, and fighting monsters, consumes energy.  Starving results in
the player's fainting for increasingly longer periods of time, during which
any nearby monster can attack the player at will.  Food comes in the form
of standard rations and as a variety of berries.  Some berries have side
effects in addition to satisfying one's hunger.  Slime-Molds are monster
food and if you have one, you may be able to trade it for a regular food
ration, if the monster is of "friendly" persuasion.

Gold has a couple of uses in the Dungeon.  The first use of gold is to buy
things, either at a Trading Post or from a Quartermaster.  The Trading Post
when found, is entered via the '>' command, like going down a stairway.
A Quartermaster ('q') is a Dungeon vendor who appears at certain times and
will try to sell the player some of his wares.  The Quartermaster's wares
are never cursed but they can be blessed, though blessed goods do cost more
than normal goods.  If the player chooses to buy something offered by a
Quartermaster, he will make the transaction for the specified amount of gold
and then disappear.  Attacking a Quartermaster causes him to vanish in
haste!  You can sometimes find gold at the bottom of "magic pools".  Use
the ">" command to dive for the gold, but be careful you don't drown!

When beginning a new game, a player is placed in the Trading Post with
an allotment of gold based upon the type of character chosen to play.
There are some restrictions on the use of certain items by character.
For example, only Fighters, Paladins, and Rangers can wield two-handed
swords while Thieves and Assassins can not wear certain types of armor.
However, the Trading Post (and Quartermaster) will happily sell a player
anything that he can afford, whether you need it or not.

Miscellaneous magical items such as a Pair of Boots or a Book are numerous
within the Dungeon.  These items are usually used to a player's advantage,
assuming they are not cursed.  Some of these items can be worn, such as a
Cloak, while others are to be used, such as a Book, Beaker, or Ointment.
The Medicine Crystal will heal you, remove all curses, heal you, and may
cause panic in some monsters.

There are a number of unique monsters deep within the depths of the Dungeon
that carry very special magical items or artifacts.  When you begin the 
game,
you are asked to choose a "quest item" to retrieve from the Dungeon.  Most
of these items can be used to the player's advantage, even if they are not
one's own personal quest item during the game.  However, care must be taken
when handling some of them for they have intelligence and some will reject
mishandling or abuse.  These items consume your food (and your gold) so
carrying them around results in increased food use.  Some of these items 
will
kill you outright if you happen to pick them up while wielding another
artifact as your weapon.  Don't be too greedy with the artifacts!  Quest
items begin appearing in xrogue between levels 40-50.  The less traumatic
quest items appear earlier while the more severe ones appear later.  Once
a unique monster is killed, you will not encounter another one like it in
the Dungeon.

A variety of traps exist within the Dungeon, including trap doors, bear
traps, and sleeping traps.  Sometimes they are hidden from sight until
sprung by a monster or by the player.  A sprung trap continues to function,
but since it is visible, an intelligent monster is not likely to tread on 
it.
A trap called the Wormhole trap, will transport you to the "outer region"
of the dungeon.  There you will fight strange dinosaurs until you can make
your way back to a starwell, and promptly return from whence you came.

Each monster except for the Quartermaster appears in a limited range of
Dungeon levels.  All monsters of the same type share the same abilities.
All giant rats, for example, can give the player a disease, and all
jackalweres can put the player to sleep.  Monsters of the same type will
vary however, in strength and intelligence.  For example, one kobold may
be much more difficult to kill off than another.  In general, the more
difficult it is to kill a monster, the more experience points the monster
is worth.

Most monsters attack by biting and clawing, but some monsters carry weapons
and can use their breath as a weapon.  Some monsters can even use magical
items, such as wands and artifacts.  Monsters with distance weapons or magic
can sometimes attack a player from across a room or from down a corridor.

Some monsters are more intelligent than others, and the more intelligent
a monster is, the more likely it will run away if it is about to die.
A fleeing monster will not attack the player unless it is cornered.

It is sometimes possible to enlist a monster's aid.  Reading a charm monster
scroll, for example, or singing a charm monster chants can make a monster
believe that the player is its friend.  A charmed monster will fight hostile
monsters for the player as long as they are not of its own race.  Be sure
your charmed monsters are in the same room with you when you enter the next
level, or they will be lost.

Options:

The game has several options, some of which can only be set by the player
at the beginning of the game and others during the course of play.

      default - Play the character with "default" attribute settings.
        terse - Shorten messages at top of screen.
         jump - Speed up the display of the player's movement
         step - Lists all inventories one line at a time.
      overlay - Allows listings of inventories to overlay the currnt screen.
        flush - Supposed to flush all typed-ahead characters.
        askme - Prompt the player to name new types of scrolls, potions, 
etc.
       pickup - Pick up items automatically as you move across them
         name - The player's name.
         file - Saved game filename.  Defaults to xrogue.sav.
        score - Identifies the location of the game scorefile.
         type - Specifies the character type (unchangable).
quested item - Set at start up (unchangeable).

A player can set the game options at the beginning of a game via the
ROGUEOPTS environment variable.

Some examples:

  ROGUEOPTS="default nopickup, nooverlay, name=Corwin, class=magician"
  ROGUEOPTS="pickup, overlay, file=xrg.sav, score=/home/games/scorefile"

The player may change an option at any time during the game via the 'o'
(option) command.  On the options menu, typing a new value changes the
option and a RETURN moves to the next option in the list.  Typing an '-'
moves you to the previous option and an ESCAPE returns you to the Dungeon.

A new option called "default" was added in xrogue.  When you put the word
"default" into your ROGUEOPTS environment variable your character will be
created with "default" attribute settings, armor, weapon, quest item, and
some food.

Setting "default" will force the game to skip over the beginning screen
where you can choose/distribute your attribute points and it also skips
over the beginning "equippage screen" where you can choose your armor,
weapon, quest item, and etc.

If you use the "class" option with "default" in ROGUEOPTS, you will
start the game immediately at level 1 with the default selections
for your character.

Here is a list of the main and secondary attributes, special ability,
and quest item ("default" settings) for each character type:

  Character Main Attr.    Secondary     Specialties       Def. Quest Item
  -------------------------------------------------------------------------
  Fighter   strength      constitution  sense gold        Axe of Aklad
  Ranger    charisma      intelligence  cast spells       Mandolin of Brian
  Paladin   charisma      wisdom        affect undead     Ankh of Heil
  Cleric    wisdom        dexterity     prayer spells     Horn of Geryon
  Magician  intelligence  dexterity     cast spells       Stonebones Amulet
  Thief     dexterity     strength      sense traps       Musty Daggers
  Assassin  dexterity     strength      steal/use poison  Eye of Vecna
  Druid     wisdom        dexterity     chant spells      Quill of Nagrom
  Monk      constitution  dexterity     chant spells      Emori Cloak

A different quest item may be chosen ONLY while you are in the beginning
Trading Post (if you have NOT set the "default" option via ROGUEOPTS).

When a player is killed, his score will be equal to the amount of his
experience points gained, plus his gold (minus 10%).  A player that
quits the game will not lose 10% of his gold.  If a player makes it back
up and out of the Dungeon alive, his score will be equal to the amount
of experience points, plus the gold, plus additional gold received from
selling all of the items in his pack.

The game maintains a top-twenty player scorefile.  As an installation
option, the game may be compiled so as to record only three entries per
character type and name.