Subject: XPilot multi-player Internet game FAQ
Summary: Frequently Asked Questions about XPilot with Answers
Keywords: xpilot,games,Internet,faq
Followup-To: poster
Distribution: world
Reply-To: bert@mc.bio.uva.nl
Expires: Sun, 3 Sep 1995 00:00:00 GMT

Archive-name: games/xpilot-faq
Last-modified: 1995/08/14
Version: 3.2.5

This is the Frequently Asked Questions list With Answers for XPilot.
Suggestions, improvements and spelling corrections to bert@mc.bio.uva.nl.
This FAQ is posted in rec.games.computer.xpilot every week
and on the XPilot mailing list every couple of weeks.
It is part of the XPilot distribution.
It can also be obtained by: telnet xpilot.cs.uit.no 4402.
Or by anonymous ftp to xpilot.sdsu.edu in /pub/xpilot-maps/FAQ.

New questions in this release: none
Questions changed in this release: 18, 24
Questions changed in the previous release:

Questions:

0) Does this FAQ answer all my questions about XPilot?
1) What is this wonderful game called XPilot everybody is talking about?
2) What is the latest version?
3) Where can I get it as soon as possible?
4) Where can I get precompiled XPilot executables?
5) Sound?  Does it really have sound?
6) How can I uncompress the XPilot distribution files?
7) I do not have the patch program on my system, so how can I upgrade?
8) Compilation fails, because the compiler generates lots of error messages?
9) How should I start the game?
10) The xpilots server complains that it is unable to read globe.map?
11) xpilot fails: ioctl SIOCGIFCONF (Operation not supported on socket)?
   or: Couldn't send query packets (Operation not supported on socket)?
   or: Can't make socket non-blocking (Operation not supported on socket)?
12) xpilots fails: Could not create Dgram socket (Invalid argument)
13) Why is the client so slow?  Why is my display so jerky?
14) Where can I get new maps?
15) How can I distribute my own carefully crafted maps?
16) How can I design my own maps easily?
17) How can I design my own ship?
18) I have a problem because this and that is not working.
19) What is the meta server?  Where can I find other players?
20) What information on XPilot is available on World-Wide Web?
21) What is the NM (Newbie Manual)?
22) How should I subscribe/unsubscribe to/from the XPilot mailing list?
23) How can I contribute bugfixes and new features to the game?
24) Is there an archive of the newsgroup and the mailing list?
25) Why do I never get any items (triangles) to appear in my maps?
26) What are the Well Known Problems for the latest version?
27) What if I'm having trouble installing XPilot on Platform XYZ?
28) Is there a XPilot version available for DOS, Windows or the Mac?

Answers:

0) Does this FAQ answer all my questions about XPilot?

No, this FAQ is only meant to get you up and running and covers some
issues not found elsewhere.  In the XPilot distribution there is
authoritative documentation any wanna-be XPiloter should read.
Pay special attention to the two manual pages in the man6 directory
and to the four README files.

More, many more questions are answered in the WWW XPilot Newbie Manual
http://bau2.uibk.ac.at/erwin/NM/www

1) What is this wonderful game called XPilot everybody is talking about?

XPilot is a multi-player tactical manouvring game for X and Unix workstations.
Players have a fighter which they move along in an artificial world
and shoot each other using various kinds of weapons like bullets, mines,
smart missiles, heat seekers and so on.  It is a fast paced game with
a lot of tactics.  There are also robots flying around shooting players
and other robots.  Players can pickup special bonuses to improve the
possibilities of their ship like more engine power or special weapons.
The aim of the game is to score points and to have a lot of fun.

People can create their own maps using either a standard text editor or
a nifty map editor with easy-to-use graphical user interface.
Nice maps are a popular item to share with others.

The game is very configurable in that you can specify many parameters
in a defaults file, in the map file or on the command line.  Configurable
options include the speed of shots, the lifetime of shots, the force and
direction of the gravity, whether players can use shields or not, the chance
that some kind of special bonus appears in the world, the number of screen
updates per second and so on.

Since release 3.0 it is possible to play games across the Internet if
the roundtrip times are below 150 milliseconds or so, depending on the
frame rate of the XPilot server.

