Tips: Cleaning Plugins With TES3CMD

Register BSAs File Renames OPENMW_PHYSICS_FPS Shiny Meshes INI Importer TR Patcher Atlased Meshes

A "dirty" plugin, or one that contains GMST contamination, is created by default when using the vanilla construction kit. Any content creator that uses it unknowingly creates plugins with bad or undesirable changes.

The TES3CMD utility was created to, among many other things, clean plugins of these undesired changes. Please see the below pages as a more detailed reference on the topic of plugin cleaning:

NOTE: Not all plugins require cleaning, despite TES3CMD finding things to clean! Please consult the documentation for any mod that you are unsure about cleaning.

In my own quest to clean dirty plugins, I wrote a bash script to automate the process. Below is a bash script that can be used on any unix-like OS to clean known dirty mods, all in one swoop (it assumes tes3cmd is available in your $PATH.) Put it in the root of your mod directory and run it to clean all known to be dirty mods:

NOTE: If you aren't comfortable with scripts, please don't just copy and paste this. It's meant to be a reference for those who know what they are doing.

HEY: Windows scripters!! I need your help in providing an equivalent example for your OS. Please contact me if you can help!

#!/usr/bin/env bash

set -e

declare -a plugins_to_clean=(
    "Abandoned_Flatv2_0.esp"
    "Better Clothes_v1.1_nac.esp"
    "Bloated Morrowind.esp"
    "Book Rotate - Morrowind v1.1.esp"
    "Creatures.esp"
    "Creatures (lore).esp"
    "Creatures (Semi).esp"
    "DA_Sobitur_YA_Compatibility.ESP"
    "frostmoth_repaired_v0_31.esp"
    "Magical Missions.ESP"
    "MD_Azurian Isles_Grass.esp"
    "Meteorite Ministry Temple - Higher.esp"
    "Meteorite Ministry Palace - Higher.esp"
    "Mournhold Overhaul v.2.0 - WG + NPC's.esp"
    "Nevena's Twin Lamps & Slave Hunters 1.5.esp"
    "R-Zero's Creatorium Part 1 - Waters & Shores.ESP"
    "RR_Melchior's_Silt_Strider_Armor_Eng.esp"
    "Sky_Main_Grass.esp"
    "UCNature.esm"
    "UFR_v3dot2.esp"
    "Windows Glow.esp"
    "Windows Glow - Tribunal Eng.esp"
    "Windows Glow - Bloondmoon Eng.esp"
    "Windows Glow - Raven Rock Eng.esp"
    "Almalexia_Voicev1.esp"
    "Apel's_Asura_Coast_Fix.esp"
    "Better Clothes_v1.1.esp"
    "Building Up Uvirith's Legacy1.1.ESP"
    "CultSheog-1.02.ESP"
    "Cyrodiil_Main.esm"
    "DA_Sobitur_Facility_Clean.ESP"
    "DA_Sobitur_Quest_Part_1 Clean.esp"
    "DA_Sobitur_Repurposed_1.ESP"
    "DD_Caldera_Expansion.esp"
    "Dwemer and Ebony Service Refusal.ESP"
    "Go To Jail.esp"
    "Go To Jail (Mournhold + Solshteim).ESP"
    "Graphic Herbalism.esp"
    "Graphic Herbalism Extra.esp"
    "Graphic Herbalism - No Glow.esp"
    "Graphic Herbalism Tamriel_Data.esp"
    "Kilcunda's Balmora.ESP"
    "MD_Azurian Isles.esm"
    "Mournhold Overhaul v2.0 - NPC's.esp"
    "MW Containers Animated.esp"
    "NX9_Guards_Complete.ESP"
    "On the Move.esp"
    "OTR_Coast_Variety.esp"
    "Ozzy's Grass - Merged.esp"
    "Ports Of Vvardenfell V1.6.ESP"
    "Quill of Feyfolken 2.0 \[fixed\].esp"
    "RR_Holamayan_Eng.ESP"
    "SadrithMoraExpandedTR.esp"
    "True_Lights_And_Darkness_1.1.esp"
    "UFR_v3dot2_noRobe.esp"
    "Uvirith's Legacy_3.53.esp"
    "Vurt's BC Tree Replacer II.ESP"
    "Welcome to the Arena! v6.6.esp"
    "Xenn's Marksman Overhaul.ESP"
)

_oldIFS=$IFS

IFS=$(echo -en "\n\b")

for thing in "${plugins_to_clean[@]}"; do
    _path=$(find . -name "${thing}")
    echo NOW RUNNING: tes3cmd clean "${_path}"
    tes3cmd clean "${_path}"
done

IFS=$_oldIFS

Plugins that have been cleaned will be output as Clean_PluginName.esp (e.g. Clean_Windows Glow.esp), and the original left in place untouched.

Register BSAs File Renames OPENMW_PHYSICS_FPS Shiny Meshes INI Importer TR Patcher Atlased Meshes

About Getting Started CFG Generator Total Overhaul list Load Order Resources Tips FAQ Contact Feedback Issue Tracker Source Code #momw on Freenode TES3MP Server
All original content on this site is licensed under a Creative Commons Attribution-ShareAlike 4.0 International License. Creative Commons License