This project is a re-implementation of the Diablo2 game coupled with patching facilities for modders. The aim is to provide the modding community with an easy tool to understand and patch the game. To ensure that we stay as close as possible to the original game, we do not provide fixes for bugs (yet).

The game assets, main executable code and anything related to hacking or piracy is NOT endorsed by the authors, and as such we will not provide code related to such subjects. The original game assets and binaries is required to use this project.

For the patching we rely on the D2.Detours project, which is included as a git submodule. (use the git submodule update --init command, or clone this project with git clone --recursive) You will also need to install the CMake build system and Visual C++ (or any C++ compiler that can generate .DLLs on Windows) which are freely available.

In the current directory:

# Configure the CMake project
cmake -A Win32 -B build
# Build the release config
cmake --build build --config Release
# Install
cmake --install build --config Release --prefix YOUR_INSTALL_FOLDER

• Build D2MOO
• Launch Diablo2 (or D2SE) by using the command D2.DetoursLauncher [Path to D2 or D2SE].
  • If the Game.exe/D2SE.exe executable is not provided, you can start it from the game folder. It can also detect the installation path.
  • The detours .dll expects patch dlls to be in patch folder of the Diablo2/D2SE executable. This can be overriden using the DIABLO2_PATCH environment variable.

The debug targets are already configured and set as startup project when using Visual Studio.

Note that it will spawn the game/D2SE as a subprocess, so you might be interested in the following Visual Studio extension Microsoft Child Process Debugging Power Tool. Then go to Debug > Other debug targets > Child process debugging settings, enable & save.

The project is currently based on the 1.10f version of the game. Feel free to submit patches for other versions of the game!

The code was originally extracted by a reverse engineering tool, and slowly cleaned to use understandable names

Not yet, but this is one of the objectives ! We are in the (slow) process of checking each ordinal (exported functions) and patching them one by one. See D2Common.patch.cpp for the current status of each ordinal.

Because it contains a lot of functions that are used in both, client and server code, and as such, it serves as a solid base for further work.
We might add other DLLs in the future if there is enough interest / help from the community. Any contributions are welcome.

The documentation for that is not written yet, please contact us directly on the Phrozen Keep forums / Discord server. More importantly, we need your feedback to determine a roadmap.

We felt that the current projects are not good enough, and more importantly did not cover enough parts of the game. Having a centralized code that one can launch and use as reference will make it easier, we hope, for the modding community.

Please have a look at Microsoft Child Process Debugging Power Tool.

Please feel free to open an issue or visit the Phrozen Keep forums / Discord server !

This could not have been done without the amazing help and work of the Phrozen Keep community! Non-exhaustive list of members who helped putting this together (alphabetical order):

• @FearedBliss
• @Firehawk
• @Kingpin
• @Lectem
• @lolet
• @Mentor
• @misiek1294
• @Mnw1995
• @Myhrginoc
• @Necrolis
• @Nefarius
• @Ogodei
• Paul Siramy
• @raler (that sparked the idea for the current name of the project)
• @SVR
• @Szumigajowy
• @whist
• ...

If you think you should be on this list, reach us on the forum, discord, or open a pull request!

The source code in this repository is intended for non-commercial use only. However it uses a permissive license so that any modder may use this. Credits to the team are appreciated, and the license must be preserved in derivative work.

Battle.net(R) - Copyright (C) 1996 Blizzard Entertainment, Inc. All rights reserved. Battle.net and Blizzard Entertainment are trademarks or registered trademarks of Blizzard Entertainment, Inc. in the U.S. and/or other countries.

Diablo(R) - Copyright (C) 1996 Blizzard Entertainment, Inc. All rights reserved. Diablo and Blizzard Entertainment are trademarks or registered trademarks of Blizzard Entertainment, Inc. in the U.S. and/or other countries.

D2MOO and any of its' maintainers are in no way associated with or endorsed by Blizzard Entertainment(R).