                            USERS GUIDE TO NAZGHUL

Nazghul is an old-school RPG clone modeled after those made in the heyday of
top-down, 2d tile-based graphics. It is specifically modeled after Ultima V, so
if you've played that game then this should be familiar.


                              INSTALLING THE GAME

If you downloaded a source distribution see the top-level INSTALL file.

If you downloaded a windows binary just unzip the distribution using Winzip or
similar.


                               STARTING THE GAME


On Linux/UNIX:

      $ haxima.sh

On Windows:

      Use the start menu or desktop icon

You can play the Tutorial first or jump right in with Start New Game.

                                SAVING THE GAME

When you quit the game with the Q)uit command (press 'q') it automatically
saves before it exits. The next time you start the game choose the "Journey
Onward" option from the main menu.

If you want to save a snapshot without quitting press Ctrl-s (S is for
"save"). If you want to revert back to that snapshot later press Ctrl-r. If you
want to quit without saving press Ctrl-q.

If you die, the game will pick up where you last saved. 

If you want to have more than one save file (there are legitimate reasons for
doing this in a beta release) I'll tell you a secret: save.scm is the save
file. You can make your own backup copies with different names. If you specify
the file-name to nazghul on the command line it will load it, for example:

     $ nazghul my-extra-bakup.scm


                                  ORIENTATION

If you're unfamiliar with U5 I recommend the Tutorial. Here are some more notes
to help you get started:

                                   Exploring

When you start you will have a party consisting of one character known as The
Wanderer. The icon for this character will be in the center of the map view on
the left. Explore around a bit using the arrow keys to move. Below the map
you'll see a little window with a prompt. This gives you hints when you're
entering commands to tell you what type of input the command wants. For
example, if you type 'x' (for e[x]amine) the command prompt will say:

    Xamine-<target>(ESC to exit)

Which means it wants you to hit the arrow keys and move the targeting
cursor. When you hit 'ESC' instead the command will cancel. Pretty much all
commands can be canceled by hitting 'ESC'.

To get a detailed explanation of where you are and what time it is, use the AT
command by pressing '@'. There is no clock in the game, so this is the only way
to tell time other than guesstimating from the position of the sun.

                                    Talking

You'll see your first NPC to the south. To talk to the NPC press 't' for
T)alk. This brings up a targeting crosshair. It might start out on the NPC or
on your character, it it's on you then move it to the NPC with the arrow keys
and hit enter. 

That starts a conversation. During conversation you enter a keyword and the NPC
will respond. For example, type NAME or JOB and see what this NPC says. When
you are done talking type 'bye' or hit enter by itself.

                                 Getting Stuff

Eventually you will want to follow the road down to the chamber on the lower
left. The chamber is marked by mysterious runes on its walls. Within the
chamber is a chest.

Walk over next to the chest and O)pen it by hitting 'o' and using your arrow
keys to indicate a direction. The chest will open and deposit a bunch of stuff
on the ground.

G)et the stuff using the 'g' key. Among the items will be some basic weapons,
armour and spell reagents as well as some scrolls and potions.

                                   Equipping

To see your stuff hit 'z' for Z)tats and scroll around. The left and right
arrow keys will switch between different status panes. Hit ESC when you tire of
admiring yourself and your loot.

To R)eady the weapons and armor hit 'r' then select them. Hit ESC when done.

                                 Mixing A Spell

To M)ix a heal spell type 'm', select Ginseng and Garlic, and hit ENTER to mix
them. You just made a "Mani" spell, a spell of minor healing. More on spells
later.

                          Entering and Exiting Towns

When you are ready to face the world walk to the edge of the map and bravely
step off. You will zoom out to Wilderness Mode, and your entire party (all one
of you) will appear as an icon in the center. To re-enter take a step south (at
which point you will see a shrine icon where you just were) and step north
again. Now you know how to enter and exit towns. Congrats.

When you enter a town, unless you have some enemies there, you will start out
in "follow mode", which means you control the party leader and everybody else
in the party tries to keep up. But if hostiles are in town you will be in
"character mode", which means you control each party member in turn. To switch
between these two mode use the 'f' key. This will make more sense when you add
more characters to your party.

