A mirror of the official openmw repository
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.
 
 
 
 
 
 
Go to file
Evil Eye 90a1854848 Split Windows builds to a reusable workflow 3 weeks ago
.github/workflows Split Windows builds to a reusable workflow 3 weeks ago
CI Switch to downloading dependencies from Github releases 2 months ago
apps Merge branch 'dependenceday' into 'master' 3 weeks ago
cmake Remove no longer required FindRecastNavigation.cmake 5 months ago
components Work around a regression in MSVC 3 weeks ago
docker Don't install boost-filesystem anymore 2 years ago
docs Remove write nif debug log setting 1 month ago
extern Migrate videoplayer to OSG logging system 2 months ago
files Remove write nif debug log setting 1 month ago
manual/opencs Renormalise line endings 2 years ago
scripts Fix missing `y` 4 weeks ago
.clang-format Fix .clang-format and .clang-tidy 2 years ago
.clang-tidy Added a missing comma 2 years ago
.editorconfig Add CMake to .editorconfig 2 years ago
.git-blame-ignore-revs Ignore 88ec8a9523 for git blame 2 years ago
.gitignore Add Clangd cache to .gitignore 1 year ago
.gitlab-ci.yml Don't put the job ID in the MacOS dev build filename 2 months ago
.readthedocs.yaml Add Newline 1 year ago
.resubmitted_merge_requests.txt added !1471 3 years ago
AUTHORS.md updated authors and changelog 4 months ago
CHANGELOG.md Fix validating ESM3 file dependencies (#8252) 3 weeks ago
CMakeLists.txt Rearrange conditionals to be prettier 2 months ago
CONTRIBUTING.md Update CONTRIBUTING.md 7 months ago
LICENSE http to https for supported urls (#1625) 7 years ago
README.md Exterminate script blacklisting (#8214) 2 months ago

README.md

OpenMW

OpenMW is an open-source open-world RPG game engine that supports playing Morrowind by Bethesda Softworks. You need to own the game for OpenMW to play Morrowind.

OpenMW also comes with OpenMW-CS, a replacement for Bethesda's Construction Set.

Font Licenses:

Current Status

The main quests in Morrowind, Tribunal and Bloodmoon are all completable. Some issues with side quests are to be expected (but rare). Check the bug tracker for a list of issues we need to resolve before the "1.0" release. Even before the "1.0" release however, OpenMW boasts some new features, such as improved graphics and user interfaces.

Pre-existing modifications created for the original Morrowind engine can be hit-and-miss. The OpenMW script compiler performs more thorough error-checking than Morrowind does, meaning that a mod created for Morrowind may not necessarily run in OpenMW. Some mods also rely on quirky behaviour or engine bugs in order to work. We are considering such compatibility issues on a case-by-case basis - in some cases adding a workaround to OpenMW may be feasible, in other cases fixing the mod will be the only option. If you know of any mods that work or don't work, feel free to add them to the Mod status wiki page.

Getting Started

The data path

The data path tells OpenMW where to find your Morrowind files. If you run the launcher, OpenMW should be able to pick up the location of these files on its own, if both Morrowind and OpenMW are installed properly (installing Morrowind under WINE is considered a proper install).

Command line options

Syntax: openmw <options>
Allowed options:
  --help                                print help message
  --version                             print version information and quit
  --data arg (=data)                    set data directories (later directories
                                        have higher priority)
  --data-local arg                      set local data directory (highest
                                        priority)
  --fallback-archive arg (=fallback-archive)
                                        set fallback BSA archives (later
                                        archives have higher priority)
  --resources arg (=resources)          set resources directory
  --start arg                           set initial cell
  --content arg                         content file(s): esm/esp, or
                                        omwgame/omwaddon
  --no-sound [=arg(=1)] (=0)            disable all sounds
  --script-verbose [=arg(=1)] (=0)      verbose script output
  --script-all [=arg(=1)] (=0)          compile all scripts (excluding dialogue
                                        scripts) at startup
  --script-all-dialogue [=arg(=1)] (=0) compile all dialogue scripts at startup
  --script-console [=arg(=1)] (=0)      enable console-only script
                                        functionality
  --script-run arg                      select a file containing a list of
                                        console commands that is executed on
                                        startup
  --script-warn [=arg(=1)] (=1)         handling of warnings when compiling
                                        scripts
                                        0 - ignore warning
                                        1 - show warning but consider script as
                                        correctly compiled anyway
                                        2 - treat warnings as errors
  --load-savegame arg                   load a save game file on game startup
                                        (specify an absolute filename or a
                                        filename relative to the current
                                        working directory)
  --skip-menu [=arg(=1)] (=0)           skip main menu on game startup
  --new-game [=arg(=1)] (=0)            run new game sequence (ignored if
                                        skip-menu=0)
  --encoding arg (=win1252)             Character encoding used in OpenMW game
                                        messages:

                                        win1250 - Central and Eastern European
                                        such as Polish, Czech, Slovak,
                                        Hungarian, Slovene, Bosnian, Croatian,
                                        Serbian (Latin script), Romanian and
                                        Albanian languages

                                        win1251 - Cyrillic alphabet such as
                                        Russian, Bulgarian, Serbian Cyrillic
                                        and other languages

                                        win1252 - Western European (Latin)
                                        alphabet, used by default
  --fallback arg                        fallback values
  --no-grab                             Don't grab mouse cursor
  --export-fonts [=arg(=1)] (=0)        Export Morrowind .fnt fonts to PNG
                                        image and XML file in current directory
  --activate-dist arg (=-1)             activation distance override
  --random-seed arg (=<impl defined>)   seed value for random number generator