WHAT IS CROSSFIRE?

  This is a multiplayer graphical arcade and adventure game made for
  the X-Windows environment.
  It has certain flavours from other games, especially Gauntlet (TM)
  and Nethack/Moria.
  Any number of players can move around in their own window, finding
  and using items and battle monsters.  They can choose to cooperate
  or compete in the same "world".

REQUIREMENTS

  You will need UNIX, X-windows and an ANSI C compiler to compile this game.

COMPILING

  The program has been known, at various times, to compile on
  o Sun3 and Sun4 with SunOS 4.1.1
  o DEC 3100 and DEC 5000 with ULTRIX BSD 4.2
  o DEC with OSF1
  o DEC300AXP-500 (Alpha with OSF1)
  o VAX3100 with BSD 4.3
  o IBM RT with BSD4.3
  o IBM RS/6000 with AIX
  o HP9000-series (HP-UX) (very old versions of HP-UX might barf on stdarg.h)
  o MIPS with RISC/os
  o (UMIPS) 4.52 (?)
  o IBM-PC compatibles with Linux

  It has been compiled with X11R3, X11R4 and X11R5.

  To compile, first change the CBinDir, CFontDir and CLibDir variables in
  config/crosssite.def to reflect where you intend to install Crossfire and
  its fonts.  ClibDir is where you want to store your maps, highscores,
  treausres, motd and archetype file (note that it's called LIBDIR in
  the config.h file).
  Read through the rest of crosssite.def to see if anything else needs
  changing.
  You can look at config/madhatter-site.def for another example of how to
  make a site-definition file.

  Once you get done editing crosssite.def, you can copy it to
  $(TOP)/.., e.g. the same directory you put the crossfire-version directory
  in.  You will then not have to re-edit the file every time you get a 
  new version of crossfire.

  Then have a look at include/config.h and see if there is anything
  you want to change.  It is a good idea, though, to first try to
  compile without changing much there, since all combinations
  of defines haven't been tested.  You can always go back and change
  things and recompile...

  Remember that all directories leading to FONTDIR must be world-readable,
  as well as the files in it.

  NOTE: ALL FILEPATHS MUST BE ABSOLUTE (must start with /).

  If your local c-compilator doesn't unserstand ANSI-C, then change
  forceCC in config/crosssite.def to an ansi-compilator (for instance
  gcc -ansi).

  You should then type xmkmf or xmkmf.ansi if you have that (HPux only?).

  If you lack xmkmf, try "imake -DUseInstalled -I/usr/lib/X11/config".
  You might have to search on your system to find the exact location
  of the config directory.  If you don't have imake in your path, then
  find where it is and add that directory to your path.

  Then type "make" (and "make install" if you undefined AutoInstall
  in crosssite.def).

  To compile you will need from 3Mb to 5Mb of free space on the filesystem.

  Now, being a pessimist, I expect you get tons of error messages.
  See REPORTING BUGS for information on how to report these bugs.
  They might actually get fixed if someone just tells me about them 8)

INSTALLING

  I have only used crossfire with the set-group-id bit set, leaving
  the LIBDIR and PLAYERDIR writable for that group.
  I've heard rumours that set-user-id also works.

  You will need maps to play this game.  You can get maps from
  ftp.ifi.uio.no in the /pub/crossfire directory (or look below
  to find other ftp-sites nearer you).
  Remember to check that the maps don't have a newer version than
  your version of crossfire.
  
  If you have installed older versions earlier, remember to use the
  _new_ archetype and treasure files and the _new_ fonts!
  This is a _very_ common error.

  You can compress all files in and below the LIBDIR.  It is recommended
  that you leave at least the "maps" and "highscore" file uncompressed.

  It might be useful to edit "lib/motd" (MessageOfToDay) file.

