2023-11-11 06:28:55 +00:00
# Fusion
2023-11-12 18:15:18 +00:00
### a more unreal fuel than diesel
2023-11-11 06:28:55 +00:00
2023-11-13 00:51:12 +00:00
### Collection of scripts to help port payday2 diesel maps to unreal engine
2023-11-11 06:29:24 +00:00
2024-01-17 20:15:09 +00:00
> #### Disclaimer this stuff is not really polished, mainly for self use, use at own discretion
2023-11-11 06:29:24 +00:00
## Overview
### Needed software
2023-11-12 17:22:55 +00:00
[PAYDAY 2 Model Tool ](https://github.com/kythyria/payday2-model-tool/releases )
2023-11-11 06:29:24 +00:00
[PAYDAY-2-Hashlist ](https://github.com/Luffyyy/PAYDAY-2-Hashlist )
[DieselBundleViewer ](https://github.com/Luffyyy/DieselBundleViewer )
[BeardLib-Editor ](https://github.com/Luffyyy/BeardLib-Editor )
2023-11-12 17:22:55 +00:00
[Blender ](https://www.blender.org/ )
2023-11-11 06:29:24 +00:00
[Python]
2023-11-13 00:51:12 +00:00
### 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
[imagemagick ](https://imagemagick.org/script/download.php#windows )
2023-11-11 06:29:24 +00:00
### 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
2023-11-12 17:22:55 +00:00
## Get started
### Download the project files.
2023-11-12 18:10:30 +00:00
Download files by using Download ZIP
2023-11-12 17:22:55 +00:00
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 ](https://github.com/Luffyyy/DieselBundleViewer ) and open payday2s bundle_db.blb
2023-11-12 18:10:30 +00:00
Open DieselBundleViewer
Open bundle_db.blb
2023-11-12 17:22:55 +00:00
2023-11-12 18:10:30 +00:00
2023-11-12 17:22:55 +00:00
2023-11-13 01:11:01 +00:00
Navigate to /levels/narratives and choose a map to port, in my case First World Bank
2023-11-12 17:22:55 +00:00
2023-11-12 18:10:30 +00:00
Navigate to /levels/narratives/classics/red2
2023-11-13 01:11:01 +00:00
Then go into the world folder
2023-11-12 18:10:30 +00:00
2023-11-12 17:22:55 +00:00
2023-11-12 18:10:30 +00:00
Press Convert and Save as
2023-11-12 17:22:55 +00:00
2023-11-12 18:10:30 +00:00
2023-11-12 17:22:55 +00:00
2023-11-12 18:10:30 +00:00
Then save it on the /WorldFiles/DieselWorldCONTINENT
2023-11-12 17:22:55 +00:00
### Get started with pdworld2json.py
Install python
2023-11-12 18:10:30 +00:00
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
2023-11-12 17:22:55 +00:00
2023-11-13 01:11:01 +00:00
You can also just install it a different way this is just the easiest personally.
2023-11-12 17:22:55 +00:00
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
```
2023-11-12 18:10:30 +00:00
You should have a world.json like this
2023-11-12 17:22:55 +00:00
2023-11-13 01:11:01 +00:00
**It should also have printed out what files you will need to export you will need to remember that**
2023-11-12 17:22:55 +00:00
### 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 ](https://github.com/kythyria/payday2-model-tool/releases ) [PAYDAY-2-Hashlist ](https://github.com/Luffyyy/PAYDAY-2-Hashlist )
2023-11-12 18:10:30 +00:00
Extract PD2ModelParser.exe like this
2023-11-12 17:22:55 +00:00
2023-11-12 18:10:30 +00:00
Next extract the hashlist in the root of the PD2ModelParser.exe this is very important or else the rest will not work
2023-11-12 17:22:55 +00:00
2023-11-13 01:11:01 +00:00
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.
2023-11-12 17:22:55 +00:00
2023-11-13 01:11:01 +00:00
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.
2023-11-12 17:22:55 +00:00
```
.\PD2ModelParser.exe --batch-export=VALUE
```
2023-11-13 01:11:01 +00:00
After it has finished, we need to sort the data for the next step, so open ModelCopyForBlender.bat
2023-11-12 17:22:55 +00:00
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
2023-11-13 00:51:12 +00:00
### **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
```
2023-11-12 17:22:55 +00:00
2023-11-13 00:51:12 +00:00
Now we should have a bunch of models inside output with the proper folder structure but they are not really usable in unreal.
2023-11-12 17:22:55 +00:00
So download [Blender ](https://www.blender.org/ ) if you haven't already and open ConvertExportedToUnreal.blend.
2023-11-13 00:51:12 +00:00
If for some reason you cant open the .blend file anymore, you can just make a new project and load the blender scripts
2023-11-12 18:10:30 +00:00
2023-11-12 17:22:55 +00:00
2023-11-13 00:51:12 +00:00
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.
2023-11-12 18:10:30 +00:00
2023-11-13 00:51:12 +00:00
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.
2023-11-13 01:11:01 +00:00
(Sometimes Overkill uses textures outside dlc folder so there will be missing textures I will have to fix that)
2023-11-12 18:10:30 +00:00
### Importing models into unreal
2023-11-13 01:11:01 +00:00
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.
2023-11-13 00:51:12 +00:00
Run python scripts in UE5
And UE4
Now suffer though the slow import, this will by far take the longest time so get compfy
2023-11-12 18:10:30 +00:00
### Importing map data
2023-11-13 01:19:08 +00:00
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
2023-11-13 00:51:12 +00:00
Next open the level spawner widget like this
Choose the map files and hit spawn map
### Profit???
2023-11-13 01:11:01 +00:00
Well now you've done it, I hope at least. When anything goes wrong don't worry, read over this ReadMe.
2023-11-13 00:51:12 +00:00
2023-11-13 01:11:01 +00:00
If you cant figure it out come and reach out to me i'll try to hep as best I can.
2023-11-13 00:51:12 +00:00
You can find me on discord under boo3
