OpenMW - the completely unofficial reimplementation of Morrowind ================================================================ OpenMW is an open source reimplementation of the Morrowind game engine. For more information, see README.txt or http://openmw.snaptoad.com/ Installation from source ======================== (this file is NOT complete!) Supported Unix platforms: ------------------------- The only Unix operating system that has been tested and is known to work is 32bit Ubuntu Linux 8.04. FreeBSD works partially, but you have to recompile most of the dependencies as well. There is a bug in the compiler can breaks exceptions though, so if anything goes wrong you probably will not get any sensible error message. Linux 64 bit is known NOT to work at the moment. If you manage to build OpenMW on a platform not listed here, or want to try, please let me know! Dependencies: ------------- Dependencies needed to build OpenMW: OGRE 1.4.5 (3d engine) Audiere 1.9.4 (sound engine) OIS-1.0.0 (input system) gcc and g++ (C++ compiler) GNU make (build tool for C++ files) DMD 1.031 (D compiler) or GDC 4.1.3 (alternative D compiler) Monster 0.8 (scripting language and tools) DSSS 0.75 (D build tool) curl (for DSSS) The above versions are the ones I have tested recently, but other versions might work. OGRE, Audiere and OIS will require their own set of dependencies. I recommend using an automated package tool to install as many of these as possible. On ubuntu, try typing: sudo apt-get install libogre-dev libaudiere-dev libois-dev build-essential g++ curl gdc This takes care of OGRE, Audiere, OIS, the C and D compilers, make and curl. The rest have to be installed manually. This will give you the GDC (frontend for GCC) compiler. The "official" compiler, DMD, is updated more often, but both should work. Note however that DMD is only available on 32 bit Linux - other operating systems or architectures will have to use GDC. (However GDC might also be unstable on these platforms.) If you want to use DMD instead, go to http://digitalmars.com/d/1.0/dmd-linux.html You can find the two remaining dependencies here: DSSS: http://svn.dsource.org/projects/dsss/downloads/ Monster: http://monster.snaptoad.com/download.html If you are using a DSSS binary and not compiling from source (I recommend the binary), make sure to get one that matches your D compiler. Ie. get the GDC version if you installed GDC, and the DMD version for DMD. If you want to install Ogre, Audiere or OIS manually as well, try: OGRE: http://ogre3d.org Audiere: http://audiere.sourceforge.net/ OIS: http://sourceforge.net/projects/wgois/ Building: --------- After installing all the dependencies, you can try running make first to see if the C++ parts compile. You may need to alter the Makefile if you are using non-standard include paths, etc. When you are ready to compile the D parts and link it all together, type: dsss build If something goes terribly wrong during the build (which isn't unlikely), and you figure out how to solve it, I would appreciate if you told me about it so I could update these instructions. Installation from binary ======================== (not written yet - we might as well create a .deb file) Configuration ============= Before you can run OpenMW, you have to help it find the Morrowind data files. The 'openmw' program needs the files Morrowind.esm and Morrowind.bsa, and the directories Sound/ and Music/ from your "Morrowind\Data Files\" directory. By default it expects to find these in the data/ directory. (This can be changed in openmw.ini) I recommend creating a symbolic link to your original Morrowind install. For example, if you have Morrowind installed in: c:\Program Files\Bethesda Softworks\Morrowind\ and your windows c: drive is mounted on /media/hda1, then run the following command: ln -s "/media/hda1/Program Files/Bethesda Softworks/Morrowind/Data Files/" data Also, if you have OGRE installed in a non-standard directory (ie. NOT to /usr/lib/OGRE), you have to change the PluginFolder in the file plugins.cfg.linux. The first time you run openmw you will be asked to set screen resolution and other graphics settings. You can bring this dialogue up at any time with the -oc command line switch. I don't recommend using fullscreen mode yet, since it might mess up your screen and input settings if the program crashes. Running OpenMW ============== If Azura is with you and all the stars and planets are aligned in your favor, you should now be able to run OpenMW using the program called 'openmw'. Write openmw -h to see a list of options. Running without parameters should bring you into the cave called Sud, or the last cell loaded. You are in free float mode. Move around with WASD (or arrow keys), move up and down with left shift and ctrl, exit with 'q' or escape. Note that if you have a localized (non-English) version, the cell "Sud" might not exist. I will solve this issue in a later version. To load another cell, specify the cell name on the command line. Use the 'esmtool' program to get a list of cells. Note that you must use quotation marks "" if the cell name contains spaces or other weird characters. Exterior cells are disabled at the moment. Enjoy! ;-)