USAGE

  There are several ways of playing this game, and they depend on
  wheter or not you defined SERVER in inlucde/config.h.

  If you commented it out, you can only play by running crossfire.
  Type "crossfire <any options> <display 2> <display3> <etc>" to play.
  The first display defaults to your DISPLAY environment variable
  unless you specify the -l option.

  If you left it defined, you can alternatively play by starting
  crossfire as a server in the background; type: "crossfire -server".
  Then you can use "crossclient" to connect to the game.  If you
  are running the server on a different computer than the one you're
  sitting on, then run crossclient on your local computer, and specify
  the server with the "-server <host>" option.  Also try
  "crossclient -c sc".
  You can also use the "crossloop" shell script which restart the
  server in case it crashes, and which logs output to /tmp/crosservlog.

  If crossfire can't find the font "crossfire", and failed to set the
  fontpath to FONTDIR, it will try to use pixmaps instead.  This means
  that it will read all the files in the LIBDIR/bitmaps/ directory,
  which will usually take quite a while.

  Type "crossfire -h" / "crossclient -h" or read the man-page for
  information about the other options.

  New players can also be added by typing 'add <display> once inside the game.
  (Though it's recommended that they use crossclient to add themselves)

MAILING LIST

  There are two mailing-lists dedicated to the developement and
  bug-testing of crossfire.  The first is for discussing bugs and
  features, the second is for announcing new versions.

  If you want to join or leave any of the lists, send mail to
  crossfire-request@ifi.uio.no with the subject "subscribe",
  "unsubscribe","subscribe announce" or "unsubscribe announce".
  If you use the subject "subscribe" or "unsubscribe" you will
  (un)subscribe to *both* lists.
  To send messages directly to the list, mail crossfire@ifi.uio.no.
  An archive of old messages can be found at ftp.ifi.uio.no in the
  file /pub/crossfire/crossfire.mail.Z

FTP SITES

  FTP-sites where you can look for the latest versions are:

    ftp.ifi.uio.no:/pub/crossfire (129.240.64.2)
    ftp.world.net:/pub/crossfire (192.243.32.18)
    yoyo.cc.monash.edu.au:/pub/crossfire (130.194.9.1)

  Please use the one nearest to you.  ".no" in Europe, ".au" in Australia,
  ".net" in USA.

  If you are setting up another site, please notify me.


REPORTING BUGS

  When reporting bugs, make sure you include the following:
  o What version of crossfire did you use?
  o What type of computer did you use?
  o What release of the operating system did it have?
  o What compiler did you use?
  o Which flags did you give it?
  o If the bug happened while running crossfire:
    - Include any output before to the bug.
    - Give a short description of what you did before the bug occured.
  o If you managed to compile Crossfire, include the output of
    "crossfire -o".

  Mail the bug report to frankj@ifi.uio.no.

FUTURE PLANS

  I'm planning to add an object-editor and extend the map editor.
  These will enable you to make your own monsters/items, specify how they
  work, and then make your own map where you can also use the new objects.
  Some sort of introduction and some better documentation is sorely needed.

  However, this project is beginning to get too big for me.  I believe
  CrossFire has reached only 5% of it's potential as a successful game, thus
  I'm looking for persons who can help me to develope the game.  Anything
  from source and graphics to beta-testing and ideas/bug-reports is welcome.
  If you believe in the future of this game, don't hesitate to contact me.
  My address is frankj@ifi.uio.no.

COPYRIGHT

    Don't get scared by the below, it's included just for "safety" reasons 8)
    (Don't want anyone to start selling the game)

    Copyright (C) 1992 Frank Tore Johansen

    This program is free software; you can redistribute it and/or modify
    it under the terms of the GNU General Public License as published by
    the Free Software Foundation; either version 2 of the License, or
    (at your option) any later version.

    This program is distributed in the hope that it will be useful,
    but WITHOUT ANY WARRANTY; without even the implied warranty of
    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
    GNU General Public License for more details.

    You should have received a copy of the GNU General Public License
    along with this program; if not, write to the Free Software
    Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.

    The author can be reached via e-mail to frankj@ifi.uio.no.
