Other user's assetsAll the assets in this file belong to the author, or are from free-to-use modder's resources
Upload permissionYou can upload this file to other sites but you must credit me as the creator of the file
Modification permissionYou are allowed to modify my files and release bug fixes or improve on the features without permission from or credit to me
Conversion permissionYou can convert this file to work with other games as long as you credit me as the creator of the file
Asset use permissionYou are allowed to use the assets in this file without permission or crediting me
Asset use permission in mods/files that are being soldYou are allowed to use the assets in this file in mods/files that are being sold, for money, on Steam Workshop or other platforms
Asset use permission in mods/files that earn donation pointsYou must get permission to earn Donation Points for your mods if they use my assets
Author notes
Copyright 2024 DeltaJordan (Jordan Marine) Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the “Software”), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions: The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software. THE SOFTWARE IS PROVIDED “AS IS”, WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
File credits
This author has not credited anyone else in this file
Donation Points system
Please log in to find out whether this mod is receiving Donation Points
Fixed certain characters causing the search to break completely.
Version 2.4.0
Added plugin-optional setting, which moves skyrim plugins to the optional folder of the mod instead of renaming them when using the mohidden option.
Added warnings and error handling for optional plugin functionality.
Updated a lot of the code to use modern python standards.
Removed support for MO2 older than 2.5.0
Version 2.3.2
Window geometry (width, height, etc) is now saved on close and restored on launch.
Version 2.3.1
Changed status text to reflect whichever removal setting was selected.
Version 2.3.0
Added progress dialogs.
Updated mohidden functionality; now recursively hides files instead of hiding the target directory.
Updated confirmation window to reflect the above changes.
Fixed certain paths escaping the mod directory; now checks that paths are within the selected mod's folder.
Fixed error when checking for duplicate paths and invalid paths are entered.
Fixed *.mohidden files being matched during path entry.
Fixed invalid path entries breaking the invert functionality; these paths will just be ignored.
Version 2.2.0
Added an option to enable debug logging. When enabled, this adds a section to the log to show exception stacktraces when attempting to remove files.
Added a section in the removal log to list failed files.
Updated the removal confirmation window to be wider. This should help prevent the status column from being hidden.
Updated the removal error dialog to use a details section. This allows easy text selection so users can write down which files failed.
Fixed an issue in logging where the first file removed was on the same line as the section header.
Fixed an issue where files could be entered/matched twice, which caused an error to show.
Version 2.1.0
The removal log now seperates runs into sections with a date and time. README and LICENSE are now included in the download. MIT License requires the latter to be included; the former is there for redundancy.
Version 2.0.0
Major update. Changes the tool file name and display name to better reflect the functionality. Also, by default the removal type setting is unset to ensure the user selects exactly what they want the app to accomplish.
Version 1.4.0
Added option to hide files instead of deleting. Also added some error handling for failed file removal.
Version 1.3.0
Initial Release
Donations
No donations accepted
Installation
Extract `mo2-removal-tool.py` and put the file into your MO2 plugins folder. NOTE: If you were using any version of this tool before 2.0.0 you should delete the old version before installing the latest. The file names have changed. Theoretically, this shouldn't break anything but it's best not to take the chance. Don't say I didn't warn you.
Setup
Within the plugin settings, you MUST change 'removal-type' to either 'mohidden' (adds "*.mohidden" to the end of the file/folder path) or 'delete' (deletes the files from your filesystem). Otherwise, the tool will NOT run. This is to ensure you do not do something to your files that you aren't expecting. Call it an idiot check ;)
As of version 2.4.0, you may also want to enable moving .esps, .esls, esms, etc. to the optional folder by setting 'plugin-optional' to True. This only works with the 'mohidden' mode of operation.
Usage
BEFORE YOU DO ANYTHING you must follow the Setup instructions above.
Select the "MO2 Removal Tool" option from the tools menu in the MO2 toolbar.
Type the name of the mod you want to remove files/folders from (The last mod in your modlist is selected by default).
Type/Paste the paths into the box below the mod selector.
Click Run. Another dialog will open.
Review the files that will be removed. Any wildcard paths will be expanded to show what files were selected.
Click "Remove All" to finalize the deletion. Note that you can also invert the selection to remove everything EXCEPT what you originally entered. THIS IS EXPERIMENTAL. Remember that you CANNOT undo a deletion from this tool, I personally recommend using the "mohidden" option when using this feature.
A file will be created in the root folder of the mod to log the removals you made. The file will be called {modName}.{'delete'|'mohidden'}.log
A visual representation of the above is shown below: