-_-_-_-_-_-_-_-_-_-_-_-_-_-_-_-_-_-_-_-__-_-_-_-_-_-_-_-_-_-_-_-_-_-_-_-_-_-_-_-

                              amuQuest v2 Readme

Note: This file is best viewed with a fixed-width font. To do this in Windows
      Notepad, open the "Format" or "View" menu, select "Font...", then
      "Courier", "Courier New", "Lucidia Console", or "Fixedsys".

                             --------------------

Table of Contents:
 Introduction
 Installation
 Starting amuQuest
  Windows (any)
  Linux/Unix/etc.
  Mac
 Playing amuQuest
 Winning
 More Help
 END

----------
 Introduction
----------
 First of all, I'd like to thank you for downloading amuQuest. It's my first
major project and I'm rather proud of and attached to it.
 amuQuest (the capitalization IS important, at least to me) is a text-based
adventure game in the tradition of Colossal Cave Adventure with one major
difference: no hard-coded world. Anyone can create, play, and distribute worlds
created for amuQuest. In fact, I'm counting on people to do just that. More
information on that >ZZ<.
 amuQuest is written in Java, a programming language developed by Sun. Thanks to
that, it _should_ run on any computer capable of surfing the internet. I don't
have the ability to test it widely, however, so feedback is appreciated. I have
run amuQuest on an old Pentium166 with 32MB of RAM which dual-boots Windows NT
and Linux. Most development was done on that PC as well. I now have an AMD
Turion 2GHz laptop with 4GB RAM running Windows Vista home premium. It also runs
amuQuest.

----------
 Installation
----------
 Step one is, of course, download the zip from solarshado.awardspace.com. Put it
somewhere convenient. Next you need to unzip it. Windows XP/Vista can do this
easily, just right-click the zip and pick "Extract All...".
 Earlier versions of Windows will need an un-zip program. There are many
options. I use 7zip (7zip.org).
 I believe most Linux distributions come with an unzip utility, try "man unzip"
from a terminal window for informaion.
 Mac users are on their own. I've never used a Mac, but the basic process is
the same: unzip to a convenient location.

----------
 Running amuQuest
----------
-----
 Windows (any)
-----
 Open the folder/directory that you unziped the files to, then open "runAQ".
You can make a shortcut to it if you want.

-----
 Linux/etc.
-----
 The same procedure as in Windows should work, except "runAQ" won't work. Try
clicking on "amuQuest.jar". If that does nothing. open a terminal window,
change into the directory and run "java -jar amuQuest,jar". If _that_ doesn't
work... post your error message on the forum and hope for the best.

-----
 Mac
-----
 Try both of the above methods and if neither work find someone who knows more
about Macs than you do or post on the forum.

----------
 Playing amuQuest
----------
 OK, you've installed and started amuQuest. You should be looking at this:

Welcome to the amuQuest Launcher.
1. Load tut1
2. Load tut2
0. Load <file>

Get used to this sort of menu, amuQuest uses them a lot. For now we'll go with
option 1, so type in "1" and press enter.

View [i]nfo or [l]oad?

What's this? Another menu? Yep. We're in a hurry to play so choose "load" by
tying the letter between the []s (l) and then enter.

Load character?

At this point, you don't have a character to load, so answer "no".

Welcome To AmuQuest v2
created by SolarShado
Questions, comments, and bug reports to solarshado@live.com
Please answer the following questions to create a character to play as.
Name:

Now we're getting to the meat (or...soy? if you're a vegetarian?)! Your
character needs a name, so give it one. I'll use "Jon Doe".

You can include a short description of yourself here, if you wish.
Bio:

This doesn't really do anything, but it's there. Later, I'll include a program
for viewing your saved players. I'll leave mine blank.

(1)Male (2)Female

This also does nothing, at least for now. I'll pick male.

Enter "y" to accept, anything else to create another
HP : 18 Spd: 10
Atk: 10 Mag: 8
Def: 9  Res: 7
Str: 10 Brains: 7

Your numbers will be different. Here you can generate characters. The stats
are random and you can accept the first one or keep going till you get one with
high stats. When you accept you will get this:

You are at the mouth of a cave which runs north in to a mountain.
A sign reads: "Welcome to Tut Cave."

There is a defense potion here.

:-?

The first 2 lines tell you about where you are. The "There is a..." line lets
you know that there is an item here that you can get. The ":-?" is the prompt.
It lets you know that amuQuest is waiting for you to tell it what to do.
 There you have it. From here, you can start exploring. Type help for a short
list of commands.

----------
 Winning
----------
 The best part. Winning. To win a game of amuQuest, you have to find and put on
the "amulet of power". So the name's a little lame. I'm not Shakespeare.

----------
 More Help
----------
 If you want more info, head to solarshado.awardspace.com/aq. I'll post a more
thourough manual there. You might want to head over to the forums, too.
Hopefully someone will make another quest...

----------
 END
----------
 Have fun!