Skip to content
Morrobroom

Tool active

Morrobroom

Build Morrowind levels in TrenchBroom: a brush compiler, lightmapper and NIF-to-TrenchBroom importer for OpenMW.

Stable
1.0.0 2026-09-29
Development
1.0.1-dev.0
Package
Program 4 platforms
License
AGPL-3.0

Overview

Morrobroom lets you build Morrowind and OpenMW spaces in TrenchBroom, then compile them into native game content: meshes, a plugin, and baked lighting.

Build rooms, corridors, structures and blockouts from brushes instead of assembling every wall from prebuilt meshes. Build lights, containers, activators and items the same way. And when the geometry you want already exists as a NIF, nif2map turns it back into brushes you can edit.

Three programs, one job each

TrenchBroom is the editor. Morrobroom is the compiler. OpenMW is where you play the result.

  1. source

    TrenchBroom

    Build rooms from brushes, place lights and objects, and save the .map.

  2. tool

    Morrobroom

    Compile the saved map into NIF meshes, baked lightmaps and a TES3 plugin.

  3. result

    OpenMW

    Load the build folder as data and walk around what you made.

source

Existing NIFs

nif2map reverse-compiles their visual geometry into maps you can edit.

How the pieces relate
  • TrenchBroom Map-to-Engine Morrobroom
  • Morrobroom build/<map>/ OpenMW
  • Existing NIFs nif2map TrenchBroom

Start here#

The manual is small and practical. Begin with Start here if this is your first time using TrenchBroom with OpenMW: it takes you from nothing installed to walking around your first room.

You do not need to know Quake mapping, NIF internals, CSG or Rust. You need TrenchBroom, OpenMW with Morrowind’s data, and the Morrobroom download for your platform, above.

If you have never used TrenchBroom, start with DumptruckDS’s TrenchBroom playlist and keep the official TrenchBroom manual nearby. For the story behind all of this, read OpenMW’s From BSP to ESP.

What it does#

  • Compiles Valve 220 .map files into NIF meshes and a Morrowind or OpenMW plugin, with statics, activators, containers, items, lights and leveled lists built from what you placed.
  • Bakes colored static lighting into BC7 lightmaps, which OpenMW loads without an engine patch.
  • Carries NIF materials, transparency, texturing, scrolling and swaying UVs, billboards, sort nodes and collision roots from TrenchBroom into the meshes it writes.
  • Generates a TrenchBroom entity catalog from an OpenMW load order, and places the records you pick from it.
  • Reverse-compiles visual NIF geometry into editable maps with nif2map.

Status#

Morrobroom is usable and tested, but unusual brushes, exotic NIFs and strange third-party assets can still find edge cases. Small reproducible examples are extremely useful: Troubleshooting says what to send.

Morrobroom is AGPL-3.0. The code under src/slipgate/ is MIT or Apache-2.0; see THIRD_PARTY.md.

Install

Program · 1.0.0

Download and runa program: one archive per platform, no installer
  1. Download the archive for your platform: Windows, macOS, Apple silicon, macOS, Intel, Linux.
  2. Unzip it wherever you keep your tools. Nothing goes into the game's folders.
  3. Run morrobroom, or morrobroom.exe on Windows. From a terminal, morrobroom --help lists what it can do.

Then the documentation takes it from there.

DreamWeave clientsCHIMERA and other tools that read the manifest

Give the tool this page's address, or the manifest directly. It finds the release for its channel, checks compatibility and dependencies, downloads from any listed source and refuses bytes whose SHA-256 does not match.

Project id
015878d0-9501-4b1f-8453-7726bcccf860
Manifest
https://dreamweave-mp.github.io/Morrobroom/dreamweave/projects/015878d0-9501-4b1f-8453-7726bcccf860.json

What is in the archive

  • morrobroom-<platform>.zipone per platform
    • morrobroomthe program; morrobroom.exe on Windows
    • README.md
    • LICENSE
    • THIRD_PARTY.md
    • resources
    • content
  1. 1.0.0 stable 2026-09-29

    First release: compile TrenchBroom maps into Morrowind content for OpenMW.

    Added

    • Compile Valve 220 maps into NIF meshes and a TES3 plugin, with brush-built statics, activators, containers, items, armor, clothing, lights and leveled lists.
    • Bake static lighting into lightmaps that OpenMW loads without an engine patch.
    • Author NIF materials, alpha, texturing, scrolling and oscillating UVs, billboards in all four Morrowind modes, sort nodes and collision roots from TrenchBroom.
    • Smooth-shade faces with the Smooth Shading surface flag, in groups set by each face’s Value.
    • Generate a TrenchBroom entity catalog from an OpenMW load order, sized in map units, and place its records as references.
    • Reverse-compile visual NIF geometry into editable maps with nif2map, billboard modes included.

    Known issues

    • nif_fx_fire and the VFX catalog are editor previews: placing one builds nothing yet.
    • nif2map does not read oscillating UV animation back: it reports the controller and imports the geometry without it.
    morrobroom-Windows-X64.zip 10.15 MB · Windows
    Verify · sha256 b4c1afdf7d7d…ceb6b9bb
    Release
    1.0.0 (stable)
    Size
    10646329 bytes
    SHA-256
    b4c1afdf7d7dd6cceedb7005ce5cd5c54e40e16fb21c4a3e71f97ebdceb6b9bb
    Commit
    18276268c2ec
    Sources
    1

    Check it yourself: sha256sum morrobroom-Windows-X64.zip must print the digest above.

    morrobroom-macOS-ARM64.zip 10.26 MB · macOS, Apple silicon
    Verify · sha256 878ebb63aed7…f6e1dd9f
    Release
    1.0.0 (stable)
    Size
    10754355 bytes
    SHA-256
    878ebb63aed71756820f2a2b7d9632951221b8e3472e95f250caf503f6e1dd9f
    Commit
    18276268c2ec
    Sources
    1

    Check it yourself: sha256sum morrobroom-macOS-ARM64.zip must print the digest above.

    morrobroom-macOS-X64.zip 10.40 MB · macOS, Intel
    Verify · sha256 5b38a748bf70…9a062e92
    Release
    1.0.0 (stable)
    Size
    10901639 bytes
    SHA-256
    5b38a748bf70454b6afb86ae4d751ce262d2b8052696bc14d17851919a062e92
    Commit
    18276268c2ec
    Sources
    1

    Check it yourself: sha256sum morrobroom-macOS-X64.zip must print the digest above.

    morrobroom-Linux-X64.zip 10.52 MB · Linux
    Verify · sha256 4f2977afb2b6…39ae28ae
    Release
    1.0.0 (stable)
    Size
    11032973 bytes
    SHA-256
    4f2977afb2b668660b5601011c70c853a144cf98c22621452cee58aa39ae28ae
    Commit
    18276268c2ec
    Sources
    1

    Check it yourself: sha256sum morrobroom-Linux-X64.zip must print the digest above.

Credits

  • MaintainerDreamWeave
  • VFX Meshbank, the source of the VFX catalog's editor previewsKurpulio

Discussion

GitHub Discussions · sign in with GitHub to join in