BG3 Localization Merger is a program designed to merge two languages together within Baldur's Gate 3, a video game.
This tool allows you to merge strings from various categories:
- Dialogues
- Books
- Items
- Status
- Characters
- Quests
- Tooltips
- Hints
- Miscs
A cautionary option is available to merge all strings in the game. This can cause overflow in some user interfaces. Use with care.
Follow these steps to install and use the tool:
- Download the latest release.
- Extract the downloaded files to a location of your choice.
- Run
BG3LocalizationMerger.exe
.
You can skip this step if you are merging unconditionally.
To proceed, follow these instructions:
- Install BG3 Modder's Multitool:
- Download and run BG3 Modder's Multitool.
- Complete the basic configuration by clicking Configuration in the menu.
- Unpack the following packages by selecting Utilities/Game File Operations/Unpack Game Files:
Game.pak
Gustav.pak
Shared.pak
Patch*.pak
(Optional)
- After unpacking, select Utilities/Game File Operations/Decompress UnpackedData Files and wait for the process to complete.
- Close the tool.
- The unpacked data can be found in
[BG3 Modder's Multitool Folder]/UnpackedData
.
Proceed with these steps to fill in the required information:
- Unpacked Data Folder: Provide the path to the
UnpackedData
folder from step 1.- Skip this if you are merging unconditionally.
- Language Pack: Locate the localization pack file for your game language.
- Find this file in
[BG3 Game Folder]/Data/Localization
. - Example:
[BG3 Game Folder]/Data/Localization/English.pak
.
- Find this file in
- Reference Language Pack: Select the second language pack.
- Example:
[BG3 Game Folder]/Data/Localization/ChineseTraditional/ChineseTraditional.pak
.
- Example:
- Export File Path: Specify the location to save the merged language pack.
- Use the same file name as the current language pack of the game and put it in a temporary folder.
- Example:
D:\Temp\ChineseTraditional.pak
- Toggle the categories you wish to merge.
- Click Merge and wait for the process to complete.
- If you're merging unconditionally, click Merge Everything instead.
- Replace the current language pack file of the game with the exported file. E.g.
[BG3 Game Folder]/Data/Localization/ChineseTraditional/ChineseTraditional.pak
That's it! If you encounter any issues or have any suggestions, please consider checking for existing issues or opening a new issue.
To ensure the language pack stays up-to-date, you might need to merge again:
-
If it's a hotfix, you'll only need to unpack and decompress the newest hotfix file. E.g.
Patch5_Hotfix6.pak
-
If it's a major patch, you'll need to remove the
Patch*_Hotfix*
folders in yourUnpackedData
folder first to avoid conflicts, then redo all the steps.