Skip to content
dgengin edited this page Mar 10, 2018 · 32 revisions

Welcome to the DGEngine wiki!

DGEngine is an implementation of the Diablo 1 game engine. It uses JSON files as configuration files.

You need the original Diablo game files either as an MPQ, zip or folder in order to run the engine. MPQ support was added to this project.

You can create a zip with the original DIABDAT.MPQ using this tool: http://zezula.net/en/mpq/download.html

You run the engine by passing as an argument the path of the archive/folder with the gamefiles.

To run Diablo, you need the following:

  • DGEngine
  • DIABDAT.MPQ
  • gamefilesd

Run the game like this:

DGEngine gamefilesd

To run Hellfire, you need the following:

  • DGEngine
  • DIABDAT.MPQ
  • gamefilesd
  • gamefileshf
  • hellfire.mpq
  • hfmonk.mpq
  • hfmusic.mpq
  • hfvoice.mpq

Run the game like this:

DGEngine gamefileshf

Flare

flare

As of v2.0.1, DGEngine can run using Flare gamefiles.

To run with Flare, you need the following (flare/mods):

  • fantasycore

Run the game like this:

DGEngine gamefilesflare

Flare gamefiles are provided to test the engine and help make it more generic.

Play using Diablo Battle.net Beta - ISO File

You can download a beta version of Diablo and use the provided DIABDAT.MPQ.
Get it from here.

Note: The provided Hellfire gamefiles require the original game's DIABDAT.MPQ.

Extract the files inside DIABDAT.MPQ using this tool:
http://zezula.net/en/mpq/download.html
Note: you can get this tool from the first link as well.
If you need the games list files to extract from the MPQ, go to the first link and download them from there.

Compress those files into a .ZIP archive, or leave the extracted folder DIABDAT next to the DGEngine and main.json files.

The files in the beta are not the same as in the original, so some things don't show (scrollbars on hero selection, etc), but you can use these to load the town level and see what's the engine's progress.

Configuration files

You can see more information about configuration files here.

Current Status

The engine with the gamefiles provided mimics all of the original game's menus (pixel perfectly) and allows you to load levels (click on the town passages). Most of the effort has been put into getting all the required primitives done to mimic the original's UI. What's missing is basically all inside the game itself (items, players, spells, etc). Everything else (apart from multi player) is done. You can even set the music volume when the game is playing and the music will stop/restart if the volume reaches 0, just like the original (and it will persist that information).

DGEngine Running Diablo

Right now, the engine runs on Android, Linux and Windows.

Other projects used in DGEngine:

  • PhysicsFS
  • RapidJSON
  • sfeMovie
  • SFML
  • StormLib

Vision

The project's vision is to become an RPG game engine, that just happens to be able to run Diablo, given the appropriate game files. This means that nothing can be hard coded in the game.

Contributing

See how to contribute here.

Clone this wiki locally