			    
			    File Formats
			    ============

savefile
========

This file contains the passwords and score information for the players.

Format:
	<name>:<password>:<admin>:<games>:<wins>:<kills>:<last login>:<ip>

(each player's entry is on a separate line)

The "admin" field is set to 1 if the player has admin status, otherwise
it is set to 0.

Passwords are stored in encrypted format when using the UNIX version of
the server, and in plain-text when using the Windows version.


hosts
=====

This file contains a list of all the servers running.

Format:
    <hostname> <port number>

The server adds a new entry to the hosts file when it is started and
removes the entry when the server is shut down.  Each server entry is on
a separate line.


World files
===========

The 3d data files are stored under the "worlds" directory.  In this
directory is a file called "common.def" which contains descriptions of
objects which are common to all worlds.  Also inside the worlds
directory are subdirectories for each world in the game (e.g.
"original").  Inside each subdirectory is a file called "world.def"
which gives definitions of objects common to all rooms in the world, a
file called "server.def" which contains information about randomly
appearing objects (see below), and also object definition files for
each room of the world.  Type "help 3d" to get more information about
the 3d file format.


worlds
 |
 \_____ common.def
 |
 \_____ world directory 1
 |
 \_____ world directory 2
 .       |
 .       \_ server.def
 .       |
         \_ world.def
	 |
	 \_ data for room 1
	 |
	 \_ data for room 2
	 .
	 .
	 .

Note: world.def and common.def are only parsed when a player enters the
game.  When a player teleports to another room, only the data for that
room is parsed.

If colour definitions are in either world.def or common.def then the same
colours will be used in all rooms of a world.  If you want separate colours
for each room then all of the colours must be defined in the data file for
each room, and there must be a "clear_colours" command at the beginning
of the data for each room (so that the previous colours are freed before
the new colours are allocated).


server.def
==========

This file contains a list of objects which randomly appear in the world.
These objects are usually powerups that can be picked up by players.

Format:
    <room> <object> <x> <y> <z> <appear chance> <disappear chance> <n>
	room: string, name of room that object will appear in
	object: string, name of object
	x: integer, x coordinate for object to appear at
	y: integer, y coordinate for object to appear at
	z: integer, z coordinate for object to appear at
	appear chance: float, probability of object appearing (per second)
	disappear chance: float, probability of object disappearing (per second)
	n: integer, number of times object will appear (or -1 if object can
	   appear any number of times)

The following objects have special properties when picked up:
    heal_object: player's energy increases
    extra_mine: player gets an extra mine
    extra_grenade: player gets an extra grenade
    extra_rocket: player gets an extra rocket

