Modding:Editing Equipment.txt: Difference between revisions
No edit summary |
No edit summary |
||
| (4 intermediate revisions by the same user not shown) | |||
| Line 1: | Line 1: | ||
{{Modding box}}{{Modding sidebar}} | {{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 | 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 == | == 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 == | == Extracting and Placing Equipment.txt == | ||
| Line 13: | Line 13: | ||
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. | 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 == | == 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. | 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. | ||
| Line 94: | Line 94: | ||
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. | 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. | ||
{{Modding navbox}} | |||
==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 <code>MAG_Druid_Land_Magic_Leather_Armor</code> and the UID for the weapon is <code>WPN_Greatsword_1</code>. | |||
Now we just add these entries to our Barbarian:<syntaxhighlight lang="xml"> | |||
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 --> | |||
</syntaxhighlight> | |||
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]] | |||
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. |
| 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[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 -->
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[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.
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.