You cannot select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
openmw-tes3coop/INSTALL-linux.txt

166 lines
5.3 KiB
Plaintext

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! ;-)