Fusion

a more unreal fuel than diesel

Collection of scripts to help port payday2 diesel maps to unreal engine

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

imagemagick

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.

To use it run it inside Unreal Engine

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