XPilot is written by Bjoern Stabell, Ken Ronny Schouten and Bert Gijsbers.
Many people around the world have contributed ideas and code or helped in
other ways to have XPilot run on a diverse set of Unix computers and VMS.

The XPilot home page on World-Wide Web is:
    http://www.cs.uit.no/XPilot/

There is a large and entertaining Newbie Manual on WWW which encompasses
more than 160 articles.  Its URL is:
    http://bau2.uibk.ac.at/erwin/NM/www

2) What is the latest version?

3.3.1.  Which is XPilot release 3.3, patchlevel 1.

3) Where can I get it as soon as possible?

Anonymous ftp to ftp.cs.uit.no (129.242.16.93).  Use as login name
anonymous or ftp and supply your email address as password.
Go to the directory /pub/games/xpilot and look for the file named
xpilot-3.3.1.tar.gz.  Some patches for older versions are also available.
Other anonymous ftp sites may have it as well, the most up to date is
ftp.x.org (198.112.44.100) in /contrib/games/multiplayer/.
Another important ftp site (especially for HP 700 series workstations) is
hpux.csc.liv.ac.uk (138.253.42.172) in /hpux/Games/Networking/.

If you have absolutely no FTP access then you can get it send to you by
email.  Mail to bert@mc.bio.uva.nl with a Subject line of `mail xpilot'.
Please be careful requesting it this way because if this service is
taking too much time it will be stopped.  FTPing it yourself is
much faster anyway.  You will get a 1 MB large mail which contains XPilot
in gzipped uuencoded format.  Save this mail to a file then uudecode this
file to get xpilot-3.3.1.tar.gz.  This is the XPilot distribution file as
found on ftp.cs.uit.no.

4) Where can I get precompiled XPilot executables?

FTP to bigblue.pvv.unit.no.  In the directory /store/store/ernie/xpilot/
there is a README explaining further details.
Stig S. Bakken <ssb@pvv.unit.no> is responsible for this service.

5) Sound?  Does it really have sound?

There is optional sound support for machines running the rplay package.
When you have compiled and installed XPilot with sound support configured
then run rplayd on the machine which is running your XPilot client.
You will probably need "rplayd -n -t 0" so that it takes input from the
network port and doesn't time out and die.  If that is running on the
client machine, XPilot should automatically figure it out and start
playing the appropriate sounds for you.

Rplay version 3.1 is not just for Suns any more.  So far there is support
for SunOS 4.1.x, Solaris 2.x, Linux, 386bsd, BSDI/386, HP-UX, and
SGI Indigo is almost done.

There is also sound support for NCD MCX X terminals.  These X terminals
must be running release 3.1 or later of the NCD software.
Greg Renda can provide you with more details at greg@ncd.com.

The NAS (Network Audio System) support will also work with any machine running
a netaudio server.  At the moment, the following are capable of doing this:
    NCD MCX X-terminals (running NCDware 3.1 & later)
    Sun Sparcs
    SGI workstations
    Linux
    FreeBSD

And there is sound support for DEC AudioFile.  AudioFile supports Digital RISC
systems running Ultrix, Digital Alpha AXP systems running OSF/1,
Sun Microsystems SPARCstations running SunOS, and SGI Indigos.
Tom De Pauw can provide with more details at tom@wimsey.com.

6) How can I uncompress the XPilot distribution files?

The files are in GNU zip format.  Older versions of GNU zip use
the .z extension, newer versions of GNU zip use the .gz extension.
GNU zip is available from your favorite local ftp site.  Look for gzip.
Two of the many ftp sites having gzip are ftp.uu.net (192.48.96.9) and
prep.ai.mit.edu (18.71.0.38).  The last one in the pub/gnu directory.

Alternatively, if you have an older version of GNU zip and do not wish to
upgrade, you can use something like :

    gzip -d < xpilot-3.3.1.tar.gz > xpilot-3.3.1.tar

or even better :

    gzip -d < xpilot-3.3.1.tar.gz | tar xvf -

7) I do not have the patch program on my system, so how can I upgrade?

Get patch from one of the major ftp sites mentioned above.
Or from prep.ai.mit.edu in the /pub/gnu directory.

8) Compilation fails, because the compiler generates lots of error messages?

This is probably due to not using an ANSI C compliant compiler.
Consider using gcc.  Also, do not use the -ansi option together with GCC,
because some system include files are not fully ANSI compatible.

9) How should I start the game?

When you have managed to compile XPilot successfully you will have
two new executables.  One program is named 'xpilots', which is the
server program.  If you do: `xpilots -help' then you will see some
configuration options with explanations.  Start this program in one window
simply by typing: xpilots or ./xpilots.  Nothing much will happen yet.
The other program is named 'xpilot', which is the client program.
Startup this program in a second window.  If you start this program
without arguments it tries to find an XPilot server on your local network.
Otherwise give it the name of the host where the XPilot server is
running as its last command line argument.
The xpilot client program should now print a message like:

