Modding:Editing Equipment.txt

From Baldur's Gate 3 Wiki
Jump to navigation Jump to search

To change the starting equipment for your game's classes, you can edit the Equipment.txt file. This is useful for previewing items or creating icons, just to name a couple examples. But how do you edit Equipment.txt?

Tools You'll Need[edit | edit source]

You should just need the BG3 Modder's Multitool for this, which you'll use to extract the existing Equipment.txt file from the game. You'll also need a text editor, VSCode or Notepad++ are good options.

Extracting and Placing Equipment.txt[edit | edit source]

Open up your Modder's Multitool and open Search Index. Search for Equipment.txt. Scroll down to Shared\Public\Shared\Stats\Generated\Equipment.txt and open the file folder.

Now, in your Baldur's Gate 3 Data folder, create this file path: Data\Public\Shared\Stats\Generated

Copy the Equipment.txt from the first Generated folder to this newly created one. This new Equipment.txt will overwrite the base game settings for equipment.

Editing Equipment.txt - Removing equipment[edit | edit source]

Before making any changes, we recommend making a copy of the Equipment.txt and naming it something like "Equipment - OG Copy.txt". This is so you can easily revert back to the default later if you so choose.

Now open up Equipment.txt in your text editor. It's a huge file, but you'll see something like this at the top.
new equipment "_PC_Equipment"

new equipment "EQP_Unarmed"
add initialweaponset "Melee"

new equipment "EQP_CC_Barbarian"
add initialweaponset "Melee"
add equipmentgroup
add equipment entry "WPN_Greataxe"
add equipmentgroup
add equipment entry "OBJ_Potion_Healing"
add equipmentgroup
add equipment entry "OBJ_Potion_Healing"
add equipmentgroup
add equipment entry "OBJ_Scroll_Revivify"
add equipmentgroup
add equipment entry "ARM_Shoes_Barbarian"
add equipmentgroup
add equipment entry "ARM_Barbarian"
add equipmentgroup
add equipment entry "WPN_Handaxe"
add equipmentgroup
add equipment entry "WPN_Handaxe"
add equipmentgroup
add equipment entry "OBJ_Keychain"
add equipmentgroup
add equipment entry "OBJ_Bag_AlchemyPouch"
add equipmentgroup
add equipment entry "ARM_Camp_Body"
add equipmentgroup
add equipment entry "ARM_Camp_Shoes"
add equipmentgroup
add equipment entry "OBJ_Backpack_CampSupplies"

<!-- file continues -->
This equipment entry sets the starting equipment for Barbarian. Here's an edited example, where Barbarian is set to spawn in with nothing but their underwear:
nnew equipment "_PC_Equipment"

new equipment "EQP_Unarmed"
add initialweaponset "Melee"

new equipment "EQP_CC_Barbarian"
add initialweaponset "Melee"

new equipment "EQP_CC_Barbarian2"
add initialweaponset "Melee"
add equipmentgroup
add equipment entry "WPN_Greataxe"
add equipmentgroup
add equipment entry "OBJ_Potion_Healing"
add equipmentgroup
add equipment entry "OBJ_Potion_Healing"
add equipmentgroup
add equipment entry "OBJ_Scroll_Revivify"
add equipmentgroup
add equipment entry "ARM_Shoes_Barbarian"
add equipmentgroup
add equipment entry "ARM_Barbarian"
add equipmentgroup
add equipment entry "WPN_Handaxe"
add equipmentgroup
add equipment entry "WPN_Handaxe"
add equipmentgroup
add equipment entry "OBJ_Keychain"
add equipmentgroup
add equipment entry "OBJ_Bag_AlchemyPouch"
add equipmentgroup
add equipment entry "ARM_Camp_Body"
add equipmentgroup
add equipment entry "ARM_Camp_Shoes"
add equipmentgroup
add equipment entry "OBJ_Backpack_CampSupplies"

<!-- file continues -->
As you can see, EQP_CC_Barbarian has been changed to match EQP_Unarmed, which will cause them to spawn in with nothing. The original EQP_CC_Barbarian has been renamed to EQP_CC_Barbarian2, so that if we want to later revert the Barbarian back to default equipment, we can simply delete our EQP_CC_Barbarian entry and rename EQP_CC_Barbarian2 to EQP_CC_Barbarian.

The concept is the same for any class. Keep in mind that some classes have subclasses that each have their own unique equipment set, such as Sorcerer and Paladin. You will need to locate the specific subclass you want to change.

Editing Equipment.txt - Adding/changing equipment[edit | edit source]

But what if you want to change the equipment or add new equipment instead of removing it? Well, here's where you'll have to trawl through the game files to find the right UIDs... or you can just check the Wiki to see if they have it. For example, let's say we want to put Armour of Landfall on our Barbarian, and give them a Greatsword +1. We visit those wiki pages and find that the UID for the outfit is MAG_Druid_Land_Magic_Leather_Armor and the UID for the weapon is WPN_Greatsword_1.

Now we just add these entries to our Barbarian:
new equipment "_PC_Equipment"

new equipment "EQP_Unarmed"
add initialweaponset "Melee"

new equipment "EQP_CC_Barbarian"
add initialweaponset "Melee"
add equipmentgroup
add equipment entry "WPN_Greatsword_1"
add equipmentgroup
add equipment entry "MAG_Druid_Land_Magic_Leather_Armor"

<!-- file continues -->

Now our Barbarian spawns in wearing the Armour of Landfall and with a Greatsword +1 on their back. Wearable items are automatically equipped. Items that aren't wearable (such as potions) will appear in your character's inventory once you start the game.

Warning: adding multiple armors or multiple weapons at once can cause some odd things to happen.