0 of 0
About this mod
Extensible, customizable Inventory Manager that redistributes items on pickup to their best fit, if AIM knows how! Able to send items to party members, the camp chest, or custom containers, using character and items stats.
- Requirements
- Permissions and credits
- Mirrors
- Changelogs
See https://github.com/osirisOfGit/BG3_Automatic_Inventory_Manager/wiki for an in-depth explanation of this mod's functionality and customizability!
See https://github.com/osirisOfGit/BG3_Automatic_Inventory_Manager/blob/master/CHANGELOG.md for the latest change notes
Migrating from 1.x to 2.x
Anyone with customizations should read https://github.com/osirisOfGit/BG3_Automatic_Inventory_Manager/wiki/Migration-Guides - they will be preserved, the guide just explains the migration behavior a bit more. Anyone just using the full default or camp-gold-books filters should delete their
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?
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. This does not include items being added to a container in the party member's inventory.
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!
Additional shoutouts to early adopters of this mod - especially ShaySignyr, MasterVegito2012, and Llamby - the feedback y'all have been providing has been invaluable!
See https://github.com/osirisOfGit/BG3_Automatic_Inventory_Manager/blob/master/CHANGELOG.md for the latest change notes
Migrating from 1.x to 2.x
Anyone with customizations should read https://github.com/osirisOfGit/BG3_Automatic_Inventory_Manager/wiki/Migration-Guides - they will be preserved, the guide just explains the migration behavior a bit more. Anyone just using the full default or camp-gold-books filters should delete their
%localappdata%\Larian Studios\Baldur's Gate 3\Script Extender\Automatic_Inventory_Manager folder, load up any save, then change the PRESETS.ACTIVE_PRESETS property to point at their desired preset - https://github.com/osirisOfGit/BG3_Automatic_Inventory_Manager/wiki/Configurations#presets goes into more detailDisclaimer
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?
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. This does not include items being added to a container in the party member's inventory.
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
- 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!
Additional shoutouts to early adopters of this mod - especially ShaySignyr, MasterVegito2012, and Llamby - the feedback y'all have been providing has been invaluable!