*** Server on darkstar.frop.org. Enter command>

Now type a question mark '?' to see some possible options.
Or simply type a return to enter the game.

Newbies should note that in order to fire one has to put down
the shield first.  This is done by pressing and releasing the
spacebar once.

10) The xpilots server complains that it is unable to read globe.map?

First read the READMEs more carefully.  They tell you that you
need to adapt the Imakefile or Makefile and possibly the config.h
file to your XPilot installation configuration.
Specifically modify LIBDIR to the directory where you have your XPilot
lib directory and MAPDIR in case you have changed your map directory.
There are also two manual pages included which may offer you more help.

11) xpilot fails: ioctl SIOCGIFCONF (Operation not supported on socket)?
   or: Couldn't send query packets (Operation not supported on socket)?
   or: Can't make socket non-blocking (Operation not supported on socket)?

When you try to run the client it fails with the following messages:

    xpilot: ioctl SIOCGIFCONF (Operation not supported on socket)
    xpilot: Couldn't send query packets (Operation not supported on socket)

or if you try to run the server it will fail with the following message:

    xpilots: Can't make socket non-blocking (Operation not supported on socket)

Whomever installed gcc on your system forgot to run fixincludes which
converts the ioctl definitions in the header files so that they will
compile properly.

Colin Benson <cbenson@spock.retix.com> adds:
The thing that caused the SunOS 4.1.3 gcc build to fail with the socket
message is that the compile line generated by make includes '-I/usr/include'
which makes gcc pick up the standard include files rather than its
special includes.  I directly hacked the makefile to cut this out
and the resulting build worked.

Craig Powers <craig_powers@stortek.com> writes:
We had fits trying to get xpilot to compile correctly with gcc on our
Solaris2.3.  The compiler said that it was in the file signal.h.  We thought
it must be a problem with the program since we had compiled small programs
with gcc and they seemed to work.  It turned out that our problems were due to
the compiler not being installed correctly.  We made our sys-admin guy go
through the whole installation for gcc.  This time xpilot compiled the very
first time!!  So check the installation of gcc.  It may look like its working
correctly but it isn't.  It seems that gcc wanted to modify the header
files and our sys-admin guy didn't let it.  What I think really happens is
that gcc takes copies of the systems header files and modifies them and saves
these in a special place.  Then a enviroment variable is set so that gcc
knows where the modified headers are.  After our sys-admin guy let gcc do
this, everything worked.

12) xpilots fails: Could not create Dgram socket (Invalid argument)

You are probably running Linux or one of the BSD flavors on your PC
and "forgot" to install the network support of your operating system.

For Linux you should install the N series of disks n1, n2 and n3.
You won't need everything that's on the disks in order to run XPilot,
i.e. you can drop things like lynx, tin, nn, etc.

13) Why is the client so slow?  Why is my display so jerky?

This is probably due to you not using a standard MIT X server, but
one of those customized servers supplied by your workstation vendor.
Some of these servers, like the Xnews and Xsun servers from Sun
and an Ultrix server, are known to have serious performance degradation
for X clients that frequently change their colors or colormaps.
Because XPilot changes the set of colors at a rate of approximately 15
times per second this will not work well if your hardware is not superfast.
Try to use the MIT X server instead.

