Orbiter Multiplayer Project
Installation Instructions

1. Required components
----------------------

To compile the sources of OMP, you need:

* EITHER a Visual Studio version capable of reading VS8 solutions and projects 
  (Free C# and Managed C++ compilers for the .NET framework 2.0 may work as
  well, but no batch script or similar compilation packages are provided other
  than VS8 solutions),
  
* OR a MonoDevelop installation on a Linux-distro of your choice. Compiling
  under Mono is only feasable for the server part, of course, since the client
  part is a plugin for Orbiter (which is a Win32 native application). Other
  Mono compilers and IDEs might work as well, but no other scripts or
  packages are provided other than MonoDevelop solutions.

* To recompile the source documentation you will need Microsoft Sandcastle from

  http://www.microsoft.com/downloads/details.aspx?familyid=e82ea71d-da89-42ee-a715-696e3a4873b2&displaylang=en

  There is a Sandcastle-Builder project file in Orbitersdk/samples/OMP
  which was used to generate the compressed html help file
  Doc/OMP/Orbiter.Multiplayer.chm also included in the repository. You can get
  Sandcastle-Builder from
  
  http://www.codeplex.com/SHFB

2. Installation
---------------

For a first-time installation only:

* Be sure that either Microsoft .NET framework 2.0 on Windows or Mono 1.2.6 on
  Linux is installed.

* Install the latest Orbiter release.

* Install this package into the Orbiter root directory with the directory-
  preserving option of your favorite ZIP-tool enabled.

3. Testing the server application
--------------------------

Start the compiled windows server executable (Server/Windows/ServerConsole.exe)
under .NET for Window. Alternatively, you can start the compiled linux server
executable (/Server/Linux/ServerConsole.exe) under Mono 1.2.6 for Linux. In the
later case, be sure to use the "-noColor" option to workaround the color terminal
restriction with Mono. BTW: Both directories contain the EXACT same binaries with
exception of the Orbiter.Platform.dll which holds platform specific code (clock
 hardware access in this case). This demonstrates the extrem platform independence
 of the new C# server-code.
Start Orbiter and activate the client in the "Modules" tab. Connect to your server
by setting appropriate network settings (try the outdated documentation in 
/Doc/OMP/OMP.pdf for more client information)...
