0 of 0
About this mod
(Patch 8 Compatible) Highly customizable attunement implementation with a custom MCM-integrated IMGUI interface, with additional options for limiting equipment in each slot/in total by Rarity (also includes the ability to change the rarity of any item in the game)!
- Requirements
- Permissions and credits
-
Translations
- Russian
- Mirrors
- Changelogs
Github
When installing for the very first time, load into any save, then immediately reload that save
The config gets created at the same time the functionality relying on it runs, so you just need to do this step once.
If any threshold is set to its max (i.e. Attunement is set to 13 items), the corresponding resources + status won't be created since there's no point - lower below the max and reload to see it applied to your characters/items.
How It Works
Items that require attunement or that fall under a configured Rarity limit (e.g. Total Legendary or VeryRare Weapons) are given a UseCost corresponding to the associated Action Resource (same system as using an Action or Bonus Action). That resource is restored when the given item is unequipped (including if you're disarmed). If you're out of any resource associated to an item, you're unable to equip that item until you unequip another item that uses that same resource(s).
There aren't any short rest features attached to this right now (unlike tabletop Attunement) as BG3 really wasn't built with that kind of behavior in mind. May look into this in the future, but for now there's no limitations on when you can perform attunement.
Features
Compatibility
I modify the Stats associated to each itemTemplate exclusively at runtime, no file overrides, so this will be compatible with 99% of mods. If using ZERD's Attunement, opt out to avoid conflicting rules
Uninstalling
Since stats are only modified at runtime, the changes are not persisted to the underlying files, so rarities will restore to their defaults after uninstallation. The game won't break if you have any statuses/action resources applied after uninstalling, but the safest route would be to increase all thresholds to their maximum so the resources + statuses are removed, reload, save, then uninstall.
Credits
Sensible Ambushing - Stealth Combat Overhaul
The Armory (Auto Transmog Vanity Outfit Manager)
Attunement (And Rarity Limits)
Automatic Inventory Manager (AIM)
Owlbear Cub Permanent Aggression Fix on Honor Ruleset
Experience Spider - Report Generator
Grit and Glory - Injuries Exhaustion and Madness - MCM
When installing for the very first time, load into any save, then immediately reload that save
The config gets created at the same time the functionality relying on it runs, so you just need to do this step once.
If any threshold is set to its max (i.e. Attunement is set to 13 items), the corresponding resources + status won't be created since there's no point - lower below the max and reload to see it applied to your characters/items.
How It Works
Items that require attunement or that fall under a configured Rarity limit (e.g. Total Legendary or VeryRare Weapons) are given a UseCost corresponding to the associated Action Resource (same system as using an Action or Bonus Action). That resource is restored when the given item is unequipped (including if you're disarmed). If you're out of any resource associated to an item, you're unable to equip that item until you unequip another item that uses that same resource(s).
There aren't any short rest features attached to this right now (unlike tabletop Attunement) as BG3 really wasn't built with that kind of behavior in mind. May look into this in the future, but for now there's no limitations on when you can perform attunement.
Features
- Full MCM integration with a custom IMGUI UI, allowing advanced configuration
- View all items in the game (whose rarity is greater than common) via the UI, changing their Rarity and enabling/disabling Attunement for them
- Items that give the player Statuses, Passives, or Boosts and have a rarity that is >= the configured threshold will automatically require Attunement
- Preview items, equipping them for 30 seconds so you can get a better feel for them
- Set Attunement and Rarity Equip thresholds per Difficulty Setting, allowing extremely high degrees of customization
- Custom Action Resources with Icons (including for controllers) - requires IMPUI to work! (Only Attunement and Rare/VeryRare/Legendary Total Equip Limit have these - I'm not a designer lol and I got tired of dealing with the toolkit. If anyone wants to make icons for the rest, i'd be happy to cut you 20-30% of the DP + credit you - would need to be 48x48 png with a transparent background. See Github for current setup)
- Statuses indicating when an equip limit is reached (with MCM settings to enable/disable the status and/or resource for each limit type)
Compatibility
I modify the Stats associated to each itemTemplate exclusively at runtime, no file overrides, so this will be compatible with 99% of mods. If using ZERD's Attunement, opt out to avoid conflicting rules
Uninstalling
Since stats are only modified at runtime, the changes are not persisted to the underlying files, so rarities will restore to their defaults after uninstallation. The game won't break if you have any statuses/action resources applied after uninstalling, but the safest route would be to increase all thresholds to their maximum so the resources + statuses are removed, reload, save, then uninstall.
Credits
- Norbyte as always for his work on Script Extender
- @Volitio for MCM, and both they and @Aahz07 for their IMGUI mods - they were heavily referenced for this and (currently unreleased) projects, so I 100% could not have made this without their work
- ZERD's RAW Mod - I ultimately ended up taking a very different direction in most aspects, but this served as an excellent initial reference and taught me a lot about action resources and stat modification
- @Fararagi for the logging code + some misc utility stuff - they've been propping up all my mods since the start, so really appreciate it
- @ActualSailorCat for the icons!
- DIQ @BaldursGoonsack + server (and Listonomicon's Ajax) for the request and testing
Sensible Ambushing - Stealth Combat Overhaul
The Armory (Auto Transmog Vanity Outfit Manager)
Attunement (And Rarity Limits)
Automatic Inventory Manager (AIM)
Owlbear Cub Permanent Aggression Fix on Honor Ruleset
Experience Spider - Report Generator
Grit and Glory - Injuries Exhaustion and Madness - MCM