Or, if you like to experiment a little, compile the src/paint.c file
with the macro ERASE defined as 1 (add -DERASE=1 to DEFS in the Makefile).
This will have the client use a different drawing technique, which is
reported to speedup the client for older/cheaper workstations by
about 50 percent.
The ERASE option was first implemented for release 3.0.6 and needs
more work as it is not perfect yet.  Improvements are welcome.

Owners of SPARCs could try the new SPARC_CMAP_HACK compile time option
together with the ERASE option.  This causes a very big speed improvement
on SPARCs with a cg3 card.  Be warned however that this is relatively new.
SPARC_CMAP_HACK should only be allowed if the display is the console of the
machine you're running on. Otherwise, since /dev/fb has world write access,
whoever is using the console will find their palette flashing. Perhaps there
should also be a command line option to switch it off.
Please note carefull that this is a very experimental option and that it
only works on SPARCs.

Decrease the window size (it is resizable now), this will
result in fewer packets sent over the network and a lot less
work for the Xserver (clearing a 1024x1024 window is ~4 times
more work than clearing a 512x512 window, and clearing/copying
for double buffering often seems to be the limiting factor).

Decrease sparkprob.  This will result in fewer sparks being
sent over the network (sparks take up much of the network
bandwidth).

Decrease the number of colours.  This might help, but it depends
on which double buffering routine you use and probably on the
implementation of the Xserver.

Play outside working-hours.  Some bad performance is due to
saturated LANs - a network/LAN with as little as possible load,
or at least an even load is a necessity for getting good/smooth
response.

Make sure you run the server on a different machine from the client.
Or run it at a lower priority like: nice -20 xpilots.

Try another double buffering method - you can choose between
pixmap copying and (if you have PseudoColor) color switching.
The effect depends on your platform.

Try a different visual.  Try: "xpilot -visual list" to see a list
of supported visuals on your system, or use xdpyinfo.

Decrease the frames per second generated by the server by setting the
-fps option.  This won't make the server faster, but it might
make the game run more smoothly and evenly, and perhaps make
the game more fair.  Users joining across the Internet really appreciate
a slightly lower frame rate (try values like: 14, 12 or 10).

If you have achieved any success with speeding up graphics performance
then send a note to xpilot@cs.uit.no telling how and for which hardware,
X server, XPilot version, compile time options and frames per second.

14) Where can I get new maps?

anonymous ftp:
        xpilot.sdsu.edu:/pub/xpilot-maps
gopher:
        Name=xpilot-maps
        Type=1
        Port=71
        Path=1/pub/xpilot-maps
        Host=xpilot.sdsu.edu
        (Note that you can only retrieve maps with gopher...)

You can also use the new xpmtp program which is in the contrib directory
of the distribution.  Xpmtp is an abbreviation of XPilot Map Transfer
Protocol and provides an easy way to upload, download and preview maps
from xpilot.sdsu.edu.  Xpmtp was made by Andrew Scherpbier.

Questions and comments about this map server should go to Andrew@SDSU.Edu

You can also receive or send maps by e-mail.  Mark Boyns has setup a nifty
map mailing and submitting service on xpilot.sdsu.edu.  The map mailing
program can be activated by mailing to xpilot-maps@xpilot.sdsu.edu.
The command you want it to perform should be specified as the Subject.
The body of the mail command is ignored except for the submit command.
The xpilot map mailer supports the following commands:

allmaps           - Retrieve all the maps from the archive.
                    The returned message will consist of a uuencoded
                    tar.gz file of all the maps.  WARNING this might
                    fill up your mailbox.

get <mapname>     - Retrieve <mapname> from the archive.
                    This command ignores the body of the message.
                    <mapname> should include the .map extension.

uuget <mapname>   - Same as "get" but the map data will be uuencoded.

help              - This message.
                    This command ignores the body of the message.

index             - Retrieve and index of all the maps in the archive.
                    This command ignores the body of the message.

submit <mapname>  - Submit <mapname> to the map archive.
                    The body of the message is assumed to contain the map
                    data that will be stored in the archive.
                    <mapname> should include the .map extension.

All commands must be specified on the "Subject:" line of the mail message.
Here's an example:

