Delta Plugin

Step #22 in the I Heart Vanilla list

What is this button?

Benjamin Winger
Featured in Mod Lists:

Transcoder for managing a form of markup-based minimal Elder Scrolls Plugin files and OMWAddon files


Usage Info

Did you find any inaccurate information below? Please let us know by opening an issue on GitLab or joining our Discord!

Data path:
Usage Notes:

This is a command-line program that will merge objects from your mod's plugins. It is strongly recommended that you do not skip this, many mods need merging to happen in order to function as intended.

Download the zip of the latest Package release for your operating system, extract the included binary to the suggested folder path shown above. To run it:

  • First, consult the CFG Generator to ensure your plugin load order is correct.
  • At this point in the modlist you will not yet have delta-merged.omwaddon and LightFixes.esp. Make sure they are not in your CFG at this point or the merge will fail. In the future should you wish to regenerate a merged plugin due to load order change, you'll want to omit these as well.
  • Open a (non-administrator) powershell or teminal window.
  • Run this (change paths as needed):
    # If using Linux/macOS:
    ~/games/OpenMWMods/Tools/DeltaPlugin/delta_plugin merge --skip-cells ~/games/OpenMWMods/Tools/DeltaPlugin/delta-merged.omwaddon
    # If using Windows:
    &"C:\games\OpenMWMods\Tools\DeltaPlugin\delta_plugin.exe" merge --skip-cells "C:\games\OpenMWMods\Tools\DeltaPlugin\delta-merged.omwaddon"

It is very important that you add the --skip-cells argument after merge! Omitting this will cause problems.

It will read the load order defined in your openmw.cfg file and produce a merged plugin (delta-merged.omwaddon) in the location specified in the command. This delta-merged.omwaddon file should be loaded last.

A merged plugin produced by Delta Plugin will auto-clean all dirty records with the exception of Evil GMSTs.

Note that merging large load orders will require a lot of memory (and/or a large page/swap file), you can reduce memory usage by setting the RAYON_NUM_THREADS=1 environment variable.

Please see this page for more resources on the topic of object merging.

NOTE MO2 users read this: make sure to follow your specific "Mod-Organizer To Openmw" way of handling omwaddon, omwscript, files for this.

Content Plugin:
GPLv3 logo