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++

The bundled mods only when you have them: a plain build is the public package

pw-tf3674311a2d8d
diff --git a/README.md b/README.md
index a8031cc..8f91456 100644
--- a/README.md
+++ b/README.md
@@ -98,8 +98,8 @@ You need, on the PATH:
* 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
-* GitHub CLI, logged in (`winget install GitHub.cli`, then `gh auth login`), for the bundled mods: they come from
- this repository's private `bundled-mods` release. Or put the mod folders in `<root>\bundled-mods` yourself.
+* Only for the bundled mods (see below): GitHub CLI, logged in (`winget install GitHub.cli`, then `gh auth login`)
+ with access to this repository's private `bundled-mods` release
* 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
@@ -108,7 +108,7 @@ parent folder (`<root>`):
<root>\
<repository>\ this clone; the engine builds in MSVC2022_64 inside it
crabnet\ cloned and built by the script
- bundled-mods\ the third-party mods, fetched by the script
+ bundled-mods\ the third-party mods, if you have them (-WithMods fetches them)
dist\Isowind\ the package, and dist\Isowind.zip beside it
backups\ test characters and saves, zipped before each packaging (the last five)
@@ -118,14 +118,25 @@ Then, in PowerShell, from the repository:
.\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`,
-fetches the bundled mods and packages. Later runs are incremental; after pulling changes:
+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.
+**The bundled mods.** By default the package is plain OpenMW with Isowind on top, as released here. The developers'
+builds also carry a set of third-party mods (Rafael's Shader Pack, Weapon Sheathing, Questman, the Morrowind
+Optimization Patch and others), which aren't in git and can't all be passed on. With access to the repository's
+private `bundled-mods` release, fetch them once:
+
+ .\isowind\windows\build.ps1 -SkipDependencies -WithMods
+
+They go in `<root>\bundled-mods`, and every build after that packages them, with no switch needed. Packaging prints
+which kind it is making. To make a release from a machine that has them, add `-NoMods`: that package goes in
+`<root>\dist\nomods\Isowind` and `<root>\dist\nomods\Isowind.zip`, leaving your usual one alone.
+
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
@@ -138,7 +149,8 @@ the players stay, and only the ban list goes back to empty.
|-------------------------|------------------------------------------------------------------------------------------------|
| `-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. |
-| `-NoMods` | Packages without the bundled third-party mods, in `<root>\dist\nomods\Isowind` and `<root>\dist\nomods\Isowind.zip`: plain OpenMW with Isowind on top, as released on GitHub. Needs no GitHub CLI login. |
+| `-WithMods` | Fetches the bundled mods into `<root>\bundled-mods` if they aren't there yet (needs the GitHub CLI and access to the private release). Builds after that have them anyway. |
+| `-NoMods` | Packages without the bundled mods even though `<root>\bundled-mods` is there, in `<root>\dist\nomods\Isowind` and `<root>\dist\nomods\Isowind.zip`: the public 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. |
@@ -147,7 +159,7 @@ the players stay, and only the ban list goes back to empty.
The pieces, if you need one on its own:
-* `make_package.ps1` assembles `<root>\dist\Isowind` from `MSVC2022_64\Release`, the mod, the bundled mods, the
+* `make_package.ps1` assembles `<root>\dist\Isowind` from `MSVC2022_64\Release`, the mod, the bundled mods if any, 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,
@@ -161,7 +173,8 @@ If something goes wrong:
* **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.
-* **No bundled mods**: `gh auth login` and build again, or put the mods in `<root>\bundled-mods`.
+* **No bundled mods** when you expected them: `gh auth login` and build with `-WithMods`, or put the mods in
+ `<root>\bundled-mods` yourself.
Building on Linux
-----------------
@@ -178,7 +191,8 @@ source goes in `build-deps/` and `build/` inside the clone (git ignores both).
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](https://github.com/linuxdeploy/linuxdeploy/releases) on the PATH (its AppImage; set
-`APPIMAGE_EXTRACT_AND_RUN=1` if FUSE is missing), and the GitHub CLI logged in (`gh auth login`) for the bundled mods.
+`APPIMAGE_EXTRACT_AND_RUN=1` if FUSE is missing), and, only for the bundled mods, the GitHub CLI logged in
+(`gh auth login`) with access to their private release.
**2. CrabNet**, the multiplayer's networking, at the commit the Windows build uses:
@@ -209,6 +223,11 @@ package: [linuxdeploy](https://github.com/linuxdeploy/linuxdeploy/releases) on t
**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
+
+That is the package without the bundled mods, as released. With access to their private release, the developers'
+package has them:
+
gh release download bundled-mods -p bundled-mods.zip -D build-deps
unzip -q build-deps/bundled-mods.zip -d build-deps/bundled-mods
isowind/linux/package.sh build build-deps/Isowind build-deps/bundled-mods
diff --git a/isowind/windows/build.ps1 b/isowind/windows/build.ps1
index d32b2b9..c930aa9 100644
--- a/isowind/windows/build.ps1
+++ b/isowind/windows/build.ps1
@@ -4,8 +4,9 @@
# Everything is in the repository (isowind\windows: this script, Isowind.cs, logo.png and make_icon.py for the
# launcher, make_package.ps1), and the rest goes beside the repository, in the folder it is checked out into (<root>):
# <root>\crabnet\ the multiplayer networking library, cloned and built here
-# <root>\bundled-mods\ the third-party mods (make_package.ps1 wants them); fetched from this repository's
-# "bundled-mods" release (bundled-mods.zip, as the Linux CI does) when the folder is missing
+# <root>\bundled-mods\ the third-party mods, packaged when the folder is there (otherwise the package goes
+# without them, as for a public release); -WithMods fetches it from this repository's
+# private "bundled-mods" release (bundled-mods.zip, as the Linux CI does)
# <root>\dist\ the package. Rebuilding keeps what testing it made (the server's players and world,
# the host's settings); the zip never has them
# <root>\backups\ those and the single-player saves (Documents\My Games\OpenMW\saves), zipped by
@@ -22,8 +23,10 @@
# .\build.ps1 -SkipDependencies don't check or re-extract OpenMW's dependency downloads (faster once they're there)
# .\build.ps1 -SkipLauncher no Isowind.exe
# .\build.ps1 -SkipPackage no dist\Isowind.zip
-# .\build.ps1 -NoMods the package without the bundled mods, for a public release: dist\nomods\Isowind.zip
-# (bundled-mods isn't fetched; see make_package.ps1)
+# .\build.ps1 -WithMods fetches the bundled mods into <root>\bundled-mods if they aren't there yet (needs
+# access to the repository's private release); every build after that has them
+# .\build.ps1 -NoMods the package without the bundled mods even when they are there, for a public
+# release: dist\nomods\Isowind.zip (see make_package.ps1)
# .\build.ps1 -NoLto no link-time optimisation: the final link takes a minute or two instead of ten to
# twenty (the game runs a little slower; for working on it, not for a release)
# .\build.ps1 -Configuration Debug -VsVersion 2026
@@ -36,6 +39,7 @@ param(
[switch]$SkipDependencies,
[switch]$SkipLauncher,
[switch]$SkipPackage,
+ [switch]$WithMods,
[switch]$NoMods,
[switch]$NoLto
)
@@ -181,12 +185,10 @@ if (-not $SkipPackage) {
if (-not (Test-Path $package)) { Write-Warning "No ${package}: nothing packaged" }
elseif ($Configuration -ne 'Release') { Write-Warning "make_package.ps1 packages $buildDir\Release; this was a $Configuration build, so it isn't run" }
else {
- # The bundled mods are third-party and kept out of git: the "bundled-mods" release holds them, as for the Linux CI
+ # The bundled mods are third-party and kept out of git: the "bundled-mods" release holds them, as for the Linux
+ # CI. Packaged when <root>\bundled-mods is there; fetched only when asked for
$mods = Join-Path $root 'bundled-mods'
- if ($NoMods) {
- & $package -NoMods
- }
- elseif (-not (Test-Path $mods)) {
+ if ($WithMods -and -not $NoMods -and -not (Test-Path $mods)) {
$zip = Join-Path $root 'bundled-mods.zip'
Write-Host "Fetching the bundled mods (bundled-mods.zip from the repository's bundled-mods release)..."
# (the repository is private, so this needs GitHub's CLI, logged in: gh auth login)
@@ -198,7 +200,7 @@ if (-not $SkipPackage) {
Expand-Archive -Path $zip -DestinationPath $mods -Force
Remove-Item $zip -Force
}
- if (-not $NoMods) { & $package }
+ if ($NoMods) { & $package -NoMods } else { & $package }
}
}
diff --git a/isowind/windows/make_package.ps1 b/isowind/windows/make_package.ps1
index c27b39b..5ad00af 100644
--- a/isowind/windows/make_package.ps1
+++ b/isowind/windows/make_package.ps1
@@ -4,12 +4,14 @@
# Packaging again keeps the test characters in dist\Isowind (the server's data) and backs them up in <root>\backups
# first; the zip is always clean.
#
-# .\make_package.ps1 the package with the bundled mods: dist\Isowind and dist\Isowind.zip
-# .\make_package.ps1 -NoMods without them, for a public release (their licences don't all allow passing them on):
-# OpenMW's own look with Isowind's on top, the server requiring only Morrowind and its
-# expansions (isowind\tools\strip_mods.py, which needs Python 3). Into
-# dist\nomods\Isowind and dist\nomods\Isowind.zip, so the usual package and the test
-# characters in it stay as they are; bundled-mods isn't needed.
+# .\make_package.ps1 dist\Isowind and dist\Isowind.zip, with the bundled mods if <root>\bundled-mods is there
+# (build.ps1 -WithMods fetches it once); without them otherwise, as anyone building it
+# from the public repository gets
+# .\make_package.ps1 -NoMods without them whatever is there, for a public release (their licences don't all allow
+# passing them on), into dist\nomods\Isowind and dist\nomods\Isowind.zip, so the usual
+# package and the test characters in it stay as they are.
+# Without the mods the package is OpenMW's own look with Isowind's on top, the server requiring only Morrowind and its
+# expansions (isowind\tools\strip_mods.py, which needs Python 3).
param([switch]$NoMods)
@@ -19,6 +21,9 @@ $root = Split-Path -Parent $src
$release = Join-Path $src 'MSVC2022_64\Release'
$distRoot = if ($NoMods) { Join-Path $root 'dist\nomods' } else { Join-Path $root 'dist' }
$dist = Join-Path $distRoot 'Isowind'
+$bundledMods = Join-Path $root 'bundled-mods'
+$withMods = -not $NoMods -and (Test-Path $bundledMods)
+if ($withMods) { "With the bundled mods ($bundledMods)" } else { 'Without the bundled mods' }
# Isowind's own files (the mod, pixel art shader and palettes, profiles, server scripts, readme), shared with the
# Linux and Android builds
$isowind = Join-Path $src 'isowind'
@@ -88,7 +93,9 @@ foreach ($layout in 'openmw_layers.xml', 'openmw_settings_window.layout', 'openm
Mirror (Join-Path $isowind 'mod') (Join-Path $dist 'mod')
# Bundled mods (credited in Isowind.exe's Licenses and README.txt) with only the options Isowind uses, kept in
# bundled-mods (mod\add-mods is where new ones are dropped to look at); the profiles list their data folders.
-if (-not $NoMods) { Mirror (Join-Path $root 'bundled-mods') (Join-Path $dist 'mods') }
+# (Without them, none left over from a package that had them: the launcher credits the mods it finds there)
+if ($withMods) { Mirror $bundledMods (Join-Path $dist 'mods') }
+elseif (Test-Path (Join-Path $dist 'mods')) { Remove-Item -Recurse -Force (Join-Path $dist 'mods') }
# Mirrored, so textures built while testing the package (Bethesda-derived) never end up in it.
Mirror (Join-Path $isowind 'pixelart') (Join-Path $dist 'pixelart')
@@ -127,7 +134,7 @@ Copy-Item $launcherExe $dist -Force
Copy-Item (Join-Path $isowind 'README.txt') $dist -Force
# Without the bundled mods: the profiles, the server's plugin list and the readme made for OpenMW alone
-if ($NoMods) {
+if (-not $withMods) {
$python = (Get-Command py -ErrorAction SilentlyContinue), (Get-Command python -ErrorAction SilentlyContinue) |
Where-Object { $_ } | Select-Object -First 1
if (-not $python) { throw 'Python 3 is needed for the package without the mods (strip_mods.py): install it from python.org' }
@@ -191,7 +198,7 @@ $archive = [IO.Compression.ZipFile]::Open($zip, 'Create')
try {
$items = 'engine', 'licenses', 'mod', 'mods', 'pixelart', 'profiles\pixelart', 'profiles\normal',
'server\CoreScripts', 'server\tes3mp-server-default.cfg', 'source', 'Isowind.exe', 'README.txt'
- if ($NoMods) { $items = $items | Where-Object { $_ -ne 'mods' } }
+ if (-not $withMods) { $items = $items | Where-Object { $_ -ne 'mods' } }
foreach ($item in $items) {
$path = Join-Path $dist $item
$files = if (Test-Path $path -PathType Container) { Get-ChildItem $path -Recurse -File } else { Get-Item $path }
@@ -205,7 +212,7 @@ try {
$entry = 'Isowind/server/' + $file.Substring('isowind/server/'.Length)
$from = Join-Path $src $file
# (the plugin list as strip_mods.py made it, without the mods)
- if ($NoMods -and $file -like '*/requiredDataFiles.json') { $from = Join-Path $serverData 'requiredDataFiles.json' }
+ if (-not $withMods -and $file -like '*/requiredDataFiles.json') { $from = Join-Path $serverData 'requiredDataFiles.json' }
[IO.Compression.ZipFileExtensions]::CreateEntryFromFile($archive, $from, $entry, 'Optimal') | Out-Null
}
} finally { $archive.Dispose() }