% Mail -s "get doggy.map" xpilot-maps@xpilot.sdsu.edu < /dev/null

Where "Mail" is the BSD mail program.  On some System V machines like HP-UX
this is installed as the mailx program.
Send questions & comments & suggestions to boyns@sdsu.edu (DR.DEATH).


There is also a world writeable map directory on ftp.cs.uit.no in
/pub/games/xpilot/maps where you can find a lot of maps also.

15) How can I distribute my own carefully crafted maps?

See the previous question.  The sites mentioned in the previous question
are eager to add your map to their set of maps, but it is perhaps also
a good idea to post an announcement in rec.games.computer.xpilot or on the mailing
list explaining some ideas behind and properties of your map.

For easy uploading of maps to xpilot.sdsu.edu you can use the xpmtp
program which is in the contrib directory of the distribution.

16) How can I design my own maps easily?

Use the XMapEdit program, which was made
by Aaron Averila (averila@oes.orst.edu).
You can get it by ftp from ftp.cs.uit.no in /pub/games/xpilot/contrib/.
The map format is in ASCII so you can also make or change maps
with your standard text editor (vi, emacs).  And everybody did
it that way before XMapEdit, but that seems hopelessly complex
and tedious now.
Special thanks to Aaron for making XMapEdit.

17) How can I design my own ship?

Use editss.  You can get it by anonymous ftp to
dnpap.et.tudelft.nl in the /pub/Private/Ronald directory.
Or from ftp.cs.uit.no in the /pub/games/xpilot/contrib directory.

18) I have a problem because this and that is not working.

