= Windows Client Install =

Information is current as of 3/26/09

The easiest way to get the client is to head on over to the [http://www.mv3d.com/trac/downloads downloads page] and grab an install exe. However, if you also want to run the server or do some client development, you'll need to follow the rest of this document.

The installation process requires python 2.5. If you have an earlier version of python installing python 2.5 may cause problems. Do not use the DirectX/Direct3D renderer. It causes odd problems at this point.

== Set up Combinator ==

Combinator is a way to manage PYTHONPATH and SVN branches. You can find instructions to do this [http://cyli.livejournal.com/22274.html on cyli's blog]. As an addendum to those great instructions, you'll probably need to set a few extra environment variables:

 * COMBINATOR_PROJECTS = c:\Projects (or wherever you want to put this stuff)
 * COMBINATOR_PATHS = c:\Projects\combinator_paths (or which ever projects location you chose)
 * PYTHONPATH = c:\Projects\Divmod\trunk\Combinator

== Downloading files ==

Here, we will download all the required files before installing them. 

Download [http://www.python.org/ftp/python/2.5.2/python-2.5.2.msi Python 2.5]

Download [http://sourceforge.net/project/showfiles.php?group_id=186291 Python-Ogre]. At the time of this writing, you have a choice. You can find the old 1.1 version (1.0 + update) and all features will work, or you can try 1.2 (features unknown), OR you can go for 1.6.1. If you do the latter,  you'll also have to [http://www.ogre3d.org/addonforums/viewtopic.php?f=3&t=9376 get the update]. With 1.6.1, grass is disabled.

Download [download:4 MV3D-prereqs-windows.zip]

== Installing files ==

It is important that you install python2.5 first.

 1. Install python-2.5.2.msi 
 1. Install Python-Ogre 
 1. Extract Mv3d-prereqs-windows.zip and install the following files:

    * PIL-1.1.6.win32-py2.5.exe
    * psyco-1.5.2.win32-py2.5.exe
    * pycrypto-2.0.1.win32-py2.5.exe
    * PyODE-1.2.0.win32-py2.5.exe
    * pyOpenSSL-0.7a2-py2.5.exe
    * python-cjson-1.0.3x6.win32-py2.5.exe
    * Win32OpenSSL-0_9_8g.exe

Also within the Mv3d-prereqs-windows.zip, there is folder named: site-packages. The zope files located here will need to be copied to a folder within python2.5 folder. Copy them to this folder:

c:\python25\Lib\site-packages (or wherever you installed python)

== Getting MV3D ==

Get MV3D at the following SVN location: http://svn.mv3d.com/svn/mv3d/trunk/

Via Combinator:
{{{
chbranch MV3D trunk http://svn.mv3d.com/svn/mv3d/trunk/
}}}

== Configuring ==

You'll need a plugins.cfg file in the base of the MV3D tree. It should look something like this (only with correct paths for your system):

{{{
# Defines plugins to load

# Define plugin folder
PluginFolder=c:\progra~1\PythonOgre\plugins

# Define D3D rendering implementation plugin
Plugin=RenderSystem_GL.dll
#Plugin=RenderSystem_Direct3D9.dll
Plugin=Plugin_ParticleFX.dll
Plugin=Plugin_BSPSceneManager.dll
Plugin=Plugin_OctreeSceneManager.dll
Plugin=Plugin_CgProgramManager.dll
}}}

Double click on !RunClient.py to run it. The MV3D screen will appear, connect to any of the available realms and enjoy!.

A list of available command to roam around in multiverse3d can be found on the ClientUserInterface page.

Please report any problems with the installation at the [http://www.mv3d.com/forum/ forum] under Client Installation.

To get the source, see the following websites:

 * [http://psyco.sourceforge.net/]
 * [http://pyode.sourceforge.net/]
 * [http://www.zope.org/Products/ZopeInterface]
 * [http://www.twistedmatrix.com]
 * [http://pyopenssl.sourceforge.net/]
 * [http://pypi.python.org/pypi/python-cjson]
 * [http://www.pythonware.com/products/pil/]
 * [http://www.amk.ca/python/code/crypto.html]


Back to TechnicalDocumentation.