Dying Light Map Dumping Tools (DLMDT)

This project is designed to help you open and edit the original maps from Dying Light using the official Dying Light Developer Tools.

I wanted to continue the work of Brendon, and he gave me permission to do so. I'm not a professional programmer, so if you see any mistakes, please let me know!

Normally, the game's core maps are stored in a format (.sobj) that the developer tools cannot open directly. This toolset allows you to extract those maps and convert them into the .eds format, which the developer tools can understand.

Prerequisites

Before using these tools, make sure you have the following installed on your computer:

1. Python 3.x
2. .NET 8.0 SDK
3. 7-Zip (installed in the default directory)

Build

First, you need to compile the conversion tools. Open your terminal or command prompt in the project folder and run:

dotnet build MapTools.sln

This will create the necessary executable files in the SoDumper and Map2EDS folders.

Then you can run the automation script: python AutoMapDumper.py to dump the maps.

How to Use

The process is largely automated through the AutoMapDumper.py script.

1. Download the latest release from the Releases page.
2. Open your terminal in the DLMDT_Release folder.
3. Run the automation script:

   python AutoMapDumper.py

4. The script will look for your Data2.pak file (usually found in your Steam installation). If it is in a different location, you can provide the path manually.
5. It will scan the game files and show you a list of available maps. Enter the number of the map you want to dump.
6. The script will extract the map, convert it, and save the final .eds file in a folder named DumpedMaps.

Final Manual Steps in Developer Tools

The automation handles the extraction and conversion, but you still need to perform some manual steps in the Dying Light Developer Tools to get the map working properly.

1. Open Data2.pak using 7-Zip and navigate to data\maps\.
2. Copy the folder of the map you selected earlier and paste it onto your Desktop.
3. Inside that folder on your Desktop, change the file extension of the .exp file to .map.
4. Move this entire folder to your project directory within the DevTools workshop: C:\Program Files (x86)\Steam\steamapps\common\Dying Light\DevTools\workshop\(YOUR PROJECT FOLDER)\data\maps
5. Open your project in the Dying Light Developer Tools and load the map.
6. You will see that objects are scattered randomly. This is expected.
7. Place any random object in the map. In the Attributes section, set its Matrix coordinates to 0, 0, 0 (x, y, z).
8. Group this object, save the map, and exit the editor.
9. Find the .eds file generated by the program in the DumpedMaps folder.
10. Rename this file to match the name of the group you just created in the editor.
11. Replace the existing .eds file in your workshop folder with your renamed file.
12. When you reopen the map in the Developer Tools, all objects should be correctly positioned and loaded.

For easier editing, you can use the 'Destroy Hierarchy' option to ungroup the objects once they are loaded.