boo3 611a570376 | ||
---|---|---|
UnrealEditorFiles | ||
WorldFiles | ||
assets/images | ||
.gitignore | ||
ConvertExportedToUnreal.blend | ||
ConvertExportedToUnreal.blend1 | ||
ExportModels.bat | ||
LICENSE | ||
ModelCopyForBlender.bat | ||
README.md | ||
UE4_ConvertTextureFiles.py | ||
UE4_Importer.py | ||
UE4_blender_script.py | ||
UE5_Importer.py | ||
UE5_blender_script.py | ||
pdworld2json.py | ||
requirements.txt |
README.md
Fusion
a more unreal fuel than diesel
Collection of scripts to help port payday2 diesel maps to unreal engine
Disclaimer this stuff is not really polished, mainly for self use, use at own discretion
Overview
Needed software
PAYDAY 2 Model Tool PAYDAY-2-Hashlist DieselBundleViewer BeardLib-Editor Blender [Python]
If you want to use this to port maps to payday3 you will need imagemagick because the .dds files need to be converted to .png because UE 4.7 cant import .dds files
pdworld2json.py
Converts world.continent files to the json format and fixes location rotation to work with unreal.
ConvertExportedToUnreal.blend
Fixes Model files exported by the PD2ModelParser, like removing unneeded objects rotating models propely and setting the origin corectly.
ExportModels.bat
Makes it easier to export models by just letting it run via a bat in the background
ModelCopyForBlender.bat
Makes it easier to set up a work folder for blender
Get started
Download the project files.
Download files by using Download ZIP
Extract the contents, make sure you have enough space for the game assets later. The extracted game assets are quite large.
Export Level data
Install DieselBundleViewer and open payday2s bundle_db.blb Open DieselBundleViewer
Open bundle_db.blb
Navigate to /levels/narratives and choose a map to port, in my case First World Bank
Navigate to /levels/narratives/classics/red2
Then go into the world folder
Press Convert and Save as
Then save it on the /WorldFiles/DieselWorldCONTINENT
Get started with pdworld2json.py
Install python
Open a Powershell Terminal and write python3
It should open the windows store, hit install and let it finish installing python
After the install make sure if it is installed
You can also just install it a different way this is just the easiest personally.
Next install the requirements using requirements.txt
Open a Powershell Terminal in the Folder you extracted the project files.
Then use the command
pip install -r requirements.txt
Next run this command to convert the world.continent to a json
python .\pdworld2json.py
You should have a world.json like this
It should also have printed out what files you will need to export you will need to remember that
Export the needed assets from the game
Go back to Diesel Bundle Viewer and navigate to /units
Export the needed files Printed out by pdworld2json.py (In my case it is pd2_dlc_red, pd2_dlc_drive, pd2_dlc1, payday2, pd2_dlc_arena, pd2_dlc_eng, units, pd2_dlc2, vehicles, pd2_dlc_casino, lights, world, equipment, dev_tools, pd2_mcmansion)
Mark them Right Click and Press save as and save them in your project folder in a folder called "units"
Convert .model files in the unit folder and make them ready for blender
Make sure to download PAYDAY 2 Model Tool PAYDAY-2-Hashlist
Extract PD2ModelParser.exe like this
Next extract the hashlist in the root of the PD2ModelParser.exe this is very important or else the rest will not work
If all is done right just open ExportModels.bat and it should export the models. It will take a bit for it to finish so sit back and relax.
You can also use this, it is faster, but I found if it encounters an error it will crash, and not export the rest, using the .bat makes if it encounters an error it will just continue.
.\PD2ModelParser.exe --batch-export=VALUE
After it has finished, we need to sort the data for the next step, so open ModelCopyForBlender.bat
It should have created 2 more folders output and textures, and copied the data needed for blender.
Fixing the models using blender and a script
Depending on what engine you will port to stuff is now gonna change remember to install imagemagick if you plan to use UE4
For Unreal 4 users run UE4_ConvertTextureFiles to convert the texture files to .PNGs
python .\UE4_ConvertTextureFiles.py
Now we should have a bunch of models inside output with the proper folder structure but they are not really usable in unreal.
So download Blender if you haven't already and open ConvertExportedToUnreal.blend.
If for some reason you cant open the .blend file anymore, you can just make a new project and load the blender scripts
Chose the right script for what engine UE4 or UE5
If up to this point you have done everything correct you should be able to hit the run script button, and wait for it to finish. It will take a while depending of the amount of files you have. Blender will lag but don't worry.
When done it should have created a folder called "done" there you will find the fixed models and if you had the textures properly setup they should have applied too. (Sometimes Overkill uses textures outside dlc folder so there will be missing textures I will have to fix that)
Importing models into unreal
Because the amount of data to import is so huge unreal sometimes likes to crash so I made 2 scripts (One for UE4 and UE5) to help with that, you might need an auto clicker because you will need to press import a lot with it.
Run python scripts in UE5
And UE4
Now suffer though the slow import, this will by far take the longest time so get compfy
Importing map data
Ok you done it all, homestretch. Now make sure to add the Files from the "UnrealEditorFiles/" Folder into your project.
Reload the project now try to drag the world.json into the Content Browser It should pop up with a json import window, select the DataTable Row Type to be PDWorldJson and hit apply
Next open the level spawner widget like this
Choose the map files and hit spawn map
Profit???
Well now you've done it, I hope at least. When anything goes wrong don't worry, read over this ReadMe.
If you cant figure it out come and reach out to me i'll try to hep as best I can.
You can find me on discord under boo3