Editing Modding:Creating meta.lsx
Jump to navigation
Jump to search
The edit can be undone. Please check the comparison below to verify that this is what you want to do, and then publish the changes below to finish undoing the edit.
Latest revision | Your text | ||
Line 3: | Line 3: | ||
|description=This page is a hub for everything related to Modding Baldur's Gate 3. Check out the following guides to learn how to mod BG3. | |description=This page is a hub for everything related to Modding Baldur's Gate 3. Check out the following guides to learn how to mod BG3. | ||
|image=Modding_resources.webp | |image=Modding_resources.webp | ||
}}{{ | }}{{NavModding}} | ||
== Tools == | |||
== Tools | |||
* [https://github.com/ShinyHobo/BG3-Modders-Multitool BG3 Modders Multitool] | * [https://github.com/ShinyHobo/BG3-Modders-Multitool BG3 Modders Multitool] | ||
* [https://www.nexusmods.com/baldursgate3/mods/502 BG3 Mini Tool] | * [https://www.nexusmods.com/baldursgate3/mods/502 BG3 Mini Tool] | ||
* [https://code.visualstudio.com/ | * [https://code.visualstudio.com/ vscode] or [https://notepad-plus-plus.org/ Notepad++] | ||
* UUID Generator Extension in | * UUID Generator Extension in vscode (right click when its installed to generate a new uuid) | ||
* ToolBucket & XML Tools in Notepad++ found via Plugins > Plugins Admin then search for it and install. | |||
For the UUID generation in Notepad++ once installed ToolBucket you want to press Alt + Shift + G it will bring up a window as shown below. Keep include hyphens ticked and you can also click don't ask again if you won't use any of the other options. | |||
[[File:Toolbucketuuid.webp]] | |||
== Meta.lsx == | |||
So most pak mods need a meta.lsx: | |||
ModName/Mods/YourShared/meta.lsx | |||
The ModName folder being your workspace folder for your mod. Each mod need ones. Then you would create a folder called Mods, then a new folder with a custom name could be same as the mod name this is what will be known as YourShared folder, and then finally you want to create a txt file and rename it to meta.lsx | |||
The only time your mod won't need a meta.lsx if it is classed as a basegame override. You will know them by the mods that get put into the Overrides section of BG3 Mod Manager or have that orange highlight to them. | |||
In some cases you may add a meta even then just so people can place the mod into their load order if they prefer. | |||
=== Creating your Meta.lsx Manually === | |||
<?xml version="1.0" encoding="UTF-8"?> | <?xml version="1.0" encoding="UTF-8"?> | ||
<save> | <save> | ||
Line 45: | Line 41: | ||
<attribute id="Author" type="LSString" value="AUTHOR NAME HERE"/> | <attribute id="Author" type="LSString" value="AUTHOR NAME HERE"/> | ||
<attribute id="CharacterCreationLevelName" type="FixedString" value=""/> | <attribute id="CharacterCreationLevelName" type="FixedString" value=""/> | ||
<attribute id="Description" type="LSString" value=" | <attribute id="Description" type="LSString" value=""/> | ||
<attribute id="Folder" type="LSString" value="MOD FOLDER NAME HERE"/> | <attribute id="Folder" type="LSString" value="MOD FOLDER NAME HERE"/> | ||
<attribute id="LobbyLevelName" type="FixedString" value=""/> | <attribute id="LobbyLevelName" type="FixedString" value=""/> | ||
Line 78: | Line 74: | ||
Let's go over the lines you want to edit: | Let's go over the lines you want to edit: | ||
<attribute id="Author" type="LSString" value="AUTHOR NAME HERE"/> | <attribute id="Author" type="LSString" value="AUTHOR NAME HERE"/> | ||
In this line you want to put your author name | In this line you want to put your author name, can be anything. most use their nexusmods name. | ||
<attribute id="Folder" type="LSString" value="MOD FOLDER NAME HERE"/> | <attribute id="Folder" type="LSString" value="MOD FOLDER NAME HERE"/> | ||
Remember at the beginning when I said "then a new folder with a custom name could be same as the mod name this is what will be known as YourShared folder" this line above you want to match the name you gave that folder. | |||
<attribute id="Name" type="LSString" value="MOD NAME HERE"/> | <attribute id="Name" type="LSString" value="MOD NAME HERE"/> | ||
Name of your mod goes here. Do not put - before a b | Name of your mod goes here. Do not put - before a b as we have found out lately that can cause the mod not to load. | ||
<attribute id="UUID" type="FixedString" value="UUID HERE"/> | <attribute id="UUID" type="FixedString" value="UUID HERE"/> | ||
Generate a | Generate a Unique UUID for this line, it must be unique unless you want it to override another mod. | ||
<attribute id="Version64" type="int64" value="36028797018963968"/> | <attribute id="Version64" type="int64" value="36028797018963968"/> | ||
Now this line when read by bg3 mod manager reads as 1.0.0.0 you can use bg3 mod manager, multitool or mini tool to generate this in file number. This is also the line you change for each new update to your mod to up the version number. | |||
<node id="PublishVersion"> | <node id="PublishVersion"> | ||
Line 111: | Line 99: | ||
</node> | </node> | ||
This version | This version is the version it was when published. Can remain this number even when updating. | ||
And that is all you need to edit for this file. | |||
=== | === Generate Version Number with the tools === | ||
You can generate a version number with | You can generate a version number with multitool, bg3 mod manager and the mini tool. Here is how: | ||
==== Multitool ==== | ==== Multitool ==== | ||
Line 129: | Line 117: | ||
[[File:BG3 Multitool version number editor.webp]] | [[File:BG3 Multitool version number editor.webp]] | ||
Use the up and down arrows on the Major/Minor/Revision/Build | Use the up and down arrows on the Major/Minor/Revision/Build and it will change the number below. Once set to the version you want use the copy button on the second line and paste it into the first of this line in your meta: | ||
<attribute id="Version64" type="int64" value="36028797018963968"/> | <attribute id="Version64" type="int64" value="36028797018963968"/> | ||
Line 135: | Line 123: | ||
==== BG3 Mod Manager ==== | ==== BG3 Mod Manager ==== | ||
In BG3 Mod Manager go to Tools > Toggle Version Generator Window | In BG3 Mod Manager go to Tools > Toggle Version Generator Window or alternatively while open press Ctrl + G to open it. As below: | ||
[[File:Bg3mm version number.webp]] | [[File:Bg3mm version number.webp]] | ||
Line 143: | Line 131: | ||
[[File:Bg3mm version number01.webp]] | [[File:Bg3mm version number01.webp]] | ||
Use the up and down arrows on the Major/Minor/Revision/Build | Use the up and down arrows on the Major/Minor/Revision/Build and it will change the number below. Once set to the version you want use the copy button and paste it into the first of this line in your meta: | ||
<attribute id="Version64" type="int64" value="36028797018963968"/> | <attribute id="Version64" type="int64" value="36028797018963968"/> | ||
Line 153: | Line 141: | ||
[[File:Bg3minitool versionnumber.webp]] | [[File:Bg3minitool versionnumber.webp]] | ||
It will open the current extra tools of the mini tool. | It will open this with the current extra tools of the mini tool. | ||
Use the up and down arrows on the | Use the up and down arrows on the Major/Minor/Revision/Build and it will change the number below. Once set to the version you want use either highlight the text in the box and copy and paste it into the first of this line in your meta: | ||
<attribute id="Version64" type="int64" value="36028797018963968"/> | <attribute id="Version64" type="int64" value="36028797018963968"/> | ||
Or use the | Or use the Save to button, locate your meta.lsx and it will override the lines for you. | ||
=== Creating your | === Creating your Meta with the Multitool === | ||
Once your mod is complete and ready to be tested in | Once your mod is complete and ready to be tested in game create a Mods folder in your workspace folder, then drag your workspace folder to the blue box that says "Drop mod workspace folder or a mod.pak here" if your Mods folder doesn't have a meta it will bring up this popup: | ||
[[File:Metacreationbg3multitool.webp]] | [[File:Metacreationbg3multitool.webp]] | ||
In the Author box | In the Author box put the name you go by on nexusmods or whatever you want. | ||
In | In description describe your mod a little, can be anything. | ||
Then choose your version number for your mod. Once ready | Then choose your version number for your mod. Once ready you can click the confirm button. | ||
If wanting to update the number | If wanting to update the number you can delete your meta it creates and drag your workspace folder again over the blue box. | ||
=== Creating your meta.lsx with bg3 mini tool | === Creating your meta.lsx with bg3 mini tool === | ||
If you find it easier to follow videos or have a video alongside a written tutorial | If you find it easier to follow videos or have a video alongside a written tutorial please find my video [https://youtu.be/tanDAq3JKPU?si=P4aJ3Rul4MeKIxdU here] on how to use that section of my tool. | ||
Once you open the tool you will see a button called meta that is the one we want. | Once you open the tool you will see a button called meta that is the one we want. | ||
Line 201: | Line 189: | ||
Unique UUID | Unique UUID | ||
* use the | * use the generate unique uuid button and then click update once its generated. | ||
** you want this to be unique so it doesn't clash with other mods | ** you want this to be unique so it doesn't clash with other mods | ||
Line 209: | Line 197: | ||
Now you can click save as and go save your file in the ModName/Mods/YourShared folder. | Now you can click save as and go save your file in the ModName/Mods/YourShared folder. | ||
Congrats | Congrats your meta.lsx is ready to go | ||