Join us on Discord!\ Development Live stream\ Support us on patreon
About this project
OpenDiablo2 is an ARPG game engine in the same vein of the 2000's games, and supports playing Diablo 2. The engine is written in golang and is cross platform. However, please note that this project does not ship with the assets or content required to play Diablo 2. You must have a legally purchased copy of Diablo 2 and its expansion Lord of Destruction installed on your computer in order to run that game on this engine. If you have an original copy of the disks, those files should work fine as well.
We are currently working on features necessary to play Diablo 2 in its entirety. After this is completed, we will work on expanding the project to include tools and plugin support for modding, as well as writing completely new games with the engine.
Please note that this game is neither developed by, nor endorsed by Blizzard or its parent company Activision.
Diablo 2 and its content is ©2000 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.
ALL OTHER TRADEMARKS ARE THE PROPERTY OF THEIR RESPECTIVE OWNERS.
To pull the project down, run
On windows this folder will most likely be in
In the root folder, run
go get -d to pull down all
To run the project, run
go run . from the root
You can also open the root folder in VSCode. Make sure you have
ms-vscode.go plugin installed.
There are several dependencies which need to be installed
additionally. To install them you can use
the project root folder - this script takes care of the
installation for you.
The imports for this project utilize
github.com/OpenDiablo2/OpenDiablo2. This means that
even if you clone the repo, changes will not be taken as it will
still pull from the main repo's files. In order to use your local
version, add the following to
go.mod in the base
replace github.com/OpenDiablo2/OpenDiablo2 => /your/forked/import/path
This will tell go to use your local path instead of the official repo. Be sure to exclude this change from your pull requests!
If you find something you'd like to fix thats obviously broken, create a branch, commit your code, and submit a pull request. If it's a new or missing feature you'd like to see, add an issue, and be descriptive!
If you'd like to help out and are not quite sure how, you can look through any open issues and tasks, or ask for tasks on our discord server.
VS Code Extensions
The following extensions are recommended for working with this project:
When you open the workspace for the first time, Visual Studio Code will automatically suggest these extensions for installation.
Alternatively you can get to it by going to settings
Extensions and selecting
Go configuration, then clicking on
settings.json. Just paste that section where
The engine is configured via the
By default, the configuration assumes that you have installed
Diablo 2 and the expansion via the official Blizzard Diablo2
installers using the default file paths. If you are not on Windows,
or have installed the game in a different location, the base path
may have to be adjusted.
There is an in-progress project roadmap, which will be updated over time with new requirements.