Installation Instructions: Difference between revisions

From OpenMW Wiki
Jump to navigation Jump to search
(→‎Steam: Adding Steam macOS)
(Moved to RTD and linked.)
 
(12 intermediate revisions by 4 users not shown)
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>
 
==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 it.
 
====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.
 
====Steam (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])
# Add the following into that file:
 
<code>
"AppState"
{
"AppID" "22320"
"Universe" "1"
"StateFlags" "1026"
}
</code>
 
The launch the Steam client and let it download. You can then find the "Morrowind.esm" file at <code>/Users/YOUR_USERNAME_HERE/Library/Application Support/Steam/steamapps/common/Data Files/"</code>
 
====Steam (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 severly lacking and missing fallback values, since "Settings Importer" was not run correctly.
 
'''Fix'''
 
Re-run "Settings Importer" from OpenMW launcher.


[[Category:Installation]]
[[Category:Installation]]

Latest revision as of 01:51, 20 July 2018

Installation instructions have moved to our official documentation on ReadTheDocs.