Modding:Editing Equipment.txt: Difference between revisions

Latest revision as of 17:07, 13 January 2024

This page is a modding page, and follows its own rules and standards separate from the rest of the wiki.

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.

@@ Line 1: / Line 1: @@
 {{Modding box}}{{Modding sidebar}}
-To change the starting equipment for your game's classes, you can edit the Equipment.txt file. But how do you do that?
+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 '''[https://github.com/ShinyHobo/BG3-Modders-Multitool 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, [https://code.visualstudio.com/ VSCode] or [https://notepad-plus-plus.org/ Notepad++] are good options.
+You should just need the '''[https://github.com/ShinyHobo/BG3-Modders-Multitool 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, [https://code.visualstudio.com/ '''VSCode'''] or [https://notepad-plus-plus.org/ '''Notepad++'''] are good options.
 == Extracting and Placing Equipment.txt ==
@@ Line 113: / Line 113: @@
 <!-- file continues -->
 </syntaxhighlight>
-Now our Barbarian spawns in wearing the Armour of Landfall and with a Greatsword +1 on their back.{{Modding navbox}}
+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.{{Modding navbox}}
+[[Category:Modding guides]]

v t e Modding homepage
Modding homepage	Modding homepage
Modding resources - Meshes, Models, Tools, etc.	Armor/Clothing Texture Maps Body Models Custom polymorph Dependencies Face and body textures Fixing bone errors Fixing neck seams Fixing UV errors Getting Started with BG3 Modding Hair Meshes Head Models Mod troubleshooting Modding class icons NPC Head Models Tiefling Horn Models Non-VT Shaders Race UUID Sample Templates Texture formatting Tools TreasureTables References Tutorials VertexColorMaskSlots Working with LSX files
Modding guides	BG3 Mini Tool Blender Export Settings Code Snippets Coding An Item Compatibility Framework Creating a custom cloth collider Creating and Exporting Meshes in Blender Creating Item Icons Creating meta.lsx Creating mods Editing a Character Creation Preset Editing Equipment.txt Hotloading How To Find A Virtual Texture Installing mods Localization Modding resources Packaging mods Texture formatting Understanding Mod Folder Structure Unpacking and converting files Working with LSX files
Hair modding	Creating Custom Hair with Hair Tool Creating hair merged.lsf with custom texture Creating Hair Mods Creating meta.lsx Custom Hair Highlights Hair Meshes Hair Mod File Setup Hair Mod Mesh Setup
Head modding	Creating meta.lsx Face and body textures Fixing neck seams Head Modding Head Models Head Troubleshooting NPC Head Models
Item modding - Armours, Outfits, Weapons etc.	Armor/Clothing Texture Maps Coding An Item Creating and Exporting Meshes in Blender Creating Armor Mods Creating Item Icons Creating meta.lsx Creating Outfit Textures Fixing bone errors How To Find A Virtual Texture Texture formatting TreasureTables References Use Outfit Builder To Refit Outfits VertexColorMaskSlots