Equipment Library

Introduction

BG 3 modding has its limits. It's surprisingly hard to implement a lot of simple sounding ideas like always apply a status to characters, or add some passive to every Medium Armor in game. Equipment Library is a solution for this problem. It provides a convenient framework for modders to use, making the creation of global rebalances and overhauls a much easier task.

How to use

Just add Equipment Library to the beginning of your mod load order. It has to be loaded before mods that depend on it.

Equipment Library does not have any effect in game unless you've also installed some mods, taking advantage of its functionality. You do not need to download and install it unless you are a modmaker or another mod has specified Equipment Library as a requirement.

How does it work

Using inheritance and self-inheritance, Equipment Library redefines data "PassivesOnEquip"

for every Armor chest piece in game and

data "PassivesMainHand"

data "PassivesOffHand"

for every Weapon in game.

It adds new hidden passives, which modmakers can now redefine in their own mods, to apply the desired effects.

Available Armor passives are:

EqLib_HeavyBody_Passive - on every Heavy Armor chest piece

EqLib_RingMailBody_Passive - on every Ring Mail

EqLib_ChainMailBody_Passive - on every Chain Mail

EqLib_SplintBody_Passive - on every Splint Mail

EqLib_PlateBody_Passive - on every Full Plate

EqLib_MediumBody_Passive - on every Medium Armor chest piece

EqLib_HideBody_Passive - on every Hide Armor

EqLib_ChainShirtBody_Passive - on every Chain Shirt

EqLib_ScaleBody_Passive - on every Scale Armor

EqLib_BreastplateBody_Passive - on every Breastplate

EqLib_HalfPlateBody_Passive - on every Half Plate

EqLib_LightBody_Passive - on every Light Armor chest piece

EqLib_PaddedBody_Passive - on every Padded Armor

EqLib_LeatherBody_Passive - on every Leather Armor

EqLib_StuddedBody_Passive - on every Studded Leather Armor

Format of Weapon passives:

EqLib__Passive

For example:

EqLib_BattleAxeMain_Passive - on every Battleaxe. Is active when the item is equipped in main hand

EqLib_BattleAxeOff_Passive - on every Battleaxe. Is active when the item is equipped in the off hand

EqLib_FlailMain_Passive

EqLib_FlailOff_Passive

EqLib_MorningstarMain_Passive

EqLib_MorningstarOff_Passive

Weapon that can't be equipped in the off hand only have one passive:

EqLib_PikeMain_Passive

EqLib_GlaiveMain_Passive

EqLib_GreatAxeMain_Passive