Delta Plugin and Groundcoverify

How To Use This Page

Author:
Description:
Transcoder for managing a form of markup-based minimal Elder Scrolls Plugin files and OMWAddon files and a simple python script which uses Delta Plugin to turn regular groundcover in morrowind plugins into openmw-style groundcover.
Download Link
OpenMW Compatibility:

Mod Installation/Setup Info

Note: This page does not contain information specific to any mod list. In order to see mod list specific information use one of the mod list links listed below where it says "Featured in Mod Lists".

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\DeltaPluginandGroundcoverify
Usage Notes:

Users following a Mod List can proceed onto the Final Steps as these instructions are covered there. Legacy instructions are included below.

Delta Plugin instructions (click to expand/collapse):

Delta Plugin 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 and 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, deleted_groundcover.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.

Groundcoverify instructions (click to expand/collapse):

Please note that while these steps may seem somewhat involved, this tool can yield a decent-sized FPS gain so we urge you to not skip it.

  1. Download Groundcoverify
  2. Extract it to the provided data path. If you're using Windows you need to move the .exe file inside groundcoverify into this data path.
  3. On Windows, navigate to the folder you installed Groundcoverify into and Shift+Right-click the folder to bring up the context menu. Click Open Powershell window here and use the following command:
    .\groundcoverify.exe --verbose --delta-plugin-exe .\delta_plugin.exe
  4. On Linux and macOS, just open your normal terminal application, cd to the directory you installed Groundcoverify into, and use the following command:
    ./groundcoverify --verbose --delta-plugin-exe ./delta_plugin
  5. When it completes, you should have two plugins, deleted_groundcover.omwaddon and groundcover.omwaddon, and a meshes folder
Content Plugins:
delta-merged.omwaddon
deleted_groundcover.omwaddon
Groundcover Plugin:
groundcover.omwaddon