Modding-OpenMW.com

Users' Guide

How do you use this website? How do you get the most out of all the information presented here? This page should answer those questions and more!

Quickstart

Below is a quick, high-level overview of this website's workflow:

  1. Purchase Morrowind if needed
  2. Install Morrowind and OpenMW
  3. Successfully run vanilla Morrowind via OpenMW with no mods or settings changes
  4. Configure your mod and Morrowind install paths on the user settings page. You can also opt into mods and mod features that require an OpenMW Dev Build
  5. Choose a mod list (each are listed and described below)
  6. Run the "folder deploy" script, which will create folders for each mod in your list and any additional folders that might otherwise need to be manually made
  7. Check out our fully annotated example mod detail page to learn how to read the information on each mod page
  8. We DO NOT recommend using mod managers like Mod Organizer 2 with this website's mod lists. For basic users, Mod Organizer 2 simply takes more time and effort to set up properly than by just following the instructions on this website. Refer to our Tooling FAQ to read more.
  9. Begin the mod list you've chosen:
    • Go through each mod, one at a time
    • Use the Download Link to download the mod
    • Use an archive extractor tool such as 7zip to extract the files to their designated directory provided by the Data Paths on each page.
    • Keep an eye out for any additional files you must download or extra instructions you must follow documented in the Usage Notes on some pages
    • Sometimes a mod's description on Nexus may have different usage information than our usage notes -- please stick with what we advise. This is because many of the mod lists on this website are large and complex and may require different instructions for everything to work together. It is vitally important that you DO NOT enable every plugin from every mod!
    • Click on the Enable For CFG Generator button after you've installed a mod and move onto the next mod in the list
    • At any time, you can visit the CFG Generator page to get a customized cfg that matches your progress (handy for testing as you go, more on that below)
    • Once you are finished with a mod list, you will be taken to its 'Final Steps' page which will instruct you on using the CFG Generator and also the tools you need to run before you can start playing
  10. The command-line tools you'll need to use are listed below:
    • The mod lists on this website require you to manually clean some plugins with tes3cmd
    • One of the final steps will be to run DeltaPlugin to produce a merged objects plugin
    • Many of our lists use Groundcoverify to produce a plugin and assets that convert static grass to actual groundcover for a performance gain
    • The final command-line tool many of our lists use is waza_lightfixes, which tweaks lights in many ways making them more atmospheric (it's also configurable)
    • openmw-validator is a tool that's optional, but it will help you catch mistakes in your openmw.cfg file
    • The usage notes for these tools are all documented on each mod list's Final Steps page

Feel free to refer back to this list if you need a reminder about what to do, and please continue to read more about all of the above.

Table of contents

Setup Steps

One must of course buy a copy of Morrowind and install OpenMW.

Note that Android is not officially supported by the OpenMW project or this website, and that version handles content management differently than every other version so a lot of what's talked about on this website may not apply.

Once you have Morrowind installed you will need to decide whether you want to install the latest stable version of OpenMW, or the latest development build. The development build may be in the early stages of development and may have bugs. If you decide to use the development build, however, you can opt-in to several mods that take advantage of the latest features in development. You can always find the list mods that require the development build using the Tags link on the bottom of every page on the site.

OpenMW Stable installer instructions:

OpenMW Development Build installation instructions

Once you've got OpenMW installed and are able to run vanilla Morrowind, you can also take a look at the various settings. Some settings are available directly in the launcher and others must be added to your settings.cfg file. It is vitally important that you DO NOT edit the settings.cfg file while the launcher is open, and also DO NOT open the launcher while the settings.cfg file is still open.

Your User Settings

Visit the user settings page and enter values for your Base Folder; that is where you want to install mods to; and your vanilla Morrowind Data Files folder. This allows the website to give you paths that reflect what will actually be on your computer, allowing for the copy-paste snippets provided by the CFG Generator (more on that below).

Below those fields there is a checkbox you can check if you want to opt-in to the development build mods which take advantage of OpenMW's latest features in development. Please be mindful that the development build and any development build mods may contain bugs or otherwise negatively impact your experience. By default, users are opted out of any development build mods.

There are also options to toggle the website's built-in Dark and Light modes, or to clear your site data if the need arises.

Choose A Mod List

Browse the catalogue of mod lists and pick one that sounds good to you. Although many mods depend on something else to function properly, the majority of mods in most lists can be skipped or swapped for an alternate if desired. Please note that the larger mod lists do take quite a bit more time and effort to set up properly and are generally not recommended for first-time players of Morrowind. Check out Just Good Morrowind or I Heart Vanilla for a much faster and more vanilla-friendly experience.

Below is a list of the main mod lists and their descriptions:

Folder Deploy Script

After you choose a mod list, generate and run your folder deploy script using the instructions below. In order for this to work correctly you must have already set your User Settings.

Choose a mod list and your operating system and click Submit to generate your script:

IMPORTANT! Windows users will need to navigate to the directory they downloaded this script to and Shift+Right-click the folder to bring up the context menu. Click Open Powershell window here and type the following command, replacing the file name to reflect the script you downloaded:

Powershell.exe -executionpolicy bypass -File .\momw-folder-generator-MODLIST-NAME-HERE.ps1

Now that you have your folders deployed, installing mods is as simple as downloading them and extracting the contents into their designated directory.

Reading A Mod Detail Page

Each mod detail page has two tables of information. The top table includes general information about the mod and the bottom table contains instructions for installation. This example page details what each field contains. Feel free to open this page on a separate browser tab in case you need a reminder. This example page is also easily accessible on each mod detail page itself if you need it later on.

It's important at this point for users of mod lists to ensure they have set their User Settings set. Doing this will ensure that all the folder data paths on each of these mod detail pages will reflect your own. For your own convenience, these same folder data paths are provided by the Folder Deploy Script.

These folder data paths are where you will extract the mod files into. Also, you'll see which plugins need to be enabled from each mod and any usage notes that contain further instructions you need to follow. Users following mod lists don't need to do anything with the plugins aside from ensuring they are located in their designated folder data path.

Once you have installed the mod on your system be sure to hit the Enable for CFG Generator button in order to keep track of your progress and also to generate custom CFG Generator output. This can be useful if you want to test your progress at any point during installation.

Testing Your Progress

It is important to keep in mind that some mods require assets from other mods you install later on, so it is expected for minor issues to occur before the list has been completed, but testing along the way is still a good way to make sure mods are enabled and that there are no errors in your operating procedure.

Before testing, use the CFG Generator to apply the correct load order to your openmw.cfg, you will need to do this every time you test as the launcher may disable entries that, while currently invalid, will not be invalid on subsequent tests. You will need to remove (or comment out with #) groundcover entries until you have installed them, as they will cause OpenMW to crash if they are not installed.

Using The CFG Generator

The CFG Generator will provide you with personalized lines for your mod list that you will need to copy-and-paste into your openmw.cfg and settings.cfg files in order for the mod list to function properly. It is vitally important that you DO NOT edit the openmw.cfg or the settings.cfg file while the launcher is open, and also DO NOT open the launcher while those files are still open.

Note that the CFG Generator creates a complete list of plugins that you should have enabled once you have gone through a mod list and finished its Final Steps. Once you finish copy-and-pasting you may have data=, content=, and groundcover= lines for mods you've not installed yet. If you haven't installed those mods yet, it is important that you remove those lines or comment them out by placing a # at the start of the line until you do install those mods.

Final Steps & Verification

Each mod list has a "Final Steps" page (Expanded Vanilla's final steps page, as an example) that has you use the CFG Generator and any tools required by the mod list to function correctly. You will also validate your files to ensure you've installed everything correctly and clean any plugins that require it.

Further Reading

A few pages that you'll want to reference while on your modding journey:

Upcoming Changes

Wondering if there's going to be an update soon? Want to know what's being worked on with this website? All changes to the website go out to the beta site first, but you can also refer to the GitLab activity log to see what's been going on with the project.

What's Next?

From here, if you've got further interest in the community - or simply need to report a problem or ask questions - come hang out in the project Discord or IRC channels and discuss all things related to this project, OpenMW, and Morrowind modding in general.

Please also feel free to check the project Twitch stream. The website creator streams twice a week and works on improving and updating the website.

There's also the project issue tracker on GitLab where you can view existing issues or file a new one if you find something that needs to be fixed or updated.

This website's mod lists and content receive regular updates, including each week on the regular project stream, so be sure to check the mod list and website changelogs often. And happy modding!

Getting Started Tips Mod List Changelogs Website Changelog CFG Generator Name Generator About FAQ Resources Developers' Guide Subscribe Issue Tracker MOMW On Discord #momw On IRC MOMW On GitLab
Settings
GPLv3 logo