Make sure you use the latest `officially released' version.
You will be most cooperative if you try to fix it yourself first.
If you find the cause of the problems mail any solutions/bugfixes
to xpilot@cs.uit.no.
If you tried everything and you still cannot solve it then post
a help request to rec.games.computer.xpilot or mail to xpilot-list@cs.uit.no.
There are some things that are generally helpful to mention, when relevant:
 
   * The XPilot version and where you obtained the distribution.
   * Your hardware.
   * Operating system.
   * Windowing system (X11, ...)
   * C Compiler used.
   * Changes you made to configuration files.
   * Any changes you have made to the source code or installation
     procedures.
   * Any problems you had during installation.

19) What is the meta server?  Where can I find other players?

The meta server is a server program that allows people to find other
XPilot servers running on the Internet.  XPilot servers can report
their existence to the meta server on startup and every three minutes
of active play.  Then other players can query the meta server and
find status information on XPilot games in progress.

The meta server also maintains a nickname database containing all the
nicknames in use by Internet XPiloteers.  XPiloteers can add their
nickname interactively and protect it by a password.

You can connect to the meta server with:

  telnet xpilot.cs.uit.no 4400

Help is available online.  Example session:

    telnet xpilot.cs.uit.no 4400
    Trying...
    Connected to lgserv1.cs.uit.no.
    Escape character is '^]'.

    Welcome to Xpilot Meta server

    This is the available ports on the Meta server:
    4400:   This port. Interactive user port.
    4401:   Program port. Lists out all info in one go and terminates.
    4402:   FAQ port. This will give you the FAQ in one go and terminate.
    4403:   Nick-name port. This will give you the current nick name list.

    Type "help" to list out possible commands.

    E-mail problems to kenrsc@stud.cs.uit.no (Ken Ronny Schouten).

    >list
    3.2.9          :144.168.23.100           :15345    :0   :2.51      :Team-combat
    3.2.9          :stra27.hw.stratus.com    :15345    :1   :20d 2.14  :The Wide Colony (version 1.0)
    3.2.9          :i11s17.ira.uka.de        :15345    :2   :13d 10.29 :The Globe
    3.2.9          :wpyx78.physik.uni-wuerzburg.de:15345    :2   :0.16      :The Globe
    3.2.9          :irz201.inf.tu-dresden.de :15345    :4   :11d 8.52  :The Black Hole
    3.2.9          :skolem.uni-paderborn.de  :15345    :0   :13d 1.33  :UNI-PADERBORN
    3.2.9          :micro.iesd.auc.dk        :15345    :2   :6d 6.32   :CyberParadise
    3.2.9          :bird05.cs.ohiou.edu      :15345    :4   :0.00      :CloudScape
    3.2.9          :adder.ee.byu.edu         :15345    :0   :NA        :The Globe
    3.2.9          :polaris.cis.ksu.edu      :15345    :1   :2.30      :Refrigerator
    3.2.9          :carbon.lance.colostate.edu:15345    :2   :1.07      :Team Warfare
    3.2.9          :mizar.wustl.edu          :15345    :5   :21.00     :Chambers of Carnage
    3.2.9          :scratch.eecs.umich.edu   :15345    :7   :1d 15.24  :Blood's Music
    3.2.9          :xpilot.modeemi.cs.tut.fi :15000    :0   :6d 22.00  :Mta tournament
    3.2.9          :dutian.twi.tudelft.nl    :15345    :2   :0.00      :Team Tournament
    3.2.9          :surt.ifi.uio.no          :15345    :1   :0.36      :Fireball
    3.2.9          :oversoul.edb.tih.no      :15345    :0   :23.18     :Tournament
    3.2.9          :tsunb.ctn.cogs.susx.ac.uk:15345    :3   :1.21      :Borgtown
    3.2.9          :eden.bioc.cam.ac.uk      :15345    :3   :0.24      :ShadesNicks
    3.2.9          :lagrange.cms.dmu.ac.uk   :15345    :4   :0.39      :The Globe
    3.2.9          :meehpa02.ee.man.ac.uk    :15345    :0   :7d 0.06   :Tournament
    >server scratch.eecs.umich.edu
    >status
    SERVER VERSION...: XPilot 3.2.9
    STARTED BY.......: pkenny
    STATUS...........: ok
    MAX SPEED........: 12 fps
    WORLD (100x100)..: Blood's Music
	  AUTHOR.....: Patrick Kenny - pkenny@eecs.umich.edu
    PLAYERS ( 7/12)..:

    NO:  TM: NAME:             LIFE:   SC:    PLAYER:
    -------------------------------------------------
     1... *2 Ender              003   342     turtle@ender.sdsu.edu
     2...  2 DR.DEATH           003   249     boyns@hercules.sdsu.edu
     3...  4 Phoenix            002    75     dan@starfire.ne.uiuc.edu
     4... W2 Arafat             000     0     furth@tph21.tuwien.ac.at
     5...  3 Lei                003    -5     caol@misty.cs.byu.edu
     6...  2 Hero               003   -13     jmin@sunny.cs.byu.edu
     7...  3 Neptune One        002  -189     garrett@athena.sdsu.edu

    >quit
    Connection closed by foreign host.

Try port 4401 instead of 4400 to get the server listing in a different format.

Port 4402 will get you the latest version of this FAQ.

Port 4403 will list the current nicknames database.

Due to some software problems the meta server may not be running
at all times, but it mostly will.  In case it happens to be unreachable
there is an backup meta server at telnet xpilot.mc.bio.uva.nl 4400.

The meta server is developed and maintained by Ken Ronny Schouten.
His email address is kenrsc@stud.cs.uit.no.

20) What information about XPilot is available on World-Wide Web?

The XPilot Page on the World-Wide Web can be found on URL
    http://www.cs.uit.no/XPilot/

Highly recommended is the online XPilot Newbie Manual, the creation
of Karen Gould and Erwin Zierler with the help of many contributors:
    http://bau2.uibk.ac.at/erwin/NM/www

Other WWW pages related to XPilot are:
    http://heron.met.nps.navy.mil/~forsythe/index.html
    http://bau2.uibk.ac.at/che/xpilot.html
    http://vitruvius.cecer.army.mil:8000/~rglaeser/xpilot/xpilot.html
    http://ernie.ucsc.edu:8001/1g/xpilot
    http://ece.uiuc.edu/lard/lard.html
    http://www.sdsu.edu/~boyns/xpilot.html
    http://www.sdsu.edu/~turtle/
    http://www.sdsu.edu/~garrett/
    http://krusty.eecs.umich.edu/people/kennyp/xpilot/xpilot.html
    http://rs560.cl.msu.edu/misc/xpilot.html
    http://www.cldc.howard.edu/~ltb/Xpilot

21) What is the NM (Newbie Manual)?

The Newbie Manual is a World Wide Web (WWW) book (not page, it is made
up of many many pages all linked together) which you access using programs
like Mosaic or Netscape by opening the Newbie Manual address which is:

http://bau2.uibk.ac.at/erwin/NM/www

This will connect you to the Manual which you read through by clicking on
the highlighted links.

It has some really cool pics, stories, and most improtantly, pages on
almost all the weapons, showing what their icons look like, how to use
them, what their keys are, and tons of strategies written by very 
experienced players.  There is an entire article on all the modifiers, like
the V modifier, and these articles have loads of links to important
cross reference material.  The manual is not complete, but is an extremely
useful documentation guide to playing XPilot.

22) How should I subscribe/unsubscribe to/from the XPilot mailing list?

Requests for (un)subscription to the XPilot mailing list should
be send to listproc@cs.uit.no.  People really dislike it
to see any (un)subscribe requests in the mailing list itself.
The mailing list itself is xpilot-list@cs.uit.no, which is gateway-ed
to rec.games.computer.xpilot.

23) How can I contribute bugfixes and new features to the game?

Make your contributions as context diffs against the latest version
and mail them to xpilot@cs.uit.no.  You can make context diffs with
the diff command.  Use `diff -c oldfile newfile' or `diff -cr olddir newdir'.
The authors very much appreciate fixes and improvements.  XPilot has a
longstanding tradition of incorporating code from hackers all over the world.
Ideas for new features can of course be discussed in rec.games.computer.xpilot
and the mailing list.

