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 so long as you credit me as the original creator
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 as long as you credit me
Asset use permission in mods/files that are being soldYou are not allowed to use assets from this file in any 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
The mod's code is licensed under AGPLv3. For details, refer to the GitHub link in the description. The licensing terms on Nexus complement these permissions. In cases of overlap, the stricter of the two licensing terms should apply.
File credits
Thanks again to Aahz for providing code for bootstrapping the table layout! Icon used for the mod page is Dazzle UI for the Trash Xmark Alt SVG vector (CC Attribution License).
Fixed an issue that caused the first mod option in the list to not display any data
Version 1.3.0
NOTE: MCM 1.7.0+ is required for MU 1.3.0+
Mod data is now automatically analyzed when opening MU's tab on MCM
Improved localization support
Added a rarity border to items when listing them
Improved/tweaked several minor design aspects
Added tentative fix for chest items getting deleted when uninstalling mods that add modded containers.
Added several safeguards against exceptions when analyzing mod data
Handled empty templates (items) or stats when listing them
Version 1.2.0
Stats are now supported! Mod Uninstaller will try to remove modded statuses, spells and passives from all entities in your game. Note that this will mostly work with SE-added stats, as class-based stats such as spells aren't easily removed. See the mod description for uninstalling tips.
Items and statuses are now listed in alphabetical order + other minor UI improvements
Tentative fix for containers not being deleted after items are moved from them
Removed unnecessary net message usage that would cause an exception when trying to uninstall mods with thousands of elements (e.g. FocusDyes)
SE v17+ is now required
Version 1.1.1
Improved item detection when mods have similar names
Improved fetching descriptions for items
Version 1.1.0
Added `!MU_Uninstall_Mod <modUUID>` command to uninstall mods via the SE console
Tentative fix for templates not getting loaded
Temporarily disabled statuses removal due to SE limitations. Also added some safeguards, but they won't be used lol. Track the mod and check back later, this should be fixed after SE v17 is released! This won't impact uninstalling mods that only add items.
Version 1.0.1.1
Removed leftover code previously meant for SE devel that could crash the game + fixed pak issue
Mod Uninstaller (MU) is a mod that allows purging all items and statuses for selected mods from your save directly from MCM, with no integration/compatibility patches needed from other mods. This allows you to remove these mods from your load order mid-playthrough.
Just open Mod Uninstaller's tab on MCM -> select the mod you want to purge -> click uninstall. You'll then be able to save, exit the game and remove the mod(s) you've uninstalled with MU.
Alternatively, you can use Mod Uninstaller via the SE console with this command
!MU_Uninstall_Mod modUUID
(replace modUUID with the actual uuid of the mod to uninstall)
Installation
Download the .zip file and install using BG3MM (recommended) or Vortex.
Uninstalling mods in vanilla BG3 Uninstalling a mod in BG3 can be challenging because mods often distribute items across various parts of the game, such as containers or trader inventories. Simply disabling a mod and loading a save can lead to issues, as the game attempts to access data that no longer exists. This mod addresses this issue by enabling you to remove all items associated with a mod before disabling it.
Here are some broad categories that are problematic when uninstalling mods:
Spoiler:
Show
- Items: Items added by mods pose a problem since they can be moved to many places, such as characters, containers, or simply placed in the game world. This is especially problematic if player has moved on from the area where the items were placed or just can't remember/find where these items are, not to mention that deleting such items manually is still a laborious process and requires a lot of trial and error to check if all items were indeed removed. - Statuses: Mods can add new statuses or modify existing ones. Removing such mods can cause issues with entities such as characters or containers that have these statuses, in a similar fashion to items. - Classes/leveling: Mods can add new classes or modify existing ones. Removing such mods can cause issues with characters that have these classes or have leveled up with these classes. It is way easier to just respec the characters to something vanilla. Note that this group also includes subclasses, spells, feats, and other character progression related features; your best bet is to respec to vanilla content and stay on level 1 until you are sure that all modded content is removed. Mod Uninstaller does not handle this type of content and will rather advise users to respec characters manually.
Uninstalling mods with Mod Uninstaller When uninstalling a mod that doesn't have bespoke uninstallation instructions, you can follow these steps: 0. Save manually first, just to play it safe. SE can't create manual saves, so you'll have to do it yourself :P. If you enable Log Runtime in SE settings, you'll also have stored logs for items removed that you can check later if ever needed. 1. Verify what kind of content the mod adds based on the mod's description and the list above, and deal with it accordingly:
If the mod adds classes/leveling features, respec all characters that have any of these features. Make sure they only have vanilla classes and subclasses.
If the mod adds items, use Mod Uninstaller to remove all items and statuses added by the mod.
2. Save and exit the game; 3. You may now remove the mod from your load order and load the save you created.
A few notes on Mod Uninstaller's functionality:
Mod Uninstaller analyzes your load order during runtime and does not require integration from other mods. It automatically filters all mods that have new items or statuses for you to select and uninstall. Mods that only change vanilla items/statuses will not get listed, since they should be able to simply be removed.
Modded containers will have their items moved to the camp chest before being deleted. However, it's recommended to move them out manually if you care about these items.
Vanilla items are not queued for removal, even if modified by mods, so they shouldn't be accidentally deleted; however, always verify your inventories and camp chests after uninstalling a mod that has containers.
A minority of mods may try to reapply statuses constantly, and that might prevent them from being uninstalled. It might be possible to fix this, but authors should be aware of this and provide a way to remove their content. This does not affect MU's capability of uninstalling mods that only add items.
If you used Mod Uninstaller and has experienced behavior that does not align with these points, feel free to leave a comment/bug report detailing the steps to reproduce the problem, what happened and what you expected. Special thanks Thanks to Aahz for some help with formatting the templates tables, and overall for scripting discussions! Also thanks Norbyte for being so helpful with troubleshooting and fixing problems with Ext.Stats. Also thanks Dazzle UI for the Trash Xmark Alt SVG vector (CC Attribution License).
Source Code The source code is available on GitHub or by unpacking the .pak file. Endorse on Nexus and give it a star on GitHub if you liked it!
Tools/Resources Mod Uninstaller - allows uninstalling mods that add items/statuses Mod Configuration Menu - offers a graphical interface for easy management of mod settings Volition Cabinet - library mod for my other mods AV Item Shipment Framework - allows authors to easily send items to player/camp chests fun fact: uninstalling mods was supposed to be a feature for ISF-integrated mods, but I was able to generalize it for all mods.