IMPORTANT: when you eventually get somebody to join you, don't forget about
           Follow Mode (the 'f' key). It's much easier to have everybody follow
           your main dude around than to always individually control them.


                                USER INTERFACE

Astronomy Window

    Above the map you'll see a little window embedded in the frame which shows
    the position of the sun and two moons. It also shows the phase of the
    moons, which is important for moongate travel.

Wind

    Below the map, embedded in the frame, is the wind direction
    indicator. Currently the wind only affects ships. Tacking across the wind
    provides the best rate of travel, the wind at your back is second best, and
    heading into the wind is the worst. Note that this indicates the direction
    the wind is blowing _FROM_.

Command Prompt

    Unlike u4/u5/u6 the command prompt has its own window, just below the wind
    indicator. Interactive command prompts appear here, as well as the things
    the player says in conversation.

Status Window

    In the top right you have a general-purpose window for viewing and
    selecting lists of things. Normally it shows some basic party stats, but
    its contents change as required by user commands. For example, (R)eady will
    turn it into a selection list.

    Normally the window lists all the player's party members and shows their
    current hit points and status. The status is reflected in one or more
    letters following the hit points. The letters are codes:

    A...Alcohol (drunk)
    C...Charmed (in the service of an enemy)
    D...Diseased
    F...Fire immunity
    G...Good (no problem)
    I...Immune to poison
    L...Light (magically lit up)
    N...Invisible
    P...Poisoned
    S...Asleep
    T...Torchlight (carrying a torch)
    p...Protection (In Sanct)

Foogod Window

    It sounds sacreligious, but that's just my acronym for Food/Gold
    Window. This little window appears below the status window and shows the
    turn, food and gold counters as well as the current combat status and any
    pending Effects. The effects will be printed in cryptic little codes like
    "N" for magic negated. If you board a vehicle it will also show you the hit
    points for the vehicle. Here are some of the codes and what they mean:

    N...Magic negated (spellcasting fails)
    Q...Quicken (player party members get extra turns per round)
    T...Time Stopped

Console Window

    Finally on the right hand side you'll find the window where all the game
    messages get logged.


                                PLAYER COMMANDS


Here's your chance to let the sweat dry on your mouse - all commands are via
the keyboard. As it should be, forever and ever amen.

General syntax:

<dir>    = one of the four arrow keys
<member> = a party member, selected from a list by scrolling with the arrow
           keys and pressing <enter> or <space>
<item>   = an inventory item, selected from a list
<spell>  = a spell, selected from a list
<space>  = spacebar
<target> = a combat target, selected by moving the crosshairs and pressing
           <enter> or <space>
<*>      = varies depending on context

General commands:

    <dir>......................Move in that direction
    A)ttack-<dir>..............Initiate combat
    B)oard.....................Board/exit a vehicle like a ship or horse
    C)ast-<member>-<spell>-<*>...Cast a spell (the last argument depends on the
                               spell)
    E)nter.....................Enter a portal, including up or down ladders
    F)ire-<dir>................Fire vehicle's weapon (e.g., ship cannon)
    G)et-<dir>.................Get an object from the ground
    H)andle-<member>-<target>..Activate a switch or lever
    N)ew-order-<member>-<member>...Swap order of two party members
    O)pen-<dir>................Open a container or door
    Q)uit......................Quit & save the game
    R)eady-<member>-<item>.....Ready an armament like a weapon, shield, etc.
    S)earch-<dir>..............Look carefully
    T)alk-<target>.............Talk to an NPC
    U)se-<member>-<item>.......Use an item like a torch or potion
    X)amine-<target>...........Examine map files within view
    Z)tats.....................Show party stats like inventory, armaments, etc
    @)AT.......................Information about where the party is AT, etc
    <space>....................Pass one turn
    CTRL-Q)uit.................Quit without saving
    CTRL-S)ave.................Save a snapshot of the game w/o quitting
    CTRL-R)eload...............Reload the last snapshot

Wilderness-only commands:

    K)amp-<0-9/sunrise>-<y/n>-<player>
    ...........................Camp in the wilderness (to heal and recover 
                               mana) or aboard ship (to repair hull damage as 
                               well)

Town/Dungeon/Combat-only commands:

    A)ttack-<target>.........Attack the specified target
    C)ast-<spell>-<*>........Cast a spell
    F)ollow..................Select follow mode, where the party members
                             automatically follow the party leader.
    [1-9]....................Select a party member for solo mode.
    [0]......................Select turn-based party mode, where each party 
                             member takes directions one at a time.
    K)amp-<0-9/sunrise>......Sleep on a bed.  

Special commands:

    <ESC>....................Aborts most commands

Editing commands:

    CTRL-T)erraform..........Alter terrain. This deserves its own section. [1]
    CTRL-Z)oom...............Zoom in or out (like peering at a gem but free)


                                MOVEMENT MODES


Party Mode (wilderness)

    The party appears as a single icon in the center of the screen.

Follow Mode (town/combat/dungeons)

    You control the party leader and the other members follow the
    leader. Attacking a target will automatically switch to Round-Robin
    Mode. The party leader is always the top person in the list who is alive
    and still on the current map. Enter follow mode from Solo or Round Robin
    Mode by pressing 'f'.

Solo Mode (town/combat/dungeons)

    You control one party member while the others stand around looking
    bored. Enter Solo Mode by pressing the number key associated with the
    party member's order in the list. 1 is the first member in the list.

    NOTE: Solo mode can be very useful if one of your party members has greater
          passability then the others. For example, if a gazer joins your party
          he can float over water. Now imagine the possibilities if you get a
          ghost to join your party.

Round Robin Mode (town/combat/dungeons)

    You control each member in turn. This is the default mode when you enter
    combat. To enter Round Robin Mode from solo mode, press 0. To enter from
    Follow Mode press 'f'. Yes, confusing to have two methods. I'll fix it
    someday. Let me know if you have an opinion.



                                    PLACES


Wilderness:

    In the outdoor or wilderness map the party moves as a single unit. You can
    enter into combat with enemy NPC parties by moving into them or waiting for
    them to attack you. Likewise you can enter towns, dungeons or moongates by
    simply walking into them.

Wilderness Combat:

    This is a special temporary combat map that pops up when you engage an
    enemy NPC party in the wilderness. In this mode you control individual
    party members. You return to the wilderness map by having all of your
    living party members walk off the edge of the map. (Hint: if combat is over
    you can press <ESC> to quickly leave the map).

Towns/Dungeons:

    In towns and dungeons you move just like in combat mode. You can control
    the individual party members in turn, have one of them scout around in solo
    mode, or control the leader and have the other party members follow.



                                    COMBAT


What can I say? It's pretty much like u5. Try the flaming oil at night or in an
underground place. Oh, and watch out for gazers. They can charm you. Kill them
or charm them right away.



                                     MAGIC


The example game contains a full complement of spells. The magic system is
similar to Ultima 5 and Ultima 6: you select a spell by entering magic
syllables. A spell name is a combination of one to four syllables.

The syllables, spell names and reagent mixtures provided in the example game
are a direct ripoff of Ultima 5. If you don't have a u5 reference manual laying
around then the tables below will help:

                               Table 1: Reagents
============================================================================
Name           | Abbrev used in spell table
============================================================================
Black Pearl    | BP
Blood Moss     | BM
Garlic         | GA
Ginseng        | GI
Mandrake Root  | MR
Nightshade     | NI
Spider Silk    | SS
Sulphurous Ash | SA
============================================================================

                                Table 2: Spells
