0 of 0
About this mod
Extensible, customizable Inventory Manager that redistributes items on pickup to their best fit, the way you tell it to! Able to send items to party members, the camp chest, or custom containers, using character and items stats. Balance out your consumable stacks, send arrows to your archers, and give your wizard all your scrolls!
- Requirements
- Permissions and credits
- Mirrors
- Changelogs
Working with Patch 7, Script Extender v20.
File a bug report if you come across anything!
See the Quickstart guides on how to use and configure this mod (unless you just want to use the defaults, in which case, just install and play)! (WIP)
v2.4.0 adds optional MCM integration!
See https://github.com/osirisOfGit/BG3_Automatic_Inventory_Manager/blob/master/CHANGELOG.md for the latest detailed change notes - highlights/summaries are always added to Nexus.
Disclaimer
This mod isn't actually particular useful from a functionality standpoint thanks to Larian's Magic Pockets, multi-select, and Filter implementations - if you're looking at this mod because you think you need to move items and gear to a character before you can use them, or because you don't know about the built-in filters and have trouble finding items, or because you don't know you can select multiple items in your inventory by shift-clicking, then you'll be happy to know that Larian has largely solved these problems already (although controller support leaves a bit to be desired - this mod may alleviate those issues in conjunction with vanilla functionality!). Play around!
This mod is more targeted at people like me who hate the giant, messy inventories for aesthetic but also hate swapping between characters to pick up items/constantly right-click "send to"ing, or who find the interface way too busy to manage (especially when playing on small monitors or Steam Deck).
Additionally, I have no idea what'll happen in a true multiplayer game - never tested it. If you run into issues, let me know by filing a github issue with your log.txt and filters/ directory!
Additionally additionally, if you're looking for a junk management mod, I highly recommend Auto Loot Seller V3, as solving that particular problem within AIM's framework would have been extremely tedious and complicated, and they've solved the problem magnificently!
When Does AIM Manage Items?
Unless an item is in AIM's blacklist, or inside a blacklisted container, Items will be processed when being added directly to a party member's inventory - this includes picking up, transferring between party members, pulling out of containers. Items already in a given character's inventory will also be processed when they join the party, unless they've been processed previously.
It will also attempt to sort all items on load (if they haven't been sorted previously) - this functionality is a little unreliable due to the sheer amount of items being processed and Larian's Event pipeline, so you'll probably have to manually sort items yourself first, or drop and pick them up, to get your inventory where you want it to be (only needs to happen the very first time you load up with AIM). Make sure to save!
To prevent constant reprocessing, a custom tag is added to each item that is evaluated by AIM, regardless of whether it was eligible for sorting. This tag can be cleared by dropping the item, allowing it to be re-processed on pickup.
Additionally, each item in the party's inventory with the CONSUMABLE tag will be re-processed on use, when outside of combat (meaning, if you drink a small health potion, all small health potions in the party's inventory will be redistributed according to the filters). This can be controlled with a configuration.
Defaults
This mod comes with two presets:
The Automatic_Inventory_Manager-All-Defaults preset, which manages most items of general concern:
The other preset, Automatic_Inventory_Manager-Camp-Gold-Books, is still the same AIM functionality, but only comes with filters for
The presets can be easily be swapped between on save load by modifying the config.json (more details below) .
Configuration
Configurations are generated at
If you're seeing weird behavior after an update or after installing/uninstalling a mod that extends this mod, you can just nuke the whole folder and AIM will regenerate with defaults + what your other installed mods add.
For a more in-depth explanation on configurations, filters, or general functionality, or for a quick guide on extending AIM through your own mod, see https://github.com/osirisOfGit/BG3_Automatic_Inventory_Manager/wiki - contributors are welcome!
Compatibility and Uninstalling
AIM works on Larian's event system, specifically TemplateAddedTo, and has safegaurds around making sure the item exists and is in the party's inventory, so it should play well with mods like Auto Loot Seller and any bag mods with auto-sorting like Bags Of Sorting- Beans. Mods can also leverage AIM's API to implement or overwrite filters to specifically work with their mods, if so desired.
There shouldn't be any concerns with uninstalling this mod - the only artifact it will leave behind is the custom tag it uses to identify previously processed items - i'm not aware of any use-cases that would cause this to break anything, but it may depend on a mod's implementation. If anyone is aware of concerns around this, please reach out!
Acknowledgements
Huge shoutout to https://github.com/Norbyte/bg3se, https://github.com/ShinyHobo/BG3-Modders-Multitool and the randos in the Larian Modding Discord - the work they've all put into their projects to enable idiots like me can't be understated!
Also to @Fararagi for the logging code + some misc utility stuff - they've been propping up all my mods since the start, so really appreciate it
Additional shoutouts to early adopters of this mod - especially ShaySignyr, MasterVegito2012, and Llamby - the feedback y'all have been providing has been invaluable!
My Other Mods
The Armory (Auto Transmog Vanity Outfit Manager)
Attunement (And Rarity Limits)
Owlbear Cub Permanent Aggression Fix on Honor Ruleset
Experience Spider - Report Generator
Grit and Glory - Injuries Exhaustion and Madness - MCM
File a bug report if you come across anything!
See the Quickstart guides on how to use and configure this mod (unless you just want to use the defaults, in which case, just install and play)! (WIP)
v2.4.0 adds optional MCM integration!
See https://github.com/osirisOfGit/BG3_Automatic_Inventory_Manager/blob/master/CHANGELOG.md for the latest detailed change notes - highlights/summaries are always added to Nexus.
Disclaimer
This mod isn't actually particular useful from a functionality standpoint thanks to Larian's Magic Pockets, multi-select, and Filter implementations - if you're looking at this mod because you think you need to move items and gear to a character before you can use them, or because you don't know about the built-in filters and have trouble finding items, or because you don't know you can select multiple items in your inventory by shift-clicking, then you'll be happy to know that Larian has largely solved these problems already (although controller support leaves a bit to be desired - this mod may alleviate those issues in conjunction with vanilla functionality!). Play around!
This mod is more targeted at people like me who hate the giant, messy inventories for aesthetic but also hate swapping between characters to pick up items/constantly right-click "send to"ing, or who find the interface way too busy to manage (especially when playing on small monitors or Steam Deck).
Additionally, I have no idea what'll happen in a true multiplayer game - never tested it. If you run into issues, let me know by filing a github issue with your log.txt and filters/ directory!
Additionally additionally, if you're looking for a junk management mod, I highly recommend Auto Loot Seller V3, as solving that particular problem within AIM's framework would have been extremely tedious and complicated, and they've solved the problem magnificently!
When Does AIM Manage Items?
Unless an item is in AIM's blacklist, or inside a blacklisted container, Items will be processed when being added directly to a party member's inventory - this includes picking up, transferring between party members, pulling out of containers. Items already in a given character's inventory will also be processed when they join the party, unless they've been processed previously.
It will also attempt to sort all items on load (if they haven't been sorted previously) - this functionality is a little unreliable due to the sheer amount of items being processed and Larian's Event pipeline, so you'll probably have to manually sort items yourself first, or drop and pick them up, to get your inventory where you want it to be (only needs to happen the very first time you load up with AIM). Make sure to save!
To prevent constant reprocessing, a custom tag is added to each item that is evaluated by AIM, regardless of whether it was eligible for sorting. This tag can be cleared by dropping the item, allowing it to be re-processed on pickup.
Additionally, each item in the party's inventory with the CONSUMABLE tag will be re-processed on use, when outside of combat (meaning, if you drink a small health potion, all small health potions in the party's inventory will be redistributed according to the filters). This can be controlled with a configuration.
Defaults
This mod comes with two presets:
The Automatic_Inventory_Manager-All-Defaults preset, which manages most items of general concern:
- Gold
- Healing Potions
- Lockpicks
- Weapons
- Armor/General Equipment
- Arrows
- Grenades
- Scrolls
- Camp Supplies
- Books
- Coatings
- General Consumables
The other preset, Automatic_Inventory_Manager-Camp-Gold-Books, is still the same AIM functionality, but only comes with filters for
- Gold (sending all gold to the character with the biggest stack)
- Books (sent to camp chest)
- Camp Supplies (sent to camp chest)
The presets can be easily be swapped between on save load by modifying the config.json (more details below) .
Configuration
Configurations are generated at
%localappdata%\Larian Studios\Baldur's Gate 3\Script Extender\Automatic_Inventory_Manager
- this contains the config.json, log.txt, and all the Item Filter Map presets - you can add your own presets, and mix + match with existing ones!If you're seeing weird behavior after an update or after installing/uninstalling a mod that extends this mod, you can just nuke the whole folder and AIM will regenerate with defaults + what your other installed mods add.
For a more in-depth explanation on configurations, filters, or general functionality, or for a quick guide on extending AIM through your own mod, see https://github.com/osirisOfGit/BG3_Automatic_Inventory_Manager/wiki - contributors are welcome!
Compatibility and Uninstalling
AIM works on Larian's event system, specifically TemplateAddedTo, and has safegaurds around making sure the item exists and is in the party's inventory, so it should play well with mods like Auto Loot Seller and any bag mods with auto-sorting like Bags Of Sorting- Beans. Mods can also leverage AIM's API to implement or overwrite filters to specifically work with their mods, if so desired.
There shouldn't be any concerns with uninstalling this mod - the only artifact it will leave behind is the custom tag it uses to identify previously processed items - i'm not aware of any use-cases that would cause this to break anything, but it may depend on a mod's implementation. If anyone is aware of concerns around this, please reach out!
Acknowledgements
Huge shoutout to https://github.com/Norbyte/bg3se, https://github.com/ShinyHobo/BG3-Modders-Multitool and the randos in the Larian Modding Discord - the work they've all put into their projects to enable idiots like me can't be understated!
Also to @Fararagi for the logging code + some misc utility stuff - they've been propping up all my mods since the start, so really appreciate it
Additional shoutouts to early adopters of this mod - especially ShaySignyr, MasterVegito2012, and Llamby - the feedback y'all have been providing has been invaluable!
My Other Mods
The Armory (Auto Transmog Vanity Outfit Manager)
Attunement (And Rarity Limits)
Owlbear Cub Permanent Aggression Fix on Honor Ruleset
Experience Spider - Report Generator
Grit and Glory - Injuries Exhaustion and Madness - MCM