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.mdindex 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 packClone 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 itcrabnet\ 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 itbackups\ test characters and saves, zipped before each packaging (the last five)@@ -118,14 +118,25 @@ Then, in PowerShell, from the repository:.\isowind\windows\build.ps1The 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 -SkipDependenciesThe 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, thepixel 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 fromProtection 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 artlook (`python3-pil` / `python-pillow`; without it `isowind.sh` installs it into a private folder of its own). Topackage: [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-depsunzip -q build-deps/bundled-mods.zip -d build-deps/bundled-modsisowind/linux/package.sh build build-deps/Isowind build-deps/bundled-modsdiff --git a/isowind/windows/build.ps1 b/isowind/windows/build.ps1index 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 -ForceRemove-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.ps1index 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', 'openmMirror (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 -ForceCopy-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 1if (-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() }