============================================================================
Syllables        | Effects        | Reagents               | Party/Combat
============================================================================
An Nox           | Cure Poison    | GI, GA                 | PC
An Zu            | Awaken         | GI, GA                 | PC
Grav Por         | Magic Missile  | SA, BP                 | C
In Lor           | Light          | SA                     | PC
Mani             | Heal           | GI, SS                 | PC
Wis Sanct        | Detect Trap    | SA                     | PC
An Sanct Ylem    | Disarm Trap    | BM                     | PC
----------------------------------------------------------------------------
An Sanct         | Unlock         | SA, BM                 | PC
An Xen Corp      | Repel Undead   | GA, SA                 | C
In Wis           | Locate         | NI                     | P
Kal Xen          | Summon Snakes  | SS, MA                 | C
Rel Hur          | Change Wind    | SA, BM                 | P
In Nox Por       | Poison Missile | NI, BM, BP             | C
----------------------------------------------------------------------------
In Flam Grav     | Fire Field     | SA, BP, SS             | C
In Zu Grav       | Sleep Field    | GI, BP, SS             | C
In Nox Grav      | Poison Field   | NI, BP, SS             | C
Vas Flam         | Fire Ball      | BP, SA                 | C
Vas Lor          | Great Light    | SA, MA                 | PC
----------------------------------------------------------------------------
An Grav          | Dispell Field  | BP, SA                 | PC
In Sanct Grav    | Energy Field   | MA, BP, SS             | C
In Sanct         | Protection     | SA, GI, GA             | PC
Wis Quas         | Reveal Hidden  | SS, NI                 | PC
Bet Por          | Blink (Caster) | BP, BM                 | C
----------------------------------------------------------------------------
In Ex Por        | Unlock Magic   | SA, BM                 | PC
An Ex Por        | Magic Lock     | SA, BM, GA             | PC
In Bet Xen       | Insect Swarm   | SS, BM, SA             | C
In Zu            | Sleep Field    | NI, SS, BP             | C
Vas Mani         | Great Heal     | GI, SS, MA             | PC
Rel Tym          | Quickness      | SA, BM, MA             | PC
----------------------------------------------------------------------------
An Xen Exe       | Charm          | BP, NI, SS             | C
In An            | Negate Magic   | GA, MA, SA             | C
In Vas Por Ylem  | Earthquake     | BM, MA, SA             | C
Quas An Wis      | Confuse        | MA, NI                 | C
Wis An Ylen      | Xray Vision    | MA, SA                 | PC
In Rel Por       | Telekinesis    | BP, BM, SS             | C
Vas Por          | Blink (Party)  | MA, BP, BM             | P
----------------------------------------------------------------------------
In Nox Hur       | Poison Wind    | NI, SA, BM             | C
In Quas Corp     | Fear           | NI, MA, GA             | C
In Quas Wis      | Peer           | NI, MA                 | PC
In Quas Xen      | Clone          | NI, MA, SA, SS, BM, GI | C
Sanct Lor        | Invisibility   | NI, MA, BM             | C
Xen Corp         | Kill           | NI, BP                 | C
----------------------------------------------------------------------------
An Tym           | Stop Time      | MA, GA, BM             | WC
In Flam Hur      | Flame Wind     | MA, SA, BM             | C
In Vas Grav Corp | Energy Wind    | MA, SA, NI             | C
In Mani Corp     | Resurrect      | GA, GI, SS, SA, BM, MA | PC
Kal Xen Corp     | Summon Undead  | SS, MA, NI             | C
Vas Rel Por      | Gate Travel    | SA, MA, BP             | P
============================================================================

[1] In Towns and Dungeons teleport spells that can move the party from one
    place to another will fail unless combat is over and the party is in Follow
    Mode.


                                   MONSTERS


                                 CONVERSATION


Start a conversation with an NPC with the T)alk command. During conversation
you type simple inquiries and the NPC responds, sometimes asking you a question
in return. Conversations with shopkeepers will allow you to buy and sell
items. Most NPCs respond to the 'NAME', 'JOB', and 'HEALTH' queries. Their
responses usually give you clues to further fruitful queries. Also, with the
special 'JOIN' query you can ask an NPC to join your party (some will join you,
and some will join you only if you do or say something that impresses
them).



                             APPENDIX: MAP HACKING

Like many games, "nazghul" is separated into an engine [2] and some data
files. In this case the data files are written in the Scheme programmming
language. If you examine the default start file 'session.scm' you will see that
it is a scheme file which loads the game types from other files and then
defines the starting game variables.

I encourage people to experiment with modifying the example files or even using
them as a basis to create their own games. The example script code is all
committed to the public domain. The image and sound files come from various
sources - see the COPYING file in the top nazghul directory for details on
where they came from.

If you want to make a proprietary game you may use the example script files,
but you will probably need to make your own image and sound resource files as
the ones in the examples directory come from other open-source or freeware
projects and their copyright holders might object to proprietary use.


--gmcnutt (gmcnutt@cableone.net)


FOOTNOTES

[1] Alas, there isn't one. Yet.

[2] I like to refer to it as a "kernel". This makes me feel like it is really
    cool, and like I'm not a loser since Linus Torvalds and I are about the
    same age and he works on a kernel, too.
