This is the source to YAMA version 1.15 (IBM PC)

Contents:

1.		Introduction
2.		Setting Up And Configuring
3.		Rebuilding the executables
4.		License

Introduction
=============

YAMA is a multi-user game writing system designed to run on both BSD and
SYSV unix, as well as IBM-PC and Atari ST. An amiga version should appear 
shortly.

YAMA is designed to allow people to write games like MUD1 or AberMUD, 
using a simple(ish) database language, in much the same way as systems
like Quill/GAC provided this facility on micros for single user games.

YAMA can be set up to run in the following ways

1)	System V unix, using a block of shared memory and a special front end.
	This version also has a vt100 front end with a nicer display.
	
2)	BSD Unix, using the RMOL network chat program. I can't redistribute
	the chat system, but you could try asking Caederus for it.

3)	BSD Unix, telnet server. This runs much like AberMUD does. It provides
	no echo control, and only local line editing AberMUD style, but can
	be run across a network quite nicely. It should be possible to adapt
	something like tinytalk the tinymud front end to give a nice front end
	to this, but I can't be bothered.

4)	Atari ST under MiNT. I don't support this version and the port is
	from quite an old set of code.

5)	IBM-PC. 	(THIS VERSION)

YAMA is not very well documented. I have neither the time or the inclination
to write a full manual to the thing. Hopefully the commented example, and the
scribbled notes in the *LIST files will help.

What It Doesnt Do

	Currently the system doesn't support several features which are planned
	as additions, these are :-

	A proper BSD front end for telnetting
	Word wrapping on SYS V version
	Assorted minor quirks, none of which are currently too
		serious
	Making compilation and running seperate with an
	intermediate quickloading binary image format.

			-----------


Setting Up YAMA
================

Setting up IBM-PC YAMA will require an IBM PC or Clone with an ethernet card
and packet driver (or slip via the etherslip driver). In addition you will
probably need a 286 or a VERY old version of DOS. YAMA needs about 590K of
memory to run. It runs fine on a 640K 286 with 384K of extended memory
and DOS loaded high, although it doesn't leave a lot of free memory. If you
want to run it on a machine other than a 286/386 you will have to recompile
as the current program is a 286 executable.

Start off by loading the contents of the distribution onto your hard disk
with all the file paths preserved. YAMA uses relative paths so you must
start it from the top YAMA directory.

You need to configure YAMA for your network. To do this you need to sort out
some network parameters. Unless you are running the network you should ask the
network administrator for 

a)	PERMISSION! - this IS important.
b)	An ip address or bootp server
c)	The netmask
d)	Any gateways and other basic information he/she thinks will be useful.

I have enclosed the information file for the waterloo WATTCP stack which this
system uses on configuring your system.

Unconnected Networks
====================

ON NO ACCOUNT USE THESE PARAMETERS ON THE REAL INTERNET - YOU WILL REALLY
UPSET SOMEONE.

If you are in charge of an unconnected network and trying to set this up eg in
a school environment you should use the following 'WATTCP.CFG' file

my_ip = x.y.z.1			[pick x, y, z at random 1-254]
netmask = 255.255.255.0


You can use any telnet program to talk to the game from other machines - one
of the best free ones is NCSA telnet. This also has the advantage of using
similar setup files. This time number off each client machine as x.y.z.2 etc
Each client user can now start NCSA telnet once it is installed correctly
and use it to talk to the game (up to 8 at a time currently).

Booting The Game
=================

To start the game system go into the top directory of the distribution and
type

YAMA storm.db

The server will set up the system and game data (about 2mins on a 286/12)
and then start running. At this point you should be able to connect
to port 5555 of whatever the address you chose was and get onto the game.
The machine running the game server currently cannot be used for anything
else: I hope to have a windows386 version working soon which will solve
most of this problem.


Rebuilding The Executables
===========================

To do this you need to fetch WATTCP from sun.ee.uwaterloo.edu and 
compile it up. Then place <tcp.h> and wattcplg.lib in the yama-src 
subdirectory, go into borland C 2.0 and open the YAMA project, then
hit F9.

License
========

		    -  - ----==== Y A M A ====---- -  -
			
			     (c) Alan Cox 1990
		       IBM PC Port (c) Alan Cox 1992

	This program (YAMA) is made publicly available. Both sources
	and object code. The prohibitions on this software are its use
	for commercial purposes or commercial gain of any type direct or
	indirect. or the use of games developed on the system for commercial
	purposes or commercial gain of any kind, and those listed below.
	If you like this software and want to contribute to something useful
	make a donation to either:-
	
	UK:
		Swansea University Computer Society [cs_soc@pyr.swan.ac.uk]
	
	US or other:
		NYX [email aburt@nyx.cs.du.edu for details], to
		help pay for the upgrade and running of a public access unix 
		machine.

	Please don't send anything to me: I'm not rich but I'm happy...

	YAMA is supplied without any warranty implicit or otherwise, and is
	used entirely at the operators risk. The author accepts no liability
	for anything that occurs directly, indirectly or otherwise as a result
	of the use, and or possesion of this software.

	The YAMA system may be redistributed providing

	a)	No charge is made for the distribution
	b)	The same licensing restrictions AND no other
		restrictions are passed on.
	c)	Full source to the system is supplied
	d)	If any modified version are supplied they are
		supplied with the original or with suitable
		difference files for machine translation
		back to the original format (eg RCS/diff)
	e)	This file, the READ.ME file and all of the
		credits are retained unmodified.
	f)	It is not ported or operated on any computer subject to
		an Electronic Freedom Foundation boycott.

	YAMA is intended to let those creative people in the world write
	great multi-user games, and not to line peoples pockets in the
	process.
				Alan Cox [Anarchy The Wizard]