Editing Modding:Unpacking and converting files
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 4: | Line 4: | ||
|image=Modding_resources.webp | |image=Modding_resources.webp | ||
}}{{NavModding}} | }}{{NavModding}} | ||
== | == Tools == | ||
* LSLIB by Norbyte | * LSLIB by Norbyte | ||
** ''Note: This step is primarily for acquiring the '''granny2.dll''' from a previous version of LSLIB. The latest release version may already have this file present, in which case you can just install the latest release.'' | ** ''Note: This step is primarily for acquiring the '''granny2.dll''' from a previous version of LSLIB. The latest release version may already have this file present, in which case you can just install the latest release.'' | ||
** Install [https://github.com/Norbyte/lslib/releases/tag/v1.15.13 1.15.13] first, then install whichever is the [https://github.com/Norbyte/lslib/releases LATEST] release | ** Install [https://github.com/Norbyte/lslib/releases/tag/v1.15.13 1.15.13] first, then install whichever is the [https://github.com/Norbyte/lslib/releases LATEST] release | ||
* Modders Multitool by ShinyHobo | * Modders Multitool by ShinyHobo | ||
** Install [https://github.com/ShinyHobo/BG3-Modders-Multitool/releases LATEST] release | ** Install [https://github.com/ShinyHobo/BG3-Modders-Multitool/releases LATEST] release | ||
** | ** make sure the folder you use for Multitool is separate from LSLIB | ||
'''The Tool has an official wiki that now breaks down unpacking and other parts of the tool: [https://github.com/ShinyHobo/BG3-Modders-Multitool/wiki BG3 Modders Multitool Wiki]''' | '''The Tool has an official wiki that now breaks down unpacking and other parts of the tool: [https://github.com/ShinyHobo/BG3-Modders-Multitool/wiki BG3 Modders Multitool Wiki]''' | ||
Line 29: | Line 29: | ||
== Unpacking Process == | == Unpacking Process == | ||
Currently we no longer need to directly unpack the game pak files thanks to Multitool updates. Instead, you can index your files and unpack the files as you need them. This saves you some hard drive space | Currently we no longer need to directly unpack the game pak files thanks to Multitool updates. Instead, you can index your files and unpack the files as you need them. This saves you some hard drive space as BG3 has a lot of files. | ||
In Multitool, go to {{InfoBlob|Utilities > Index > Index Pak Files}} and this will now index all the unpacked pak files. Much quicker and easier to maintain than unpacking all needed paks. | |||
In Multitool, go to {{InfoBlob|Utilities > Index > Index Pak Files}} and this will now index all the unpacked pak files. Much quicker and easier to maintain than unpacking all | |||
* When we get new hot fixes, follow the above again to index the new hotfix paks. | * When we get new hot fixes, follow the above again to index the new hotfix paks. | ||
However | However when we get a full patch release it is advised to first clear our index and reindex using the following method: {{InfoBlob|Utilities > Index > Clear Index and then Utilities > Index > Index Pak Files}} | ||
If you still want to unpack game paks manually rather than unpacking individual files via the new method, you can use: '''{{InfoBlob|'''Utilities''' > '''Game File Operations''' > '''Unpack Game Files'''.}}''' | If you still want to unpack game paks manually rather than unpacking individual files via the new method, you can use: '''{{InfoBlob|'''Utilities''' > '''Game File Operations''' > '''Unpack Game Files'''.}}''' | ||
* A menu will appear similar to below: | |||
** As of Patch 4, when a new patch is released, the hotfix paks get implemented into the main paks. | ** As of Patch 4, when a new patch is released, the hotfix paks get implemented into the main paks. | ||
[[File:Unpack paks.webp]] | [[File:Unpack paks.webp]] | ||
Common files: | Common files: | ||
* English.pak — this is where the localization files are located | * English.pak — this is where the localization files are located. All text strings that are displayed in the game. | ||
* Gustav.pak — text files in .lsf format. Level data, dialog files, equipment stats, spells. | * Gustav.pak — text files in .lsf format. Level data, dialog files, equipment stats, spells. | ||
* Materials.pak — materials (shaders). It is useless in itself, but you can see what materials are in the game to assign them to your model. | * Materials.pak — materials (shaders). It is useless in itself, but you can see what materials are in the game to assign them to your model. | ||
* Models.pak — models in .gr2 format. Heads, hair, armour, architecture, etc. | * Models.pak — models in .gr2 format. Heads, hair, armour, architecture, etc. | ||
* Textures.pak — textures in .dds format. There are not a lot of them here, | * Textures.pak — textures in .dds format. There are not a lot of them here, mostly they are color ID masks that divide the armour into zones for coloring. But there are textures for faces, hair, tattoos. Some environment textures. | ||
* Shared.pak — text files in .lsf format. Overlaps with Gustav in some respects. Model data with assigned materials, skin, hair, eye colors, etc. for the character editor, also equipment stats, spells. | * Shared.pak — text files in .lsf format. Overlaps with Gustav in some respects. Model data with assigned materials, skin, hair, eye colors, etc. for the character editor, also equipment stats, spells. | ||
* VirtualTextures.pak — | * VirtualTextures.pak — most of the textures of the game, are packed in virtual textures to improve performance. | ||
* Voice.pak — voice lines. | * Voice.pak — voice lines. | ||
Line 124: | Line 97: | ||
=== .loca → .xml === | === .loca → .xml === | ||
Localization text from '''English.pak''' (the same for other languages). | Localization text from '''English.pak''' (presumably the same for other languages). | ||
The <code>.loca</code> files can be converted with Export Tool. Select the <code>.loca</code> file and specify the name of a <code>.xml</code> file to use as output. | The <code>.loca</code> files can be converted with Export Tool. Select the <code>.loca</code> file and specify the name of a <code>.xml</code> file to use as output. | ||
[[Category:Modding guides]] | [[Category:Modding guides]] |