Modding:Editing Equipment.txt
This page is a modding page, and follows its own rules and standards separate from the rest of the wiki. |
bg3.wiki modding |
---|
Modding homepage |
Modding resources - Meshes, Models, Tools, etc. |
Modding guides |
Hair modding |
Head modding |
Item modding - Armours, Outfits, Weapons etc. |
Race/class modding |
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
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
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
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 -->
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 -->
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
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
.
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.