tes3cmd

Author:
Last Updated:
2021-11-10
Description:
A command line tool to examine and manipulate plugins for the Elder Scrolls game Morrowind.
OpenMW Compatibility:
Active:
Yes

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:
C:\games\OpenMWMods\Tools\tes3cmd
Usage Notes:

How to run TES3CMD to clean a plugin:

Step 1: Download It

Windows users want to use the file from the download link above.

Linux users can get a distro-agnostic binary executable from this link. Be sure to make it executable (chmod +x tes3cmd-0.37w.linux.x86_64)

macOS users will want to download this file (make sure to make it executable before you try and run it). Note that you also need to ensure perl is installed on your system, and the following may also be required to satisfy dependencies (run from a terminal):

cpan install Config::IniFiles

Once you've downloaded TES3CMD, place it into the data path folder listed above.

Step 2: Run It

Windows

  1. Press Windows key + r to open a run prompt
  2. Type powershell and press enter
  3. A Powershell window will open
  4. Type cd C:\games\Morrowind\Data Files, but replace the path with the path where your Morrowind Data Files folder actually is on your computer
  5. Copy the plugin you want to clean into this folder (it's just temporary, we'll remove it when we're done with this)
  6. Type
    &"C:\games\OpenMWMods\Tools\tes3cmd\tes3cmd.exe" clean Plugin_Name_Here.esp
    , but replace the path with the actual path to the folder where tes3cmd is on your computer, and the name of the plugin with the plugin you want to clean
  7. When this completes, you'll have a plugin named Clean_Plugin_Name_Here.esp. Copy that into the mod's data path folder and delete the dirty plugin from your Morrowind Data Files folder

That's it!

Linux/macOS

  1. Open a terminal
  2. Type cd /home/username/games/Morrowind/Data Files, but replace the path with the path where your Morrowind Data Files folder actually is on your computer
  3. Copy the plugin you want to clean into this folder (it's just temporary, we'll remove it when we're done with this)
  4. Type
    /home/username/games/OpenMWMods/Tools/tes3cmd/tes3cmd-0.37w.linux.x86_64 clean Plugin_Name_Here.esp
    , but replace the path with the actual path to the folder where tes3cmd is on your computer, and the name of the plugin with the plugin you want to clean (macOS users should also change the TES3CMD executable name)
  5. When this completes, you'll have a plugin named Clean_Plugin_Name_Here.esp. Copy that into the mod's data path folder and delete the dirty plugin from your Morrowind Data Files folder

That's it!

Further References

Run tes3cmd clean --help for detailed information about how the program cleans.

The official wiki and this reddit post about using tes3cmd.exe with MO2 on Windows are great resources.

Settings
GPLv3 logo