Delta Plugin

How To Use This Page

Author:
Benjamin Winger
Description:

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

Download Link
OpenMW Compatibility:
Active:
Yes

Mod Installation/Setup Info

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

Data path:
C:\games\OpenMWMods\Tools\DeltaPlugin
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.
  • On Windows, navigate to the folder you extracted Delta Plugin into and Shift+Right-click the folder to open the context menu. Click Open Powershell window here and type the following command:
    .\delta_plugin.exe merge --skip-cells .\delta-merged.omwaddon
  • On Linux or MacOS, cd to the folder you extracted Delta Plugin into and use the following command:
    ./delta_plugin merge --skip-cells 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:
delta-merged.omwaddon

MOMW Metadata

Category: Tools