Attunement (And Rarity Limits)

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)

Unlike ZERD, this doesn't include a combat restriction for attuning items - i felt that BG3s game design (especially around throwable and bound items) would cause too many issues with this, and would ultimately lead to an inconsistent design.

Compatibility

I modify the Stats associated to each itemTemplate exclusively at runtime, no file ove