24) Is there an archive of the newsgroup and the mailing list?

David Bianco has set up an archive of alt.games.xpilot which can be
accessed via anonymous FTP to ftp.cs.odu.edu:/pub/news/alt.games.xpilot.
Note that this is also an archive of the mailing list (they are the same).  

There is also an older archive of the XPilot mailing list on ftp.cs.uit.no
in pub/games/xpilot.

25) Why do I never get any items (triangles) to appear in my maps?

At startup the xpilot server looks for a configuration file to
retrieve default values for some of the options.
The default name for this file is LIBDIR/defaults, where LIBDIR
is defined during compilation in the Makefile or Imakefile.
If you forgot to change the value of LIBDIR before compilation
or if you have (re)moved the XPilot directories after installation
then the xpilot server cannot find this file anymore.  In which
case some of the values will have no or a useless value.
This is the case if you do not get any items to appear in your maps.
An example defaults file with reasonable default values can be
found in the XPilot distribution as xpilot-3.x.y/lib/defaults.

26) What are the Well Known Problems for the latest version?

The first of these Well Known Problems apply to XPilot 3.0 patchlevel 3,
but may also apply to later patchlevels:

(a) On some systems the client drops frames, which results in a jerky display.
    This is either due to a slow display system which can be solved by reducing
    the number of frames the server is generating with the -FPS option.
    Or this is due to a currently unknown bug in which case it is observed
    that the display will become normal if the player is firing very heavily.
    Or this is due to a bug (some bugs) in Suns OpenWindows X servers in
    which case changing to MIT X Servers will help.
(b) The Imakefile entry for Suns causes some problems on some systems.
    Try the Makefile.std instead and do a make clean first.
(c) On Suns running openwindows there seems to be a problem with the varargs
    mechanism related to gcc using a different set of include files.
    This causes a core dump, due to a segmentation violation in the
    file net.c in function Packet_printf().
    To prevent gcc from using the wrong set of include files make sure that
    the compiler is not having a -I/usr/include argument.
    When using the Imakefile with xmkmf check for the following bad line
    in the generated Makefile:
        TOP_INCLUDES = -I$(INCROOT)
    It should be changed to:
        TOP_INCLUDES =
    Or use the Makefile.std instead which does not have this problem.
(d) It has been reported that after applying patch #3 it was necessary to do
    a make clean first before recompiling.

These apply to XPilot 3.0 patchlevel 4 only:

