0 of 0
About this mod
Dice Mod Helper is a simple utility program that will simplify the Dice Mod creation process, so you can begin creating your very own dice in 7 simple steps.
- Requirements
- Permissions and credits
- Donations
Package your dice mods in as fast as 30 seconds!
Version 2.1.1 released:
- Automatic .xml conversion
- In-app Handle and UUID generation
- In-app .xml to .loca conversion
- Localization support for all official BG3 languages!
- Resolved icon error. (Thanks for letting me know, Anecx and Jeido!)
This will be the final release for a while until I figure out how to create version numbers for mods.
Also, there's no longer a need to press "Convert XML to .loca," it's been kept for edge cases if you want to touch the files one by one.
NEW IN 2.0
Comprehensive Localization support has been added! Select and fill out as many languages you want to localize for. Swap between languages and convert when you're ready. It'll automatically create all the localization folders for all the language forms you filled out.
This utility would not be possible without Koriik's "Dice Set Expansion - Homebrew" template, which serves as the foundation for the created .lsx and .xml files. This guide will not cover how to create .DDS files and their accompanying animation sets, Anecx has a nexus page for generating the sprites if you're interested: Dice Sprites Generator Make Your Own Dice Faster
You can find the source for the .exe created using pyinstaller here: DiceModHelper: Repository for the "Dice Mod Helper" on nexusmods.com
For this guide you will need:
Step 0.
Choose your localization language, by default it's English. Switch if necessary
Dice in-game (German)
Localizations
If you're a polyglot or have lots of contributors, you can generate all of your localization in one go!
Choose your localization language, by default it's English. Switch if necessary
Step 1.
Press the generate button to the right of Handle [1] and Handle [2]. Type in your folder name (note: This will be the name of specific dice folders once you press build). It's best practice to use a standard naming nomenclature such as "{KeyWord}Dice", so "MoonDice" is a good example. You don't need to do that, but it's what I do, so I'm recommending it.
Step 2.
Next fill out the Name and Description. This is the name and description that will appear in game. Also Click on the generate button to create your Mod UUID. Make sure to generate a new UUID for each new mod you make so there are no conflicts.
Step 2a. (Optional)
Click on the language drop down menu.
Step 2b. (Optional)
Click on the language drop down menu.
Step 3.
Fill out the meta information form. Author (you), Mod Name (How it will appear in a mod manager), and Mod Description (It's description in a mod manager). And lastly, select your Output Directory. It should be an empty directory with no other files!
Step 4.
Press the Build button. make sure you selected an empty output directory before doing this!
Step 5.
Lastly, open up your .DDS folder and paste in your Dice Files (Make sure the extension is capitalized! .dds will NOT work). Paste in your .DDS files.
Step 6.
Congratulation's you're done with my utility. Now open LSlib and paste your output path in the source path. The package path can be anywhere, just make sure to add /DiceName.pak at the end so it creates the .pak. Please, please, be mindful of the .pak extension or you will get an error.
Step 7.
Import the mod into your mod manger. I'm using BG3MM (Baldur's Gate 3 Mod Manager). If you want to upload your mod to nexusmods.com you'll want to place your mod.pak inside of an archive [.rar, .zip., .7z]
Fruits of your labor
Dice in-game (English)
Press the generate button to the right of Handle [1] and Handle [2]. Type in your folder name (note: This will be the name of specific dice folders once you press build). It's best practice to use a standard naming nomenclature such as "{KeyWord}Dice", so "MoonDice" is a good example. You don't need to do that, but it's what I do, so I'm recommending it.
Step 2.
Next fill out the Name and Description. This is the name and description that will appear in game. Also Click on the generate button to create your Mod UUID. Make sure to generate a new UUID for each new mod you make so there are no conflicts.
Step 2a. (Optional)
Click on the language drop down menu.
Step 2b. (Optional)
Click on the language drop down menu.
Step 3.
Fill out the meta information form. Author (you), Mod Name (How it will appear in a mod manager), and Mod Description (It's description in a mod manager). And lastly, select your Output Directory. It should be an empty directory with no other files!
Step 4.
Press the Build button. make sure you selected an empty output directory before doing this!
Step 5.
Lastly, open up your .DDS folder and paste in your Dice Files (Make sure the extension is capitalized! .dds will NOT work). Paste in your .DDS files.
Step 6.
Congratulation's you're done with my utility. Now open LSlib and paste your output path in the source path. The package path can be anywhere, just make sure to add /DiceName.pak at the end so it creates the .pak. Please, please, be mindful of the .pak extension or you will get an error.
Step 7.
Import the mod into your mod manger. I'm using BG3MM (Baldur's Gate 3 Mod Manager). If you want to upload your mod to nexusmods.com you'll want to place your mod.pak inside of an archive [.rar, .zip., .7z]
Fruits of your labor
Dice in-game (English)
Dice in-game (German)
Localizations
If you're a polyglot or have lots of contributors, you can generate all of your localization in one go!