Skip to content

An OpenMW mod that lets you play the whole Elder Scrolls III: Morrowind as a top-down isometric game — with full online co-op or MMO modes.

C++
README

Isowind

Isowind

Isowind is an OpenMW mod that allows you to play the whole Elder Scrolls III: Morrowind as a top-down, isometric game. It includes a satisfying pixel art look for retro vibes, akin to early Diablo games. Full online co-op/MMO capabilities, using your own copy of Morrowind.

Isowind

What it is

  • A top-down camera. You play from above: W is always up the screen, and you aim weapons and spells at the mouse cursor while your legs run the way you move. The mouse wheel zooms; F7 switches to Morrowind's third and first person views and back.
  • Two looks. Pixel art draws the world at low resolution, with chunky pixels, retro textures built from your own Morrowind files, banded light and hard shadows. Normal is Morrowind's usual graphics.
  • Made for a mouse or a controller. The menus switch to suit whichever you are using. A controller gets its own menus, an on-screen keyboard, and quick keys on the bumpers.
  • Multiplayer. A port of TES3MP. Host a server from the launcher, as co-op (one shared world) or MMO (everyone has their own loot, quests and companions; enemies respawn; there are parties). A character can go between single-player and servers that allow it, and keeps everything gained in both.

How it works

Isowind is a fork of OpenMW 0.51, with these parts:

  • The engine (apps/, components/, files/shaders/) adds the top-down camera and the cutaway: shaders cut a circle out of whatever is in front of the player, and a second pass draws what was cut away, see-through, into that circle. It also adds the controller menus, the minimap that turns with the view, and TES3MP's multiplayer client.
  • The server (apps/openmw-mp) is TES3MP's server, ported to this engine. Its Lua CoreScripts are in isowind/server, with Isowind's MMO rules, parties, private companions and portable characters added.
  • The Isowind mod (isowind/mod, an .omwscripts content file) is OpenMW Lua: the controls, aiming, the view switch, the hover rings and the interface tweaks.
  • The looks are two OpenMW profiles (isowind/profiles/pixelart, normal), each with its own openmw.cfg, settings.cfg and post-processing chain. The pixel art textures are made on your own computer, from your own Morrowind files, the first time you play that look (isowind/tools/retro_textures.py).
  • The launcher (Isowind.exe, or isowind.sh on Linux) picks the look and the character, joins or hosts servers, and runs the engine with the right profile.

Dependencies

To play on Windows

  • 64-bit Windows 10 or 11.
  • Morrowind, the Game of the Year edition (with Tribunal and Bloodmoon), from Steam or GOG. It doesn't need to have been run, or to have mods installed.
  • The Microsoft Visual C++ Redistributable (2015-2022, x64), which the engine is built with. Most PCs have it already, as many games install it; if the game says MSVCP140.dll or VCRUNTIME140.dll is missing, install it.
  • .NET Framework 4, for Isowind.exe. Windows 10 and 11 come with it.
  • Graphics drivers with OpenGL, as for any OpenMW.

To play on Linux

  • 64-bit Linux, about as new as Ubuntu 24.04 or newer: the package is built there, and each release's notes give the oldest glibc it runs on. The package carries the engine's own libraries (OpenSceneGraph, MyGUI, Bullet, SDL, Boost and the rest) and uses the system's C and C++ runtimes, graphics, X11 and font libraries, which every desktop distribution has.
  • Morrowind, the Game of the Year edition, from Steam or GOG. A Steam copy is found by itself, in any of your Steam libraries; a GOG one is pointed to once.
  • Python 3, for the pixel art look. If Pillow isn't installed, isowind.sh fetches it into the package's own folder, which on Debian and Ubuntu needs python3-venv.
  • Python's Tk, for the launcher window (python3-tk on Debian and Ubuntu, tk on Arch and Fedora). The terminal commands (./isowind.sh, ./isowind.sh join ADDRESS and the rest) work without it.
  • Graphics drivers with OpenGL (Mesa, or your graphics card maker's).

To play online

  • Morrowind, Tribunal and Bloodmoon, with no other mods on: a server only lets in players whose game files match its own.
  • The same Isowind release as the server. Windows and Linux players of one release play together; players on different releases can't.
  • To host, UDP port 25565 (or the port you choose) forwarded to your computer by your router.

To build it yourself, see Building on Windows and Building on Linux, which list what each needs.

First time setup

You need your own Morrowind and a 64-bit Windows or Linux PC; Dependencies has the full list. Morrowind doesn't need to be run first, or have mods installed.

  1. Download Isowind.zip from the Releases page and unzip the whole folder somewhere you can write to, such as your Desktop or D:\Games\Isowind (not Program Files).
  2. Run Isowind.exe. Windows may warn that the app is unrecognised (it isn't signed): click More info, then Run anyway.
  3. Press Play. The first time, Isowind sees that OpenMW doesn't know where Morrowind is yet. It says so and opens the OpenMW launcher, which starts its first-run wizard:
    1. Choose your language and Next.
    2. Choose Existing installation. Morrowind is already installed, and the wizard only needs to find it.
    3. Pick your Morrowind in the list. Steam and GOG installs are usually found. If yours isn't listed, press Browse... and select Morrowind.esm in Morrowind's Data Files folder. On Steam that is usually C:\Program Files (x86)\Steam\steamapps\common\Morrowind\Data Files.
    4. On Import Settings, leave Import Settings From Morrowind.ini and Import Add-on and Plugin Selection ticked. The bitmap fonts option can stay off.
    5. Finish. In the OpenMW launcher, check on the Data Files page that Morrowind.esm, Tribunal.esm and Bloodmoon.esm are ticked, and tick any that aren't. If Morrowind has never been run, its Morrowind.ini may not list them yet. Then close the launcher. You don't need to press its own Play.
  4. Back in Isowind.exe, pick a look and press Play again. The first time you play the pixel art look, Isowind builds its low-res textures from your Morrowind files. That takes a minute, and later starts are immediate.
  5. Choose New character, or a character you already have, and play.

You can open the OpenMW launcher again at any time with the OpenMW Launcher button in Isowind.exe, to change the Morrowind folder, mods or other options. Your saves are shared with any normal OpenMW you have.

On Linux, download isowind-linux-x86_64.tar.gz from the same page instead, unpack it (tar -xzf isowind-linux-x86_64.tar.gz) and run ./isowind.sh in the Isowind folder from a terminal (or ./isowind.sh gui for a launcher window). It is built on Ubuntu 24.04, so it wants a distribution about as new or newer. It finds Morrowind in your Steam libraries, those on other drives and a Steam Deck's SD card too, and sets OpenMW up by itself. If it can't, run it as MORROWIND=/path/to/Morrowind ./isowind.sh, giving the folder with Data Files in it. The pixel art look needs Python 3.

Playing online: keep to Morrowind, Tribunal and Bloodmoon, with no other mods on in the OpenMW launcher, because a server only lets in players whose game files match its own. Type the server's address under Multiplayer in Isowind.exe and press Join, or press Host a server to run one. README.txt in the package covers hosting, parties, portable characters and the controls in full.

If something goes wrong: the game's log is profiles\pixelart\openmw.log (or profiles\normal\openmw.log). If saving fails, Windows Defender's Controlled folder access may be stopping engine\openmw.exe from writing to Documents: allow it under Windows Security > Ransomware protection.

Building on Windows

isowind\windows\build.ps1 does the whole chain: CrabNet (the multiplayer networking), OpenMW's dependency pack, the engine, Isowind.exe and the package. A release's zip is built the same way, by .github/workflows/windows.yml (see Releases).

You need, on the PATH:

  • Git for Windows (its bash runs OpenMW's dependency script)
  • CMake
  • Visual Studio 2022 with the "Desktop development with C++" workload (2026 works, with -VsVersion 2026)
  • Python 3 (python.org or the Microsoft Store), for the launcher's icon; Pillow is installed for you if it is missing
  • 7-Zip, unless you are on Windows 11, whose own tar.exe extracts the dependency pack

Clone the repository into a folder of its own. Everything that isn't source goes beside the repository, in its parent folder (<root>):

<root>\
    <repository>\             this clone; the engine builds in MSVC2022_64 inside it
    crabnet\                  cloned and built by the script
    dist\Isowind\             the package, and dist\Isowind.zip beside it
    backups\                  test characters and saves, zipped before each packaging (the last five)

Then, in PowerShell, from the repository:

Set-ExecutionPolicy -Scope CurrentUser RemoteSigned   # once, if PowerShell refuses to run scripts
.\isowind\windows\build.ps1

The first run clones and builds CrabNet, downloads and unpacks the dependency pack, configures and builds the engine (the final link with link-time optimisation alone takes ten to twenty minutes), compiles Isowind.exe and packages. Later runs are incremental; after pulling changes:

.\isowind\windows\build.ps1 -SkipDependencies

The engine ends up in MSVC2022_64\Release, Isowind.exe in MSVC2022_64\launcher, and the package in <root>\dist\Isowind with <root>\dist\Isowind.zip beside it.

Rebuilding keeps the test characters. The server's players, cells and world (dist\Isowind\server\CoreScripts\data) and the host's server\tes3mp-server.cfg stay in the package folder; single-player saves are in Documents\My Games\OpenMW\saves, which packaging never touches. make_package.ps1 still zips both into <root>\backups\isowind-data-<date>-<time>.zip first, and keeps the last five. The zip takes the server's data from git (the empty folders and the default ban and plugin lists), so it never carries anyone's characters. To update a copy elsewhere (Bottles, another PC), unzip the new Isowind.zip over the old folder rather than deleting the folder: the players stay, and only the ban list goes back to empty.

Switch What it does
-SkipDependencies Doesn't check or re-extract the dependency downloads. Use it on every build after the first.
-NoLto No link-time optimisation: the final link takes a minute or two instead of ten to twenty. The game runs a little slower, so it is for working on the code, not for a release.
-SkipLauncher Doesn't build Isowind.exe.
-SkipPackage Doesn't run make_package.ps1.
-Clean A fresh build folder instead of keeping the existing one.
-Configuration Debug Release (the default), Debug or RelWithDebInfo. Only a Release build is packaged.
-VsVersion 2026 Visual Studio 2026 instead of 2022; the build folder is then MSVC2026_64.

The pieces, if you need one on its own:

  • make_package.ps1 assembles <root>\dist\Isowind from MSVC2022_64\Release, the mod, the pixel art, profiles, server, licenses, README.txt and the GPL source patch against OpenMW's openmw-0.51.0 tag (fetched if the clone lacks it), then zips it. It finds the repository from its own location.
  • make_icon.py draws the icon; Isowind.cs compiles with .NET Framework 4's csc.exe, which comes with Windows, with logo.png (the launcher's logo) embedded as a resource.

If something goes wrong:

  • RakNet not found at configure: the script lays CrabNet out as <root>\crabnet\root (include\raknet, lib\RakNetLibStatic.lib, lib\RakNetLibStaticd.lib) and sets RAKNET_ROOT to it, which cmake\FindRakNet.cmake honours; without a debug library the release one serves Debug too.
  • Windows Defender quarantines openmw.exe: a fresh, unsigned binary can trip its heuristics. Restore it from Protection history, exclude <root> in Windows Security, and report the file to Microsoft as a false positive. The zip step fails while the file is quarantined.

Building on Linux

The same steps as .github/workflows/linux.yml, which makes a release's Linux package on Ubuntu 24.04 (see Releases). Everything that isn't source goes in build-deps/ and build/ inside the clone (git ignores both).

1. The libraries and tools.

  • Debian / Ubuntu: sudo CI/install_debian_deps.sh gcc openmw-deps openmw-deps-dynamic
  • Arch: sudo pacman -S --needed base-devel cmake git boost openscenegraph mygui sdl2-compat openal ffmpeg luajit lz4 icu sqlite yaml-cpp recastnavigation unshield

To play you also want Python 3 with Tk for the launcher window (python3-tk / tk) and Pillow for the pixel art look (python3-pil / python-pillow; without it isowind.sh installs it into a private folder of its own). To package: linuxdeploy on the PATH (its AppImage; set APPIMAGE_EXTRACT_AND_RUN=1 if FUSE is missing).

2. CrabNet, the multiplayer's networking, at the commit the Windows build uses:

git clone https://github.com/TES3MP/CrabNet.git build-deps/crabnet
git -C build-deps/crabnet checkout 19e6619
sed -i '1i #include <cstdint>' build-deps/crabnet/Source/Utils/_FindFirst.h   # newer compilers want it
cmake -S build-deps/crabnet -B build-deps/crabnet/build -DCMAKE_BUILD_TYPE=Release -DCRABNET_ENABLE_DLL=OFF \
    -DCRABNET_ENABLE_SAMPLES=OFF -DCMAKE_POSITION_INDEPENDENT_CODE=ON -DCMAKE_POLICY_VERSION_MINIMUM=3.5
cmake --build build-deps/crabnet/build -j$(nproc)

3. The engine (the game, the server and the importer; not the editor, launcher or tools):

cmake -S . -B build -DCMAKE_BUILD_TYPE=Release \
    -DBUILD_OPENCS=OFF -DBUILD_BSATOOL=OFF -DBUILD_ESMTOOL=OFF -DBUILD_ESSIMPORTER=OFF -DBUILD_NIFTEST=OFF \
    -DBUILD_NAVMESHTOOL=OFF -DBUILD_BULLETOBJECTTOOL=OFF -DBUILD_LAUNCHER=OFF -DBUILD_WIZARD=OFF \
    -DRakNet_INCLUDES=$PWD/build-deps/crabnet/include \
    -DRakNet_LIBRARY_RELEASE=$PWD/build-deps/crabnet/build/lib/libRakNetLibStatic.a \
    -DRakNet_LIBRARY_DEBUG=$PWD/build-deps/crabnet/build/lib/libRakNetLibStatic.a \
    <your system's options, below>
cmake --build build -j$(nproc)
  • Debian / Ubuntu: -DUSE_SYSTEM_TINYXML=ON -DOPENMW_USE_SYSTEM_RECASTNAVIGATION=ON
  • Arch: -DUSE_SYSTEM_TINYXML=OFF -DOPENMW_USE_SYSTEM_BULLET=OFF -DCMAKE_POLICY_VERSION_MINIMUM=3.5. Arch has no TinyXML package, its Bullet is built for single precision where OpenMW wants double (so OpenMW builds its own), and CMake 4 wants the policy minimum for the older projects OpenMW pulls in.

build/openmw and build/tes3mp-server are the game and the server.

4. The package, laid out like the Windows one with isowind.sh in place of Isowind.exe:

isowind/linux/package.sh build build-deps/Isowind

5. Play: build-deps/Isowind/isowind.sh (or isowind.sh gui for the launcher window; isowind.sh normal, isowind.sh join ADDRESS and isowind.sh host are the others, and --controller or --no-controller among the arguments says whether the menus are made for a controller). The first time it looks for Morrowind in Steam's libraries; otherwise run it as MORROWIND=/path/to/Morrowind build-deps/Isowind/isowind.sh, the folder with Data Files and Morrowind.ini.

After changes, cmake --build build -j$(nproc) and package.sh again. Packaging into the same folder again keeps its server data and server/tes3mp-server.cfg, as on Windows, after backing them and ~/.local/share/openmw/saves up into ~/.local/share/isowind/backups (the last five); a release goes into a new folder, as the CI's does. package.sh refuses a folder that has files in it and isn't a package. While working on the code, a package's engine/usr/bin/openmw and tes3mp-server can be links to the ones in build/, so that a rebuild needs no packaging; the server's CoreScripts are a copy, though, and must be refreshed after server script changes.

Playing with others takes the same engine source. The version players are matched on is a hash of the engine's folders (apps, components, files, extern, cmake, CMakeLists.txt) as committed, taken each time the build runs, so build again after committing or pulling engine changes, even when the code on disk was already built. Isowind's mod and server scripts don't count.

Releases

A release is made by merging a branch named for it into main: alpha-v1.0.1a makes Alpha v1.0.1a, and beta-v2.0 makes Beta v2.0. The name is alpha or beta, then the version (git branch names can't have spaces). Open a pull request from the branch and merge it, and .github/workflows/release.yml:

  1. drafts the release, with a tag named like the branch (alpha-v1.0.1a);
  2. builds the Windows zip (windows.yml: build.ps1 -NoMods on Windows Server 2022, which takes a few hours) and the Linux package (linux.yml, on Ubuntu 24.04) from the merge, and puts them on it;
  3. checks that both have the same multiplayer version hash, and publishes it, with notes on what each needs.

Both packages are without the bundled mods and have the source folder. Until it is published, the release is a draft that only the repository's writers can see. If a build fails, fix it and run the workflow again by hand with the same version: Actions > Release > Run workflow, or gh workflow run release.yml -f version=alpha-v1.0.1a (add -f ref=COMMIT to build something other than main as it is). A version that is already out is refused, so the next one needs a new branch. Pull requests from other branches make no release.

A release made before this can get a missing build by running linux.yml or windows.yml by hand with its tag. Alpha v1.0's Windows zip was built before the tag's last engine change was committed, so it has an older version hash, and its Linux package has to be given that hash (line 2 of the zip's engine/resources/version) to play with it:

gh workflow run linux.yml -f tag=alpha -f version_hash=f121921aec71faa8d63c3a6739b97f9d36048f68

Untick attach (-f attach=false) to try a build first: the package is then the run's artifact, for a week.

Controls

The defaults; Options > Controls rebinds them (and Options > Scripts > Isowind the view switch).

Keyboard and mouse, in the game

Key What it does
W A S D Move (W is always up the screen). Running is the default
Shift Walk, while held
Caps Lock Always run on or off
Mouse Move the cursor. With a weapon or spell ready you aim at it while your legs run the way you move
Left click Attack / cast when ready, otherwise use what is under the cursor (doors, people, chests, items)
Right click Power attack: your weapon's strongest attack type
E Use what is under the cursor, or the nearest thing in front of you (indoors, a person or a door before the things lying between; never something on the floor below or above). A locked door or chest you have no key to: a go at picking it, with a lockpick carried
Space Jump. In water, hold it to swim up
Ctrl Sneak. In water, hold it to dive
F / R Ready weapon / ready magic
[ / ] Previous / next weapon
- / = Previous / next spell
1 - 0 Quick keys, shown along the bottom of the screen
F1 Morrowind's quick key menu
Mouse wheel Zoom, within the view you are in
F7 Switch view: top-down, then third person, then first person
Middle mouse held With camera rotation on (Options > Scripts > Isowind): move the mouse to turn the view
Tab Inventory
J Journal (the inventory screen's last page)
T Rest
Esc Menu
F5 / F9 Quick save / quick load
F11 / F12 Hide the HUD / screenshot
` Console (the key left of 1)

Click to move (asked the first time you play; Options > Scripts > Isowind changes it)

Key What it does
Right click On the ground: run there (a red X splashes onto the spot). Hold it to keep steering toward the cursor. Stairs can be clicked from any side
Right click On a person or a thing: walk right up to it and use it (talk, pick up, open)
Left click As without click to move: attack / cast where you stand, otherwise use what is under the cursor. The power attack is then on a controller's left trigger only
Shift Stand still while held (instead of walking): you keep aiming and attacking, but no click (or WASD) moves you

Options > Scripts > Isowind can put click to move on the left button instead: then a left click on a hostile creature with a weapon or spell ready walks into range and attacks (hold to keep attacking; bows, thrown weapons and target spells stop short, with a clear shot), Shift + left click attacks where you stand, and right click power attacks as usual.

Drawing a bow or crossbow (or readying a throw), or having a spell cast at a target ready, draws a thin line a few metres out from your character the way they aim, a small ring at its end. With click to move, right click only moves and uses things: it never attacks. | Left / right arrow | With camera rotation on: turn the view | | W A S D | Still move, and take over from a click |

Keyboard and mouse, in the menus

Key What it does
Q / E Previous / next page of the inventory screen (Map, Inventory, Magic, Stats, Journal), or tab in Options. Z / C turn the journal's pages
Z / C Previous / next tab inside a window: the kinds of item in the inventory or a shop, a chest's containers opened together, the local or world map, in Options the Video tab's (Detail Level, Water, Lights) and the Controls tab's mouse and keyboard / controller. With a chest or shop open, the window under the pointer
Click a tab That page. The HUD's bars, weapon, spell and minimap go to theirs too
1 - 0 Over an item, spell or enchanted item: puts it on that quick key
Drag onto a slot An item dragged onto a quick key slot along the bottom goes on that key
Right click a slot Morrowind's quick key menu for that slot
Mouse wheel Over the minimap: zoom it
Tab / Esc Close

Q / E and Z / C type as usual in a text box.

Controller, in the game (it takes over as soon as a stick or button is used, the mouse as soon as it moves)

Button What it does
Left stick Move
Right stick Aim, or point at what X uses
A Jump. In water, hold it to swim up
B Ready weapon
X Use / talk: what the right stick points at, or else the nearest thing (indoors, a person or a door before the things lying between). A lock is picked, as with E
Y Ready magic
Right trigger Attack / cast
Left trigger Power attack
Bumpers Previous / next quick key
D-pad up / down Zoom (hold to keep going)
D-pad left / right With camera rotation on (Options > Scripts > Isowind): turn the view, held
Start Menu
Back Inventory (hold: journal, the inventory screen's last page)
Left stick in Sneak. In water, hold it in to dive
Right stick in Rest

Controller, in the menus

Button What it does
D-pad, A Choose
B Back
Bumpers The inventory screen's pages; with a chest or shop open, between its window and yours; Options' tabs
Triggers The tabs inside a window, and in Options inside a tab (Video's; Controls' mouse and keyboard / controller)
Right stick in An item's info
Y In the inventory and magic pages: puts the item or spell on a quick key
X On a text box (moved onto with the D-pad): a keyboard on the screen. Start or Back puts it away

Whether the menus are made for a controller is decided as the game starts: Isowind.exe's Controller tick box, or on Linux what is plugged in, which --controller or --no-controller overrides (a controller that comes with a stream, as Moonlight's does, wants --controller).


~ This mod was made with AI and tested by humans. ~