Difference between revisions of "Installation Instructions"

From OpenMW Wiki
Jump to: navigation, search
(macOS: Adding an installdir)
(Moved to RTD and linked.)
 
Line 1: Line 1:
The OpenMW engine needs to be installed
+
Installation instructions have moved to our official documentation on [https://openmw.readthedocs.io/en/latest/manuals/installation/index.html ReadTheDocs].
  
==Install OpenMW==
 
===The (easier) Binary Way===
 
 
* Simply get the right archive for your OS here : https://openmw.org/downloads/
 
* Extract it
 
* Launch "openmw-launcher.exe" if you are under Windows, or "openmw-launcher" if you are under Linux/Mac
 
* Play!
 
 
===The (bleeding edge) Source Way===
 
 
See [[Development_Environment_Setup | Development Environment Setup]] for detailed instructions.
 
 
After building the engine:
 
 
* Launch "openmw-launcher"
 
* Play!
 
 
===The Debian Way===
 
OpenMW is available from the unstable (sid) repository of Debian contrib and can be easily installed if you are using testing or unstable. However, it depends on several packages which are not in stable, so it is not possible to install OpenMW in Wheezy without creating a [https://wiki.debian.org/DontBreakDebian#Don.27t_make_a_FrankenDebian FrankenDebian]. This is not recommended or supported.
 
 
===The Ubuntu Way===
 
A [https://launchpad.net/~openmw/+archive/openmw Launchpad PPA] is available. Add it and install OpenMW:
 
 
<syntaxhighlight lang="text" style="overflow:auto">
 
$ sudo add-apt-repository ppa:openmw/openmw
 
$ sudo apt-get update
 
$ sudo apt-get install openmw openmw-launcher
 
</syntaxhighlight>
 
 
Note: OpenMW-CS must be installed separately by typing:
 
 
<syntaxhighlight lang="text" style="overflow:auto">
 
$ sudo apt-get install openmw-cs
 
</syntaxhighlight>
 
 
===The Arch Linux Way===
 
The binary package is available in the official [community] Repositories.
 
 
To install simply run the following as root (or in sudo):
 
<syntaxhighlight lang="text" style="overflow:auto">
 
# pacman -S openmw
 
</syntaxhighlight>
 
 
===The Void Linux Way===
 
The binary package is avaible in the official Repository
 
 
To install simply run the following as root (or in sudo):
 
<syntaxhighlight lang="text" style="overflow:auto">
 
# xbps-install openmw
 
</syntaxhighlight>
 
 
==Install Game Files==
 
 
OpenMW is a complete game engine that can either run Morrowind or original projects created with OpenMW-CS, such as Example Suite.
 
 
===Running the Morrowind Installation Wizard===
 
 
# Launch OpenMW
 
# Launch the Installation Wizard
 
:*If you are prompted with an error message stating "Could not find the Data Files location". Click the "Run Installation Wizard…" button
 
:*If you arrive at the main screen, click the "Settings" button and then click the "Run Installation Wizard…" button
 
# Follow further instructions below to install Morrowind from either a retail CD or an existing installation
 
# You will be asked if you wish to import settings from Morrowind.ini. Select "Import", otherwise OpenMW will not work. (You do not need to check the box "Include selected masters and plugins").
 
# The OpenMW launcher window should now open. Switch to the "Data Files" tab and check the box to the left of "Morrowind.esm".
 
# You are now ready to play!
 
 
===Morrowind (from retail CD)===
 
 
Make sure that the retail CD is in your computer's CD/DVD drive and the Installation Wizard is running.
 
 
# On the "Select Installation Method" screen of the Installation Wizard, choose "Install Morrowind to a New Location" and click the "Next" button
 
# Choose a location to install Morrowind to your hard drive (or accept the suggested location) and click the "Next" button
 
# Select your preferred language for the installation and click the "Next" button
 
# Select which official expansions (Tribunal or Bloodmoon) should be installed. For best results, it is recommended to have both expansions installed.
 
# Click the "Install" button
 
 
===Morrowind (from existing Installation)===
 
 
# On the "Select Installation Method" screen of the Installation Wizard, choose "Select an existing Morrowind installation" and click the "Next" button
 
# Select an installation
 
:* If an installation appears in the "Detected Installations" area, choose that
 
:* If no installation appears, click "Browse"
 
# Navigate to the directory containing the file "Morrowind.esm" and select that file.
 
 
====Retail CD and GOG====
 
 
Windows users can run the installer if they haven't already. By default, both Bethesda's official installer on the retail CD and the GOG installer install to <code>C:\Program Files\Bethesda Softworks\Morrowind</code>. You will find "Morrowind.esm" there.
 
 
Users of other platforms running Wine, will find it at <code>"~/.wine/drive_c/Program Files/Bethesda Softworks/Morrowind"</code>
 
 
====Steam====
 
 
=====Windows=====
 
 
Windows users can download Morrowind through Steam. Afterwards, you can point OpenMW to the Steam install location at <code>C:\Program Files\Steam\SteamApps\common\Morrowind\Data Files\</code> and find "Morrowind.esm" there.
 
 
=====macOS=====
 
 
If you are running macOS, you can also download Morrowind through Steam:
 
 
# Navigate to <code>/Users/YOUR_USERNAME_HERE/Library/Application Support/Steam/steamapps/</code>
 
# Create a file called <code>appmanifest_22320.acf</code> (the number is based on its [https://steamdb.info/app/22320/ Steam App ID]). If using TextEdit, make sure that your document is in plain text mode by going to the menu bar and choosing "Format" -> "Make Plain Text". Also, ensure that it's not named with the extension <code>.acf.txt</code>.
 
# Add the following into that file:
 
 
<pre>
 
"AppState"
 
{
 
"AppID" "22320"
 
"Universe" "1"
 
"StateFlags" "1026"
 
"installdir" "The Elder Scrolls III - Morrowind"
 
}
 
</pre>
 
 
The launch the Steam client and let it download. You can then find the "Morrowind.esm" file at <code>~/Library/Application Support/Steam/steamapps/common/The Elder Scrolls III - Morrowind/Data Files/</code>
 
 
=====Wine=====
 
 
Users of other platforms running Wine can run Steam in that and find the "Morrowind.esm" file at <code>"~/.wine/drive_c/Program Files/Steam/SteamApps/common/Morrowind/Data Files/"</code>.
 
 
===Example Suite===
 
 
Example Suite is a demo showing the capabilities of the OpenMW engine. At this time, it requires Morrowind to be installed to run, but does not use any assets from it. In the future, it will be possible to run without installing Morrowind first.
 
 
# Install Morrowind (see above)
 
# [https://github.com/OpenMW/example-suite/releases Download the latest version]
 
# Follow the platform-specific instructions in the zip file's Installation.md file
 
 
==Common Problems==
 
 
===ERROR: Unknown fallback name: FontColor_color_header===
 
'''Symptoms'''
 
 
OpenMW crashes at startup with <code>ERROR: Unknown fallback name: FontColor_color_header</code> message at the end of openmw.log [https://wiki.openmw.org/index.php?title=Paths log file].
 
 
'''Cause'''
 
 
OpenMW configuration ([[Paths|openmw.cfg]]) is severely lacking and missing fallback values, since "Settings Importer" was not run correctly.
 
 
'''Fix'''
 
 
Re-run "Settings Importer" from OpenMW launcher.
 
 
===Installing game files via Steam on macOS: DISK WRITE ERROR===
 
'''Symptoms'''
 
 
Steam stages the download for Morrowind, but does not proceed. The download will read "Paused: DISK WRITE ERROR".
 
 
'''Fix'''
 
 
Open appmanifest_22320.acf in your favorite editor. Locate or create an entry under the "StateFlags" entry titled "installdir" and give it the value "Morrowind". Your file should now look something like this.
 
 
<pre>
 
"AppState"
 
{
 
        "appid"        "22320"
 
        "Universe"              "1"
 
        "name"          "The Elder Scrolls III: Morrowind"
 
        "StateFlags"            "4"
 
        "installdir"            "Morrowind"
 
 
        [other entries]
 
}
 
</pre>
 
 
Restart the Steam client. The download should now proceed.
 
 
[[Category:Installation]]
 
[[Category:Installation]]

Latest revision as of 03:51, 20 July 2018

Installation instructions have moved to our official documentation on ReadTheDocs.