Short:    carworld is a 3d networked driving simulator
Url:      http://carworld.sourceforge.net

AUTHOR(S)
Marcus Hewat	hewat@users.sourceforge.net

DESCRIPTION
carworld is a 3d networked driving simulator

HISTORY
*version v0.190: first release
*version v0.198: bug fixes, support for linux joystick etc... 
*version v0.205: preliminary support for networked gaming (under UNIX/Linux only for now) 
*version v0.215: slightly better network support, first BeOS port, applied patches sent in 
*version v0.215: (19/04/00) slightly better networking, first version to compile under beos
	applied patches sent in.
*version v0.219: (15/06/00) DirectX force feedback support, removed dependency to GLU
	auto restart added
	fixed: "start out of balance"
*version v0.222: (19/07/00) truck straightend out
	rpm package target added to makefile
*version v0.223: (20/09/00) Networked mode now works under windows
*version v0.239: (07/04/04)
	ported to SDL, removed most platform specific code (except network code & Direct Input)
	compiles with gcc 3.3.1
	compiles with Microsoft Visual C++ 6.0
	known bug: cfg file does not work under Linux
	known bug: server mode does not work

WEB
find carworld on the web at:
http://carworld.sourceforge.net

LICENCE
This software is under the GPL (General Public Licence), that is, you can use and modify if for
free but must make the source of your modifications available under the same
licence.

CONTRIBUTIONS
Advice, 3DS files for car/landscape models, new developpement, pathces,
binaries for exotic hardware, functionality/performance reports etc... will be
greatly appreciated. send them to me (hewat@users.sourceforge.net)

REQUIERMENTS
the SDL librairy http://www.libsdl.org
OpenGL

COMPATIBILITY
there is some strange C++ code in there that might not work on some compilers.


RUN
if you are using WindowsNT/9x run "bin/win_carw.exe"
(if you used winzip to extract, you will need to make shure the "smart CR/LF conversion"
is turned off or the data will be corrupt)

if you are running BeOS ix86 run "bin/be_carw"
IMPORTANT NOTE: you must in the root directory of the distribution to run carworld

if you are running Linux on i686 hardware with glibc and opengl run "bin/linux_carw"

if you are running an other UNIX flavor you will need to compile a version for your platform.


COMPILE
compiles with various CC g++ and cl.exe (Microsoft's VC++ compiler),
type 'make' or 'gmake' if this does not work to compile, this is assuming you also have 'make'
installed on your system (on windows I use make for cygwin)
if this does not work, send me a patch so that it does.


USING
once you have launched the game try using keys F2 to F5 to change options
arrow keys control the vehicle, space bar is the hand-break
TAB gives you access to a Quake-like console.
it is recomended to edit the "data/config.cfg" file to suit your computer


NETWORKED GAME
start a separat carworld with the "-server" option to start a server
type "join <servername>" at the prompt (TAB key) of a running game to connect to a server
(attention: disconnection from the server kills it right now)
note: you might have to press F2 a few times to have a view point from inside _YOUR_OWN_ vehicle...

BUGS
*untested networked Windows version (probably does not work/crashes)
*some unhandled error returns
*problem with BeOS version


TODO (in order of what is being done)
sound (plan to use openal)
clean up file formats (use 3ds?)+make a better terrain editor (with Qt)...
continue networked game
better support for the beos port
replace cube background by sphere mapping
use SDL opengl extention querying