(e) In Team mode shots sometimes don't kill.  This is due to a bug
    in collision.c line 627, which currently reads as:
	    if (TEAM(obj->id, pl->id)) {
    But which should read as:
	    if (TEAM(GetInd[obj->id], GetInd[pl->id])) {

For XPilot 3.0 patchlevel 5 there have not been reported any problems.

Since 3.0.5 there is a BUGS file in the toplevel directory of the distribution.
This file describes all of the known bugs and the (lack of :) progress being
made on fixing them.

These apply to XPilot 3.0 patchlevel 6 only:

Using the `K' command to kick a player cause the server to exit with an
error message.  This will be fixed in patchlevel 7 (not so it seems).

Running a server with very big maps fails because these maps are
not transmitted complete to the client.  Very big is approximately
600x600, depending upon the map compression ratio.
This is fixed in the next release, which will permit maps upto 936x936.

These apply to XPilot 3.0 patchlevel 7 only:

There is a typo in the text displayed for nuke hits.  Only cosmetic.
Apart from this patchlevel 7 seems to be the most stable 3.0 release.
The next release will be 3.1.0 and will contain hundreds of new and
experimental changes.

These apply to 3.1 patchlevel 0 (all of them will be fixed in 3.1.1):

a) The audioServer resource is buggy.
b) ERASE mode is bad in erasing weapon modifiers and mine names.
c) The modifier banks are not properly tested for server options.
d) For some keys the X resources and help is missing.

Important bug: kicking a player terminates the server.
Fixed in 3.1.2.

3.1.2 generates unresolved references during link time on Suns.

Patchlevel 3.1.3 seems to be the most stable version sofar.

Versions 3.2.0 and 3.2.1 are quite buggy.  Upgrade to 3.2.2 which
is as good as perfect, except for a few known small problems.
    a) some ship shapes whose definition is exactly 255 characters
       when transmitted to the server cause the client to exit.
    b) targets are not always drawn in the right color if teammode
       is on and you didn't set your team explicitly but relied
       on teamAsignment.
    c) rogue heat seakers can cause the server to crash.  This bug
       may also exist in earlier 3.2 versions.

XPilot 3.2.5 and 3.2.6 are stable recommended versions with only a
few harmless bugs, which you will probably not notice.

3.2.7 has a serious bug in the new robot code.
It also cause some strange problems which haven't been demystified.

3.2.8 has a bad new sound messing up most of the sound effects
if different client and server versions are mixed.

3.2.9 has a few small bugs, some of which were also in 3.2.8, 3.2.7
and earlier versions:
    a) robots have an undefined attack and defense setting.
    b) Compilation for old HP C compilers may cause strange effects,
       either upgrade your HP C to A.09.69 or use gcc.
       For HP 700 series there is a pre-compiled gcc distribution
       available from jaguar.cs.utah.edu in /dist/hpuxbin.tar.Z
    c) `initialEmergencyShields' don't work correctly when `playerStartShielded'
       is false and `allowShields' is false.  This bugreport could not be repeated.
    d) A memory overwrite bug is triggered when a player gets her eighth tank.

27) What if I'm having trouble installing XPilot on Platform XYZ?

Below is a list of people who are willing to help others install XPilot
on various platforms. Please feel free to mail these people about any
difficulties you are having but keep in mind that they are doing this
voluntarily.  Please specify the operating system and compiler you are
using when describing your difficulties as well as the version of XPilot.

Platform                Person              Email
----------------------- ------------------- ---------------------------------
DEC Ultrix 4.2          David Chatterton    davidc@bruce.cs.monash.edu.au

SGI Irix 4.0.5          David Chatterton    davidc@bruce.cs.monash.edu.au

Trusted Solaris CMW     Steve Marsden       marsdens@logica.co.uk

VMS                     Jens Koerber        koerber@itt.uni-stuttgart.d400.de

Linux                   Bert Gijsbers       bert@mc.bio.uva.nl

HP-UX                   Bert Gijsbers       bert@mc.bio.uva.nl

28) Is there a XPilot version available for DOS, Windows or the Mac?

No.  For PCs the best solution is to install the Linux operating system,
which is free, on the PC.  Linux is a supported platform for XPilot.

For the Mac there is no hope.

EOFAQ
