Skip to content
This repository has been archived by the owner on Dec 21, 2022. It is now read-only.

Setup guide

joffreybesos edited this page Sep 8, 2022 · 56 revisions

If you have paid for this maphack you have been scammed!

Quick start

I've created a zip file with all the files you need in one bundle - the MH, map server and D2 LoD files. https://mega.nz/file/R1M3VSyB#OOwlsO4Ne1HLo-bKQjKO2QP7pCxhH88RD0yE3TIOtP0 https://www.mediafire.com/file/a2c4cv4vp2fo82d/d2-mapserver-v19-full.zip/file (mirror)

Simply:

  1. Unzip to a folder on your PC, make sure the path does not have non-english characters
  2. Run serversetup.exe (only need to do once ever)
  3. Launch D2R
  4. Run d2r-map-v3.0.0.exe

If you are still having problems share your log.txt in the #help channel on discord. If you have an error with ServerSetup, sometimes the MH will work anyway, give it a try.

Running map server from source

If you have having problems with the map server, try this guide https://github.com/joffreybesos/d2r-mapview/wiki/Run-map-server-from-source-code

Setting up from scratch

This maphack has two programs - a map server (d2-mapserver.exe), and the map hack itself (d2r-map-v2.8.1.exe). You can host the mapserver on a different machine if you wish, but otherwise it's just a program that runs in the background.
The map server uses very little resources and you won't gain much performance by moving it onto another machine.

Only follow this process if the quick start guide above didn't work, and the run from source guide didn't work.

Setup map server (d2-mapserver.exe)

Only follow this process if the quick start guide above didn't work, and the run from source guide didn't work.

  • Download the d2-mapserver-vxxx.zip from https://github.com/joffreybesos/d2-mapserver/releases/latest

  • Extract the zip file to it's own folder.

  • Download the D2 LoD game files

  • Extract the zip file in your d2-mapserver folder, it should create a new folder called game
    Your files should look like this:
    gamefiles

  • Double click the setupserver.bat batch file (you should only have to run this once ever)

  • Click yes to allow for admin privileges

  • Double click the d2-mapserver.exe to launch the server.

If you get this prompt, just click 'Allow access'
firewall

You should see a window popup with the text Running on http://localhost:3002
image

If you see the above window then the map server is running.
To verify the mapserver is working, open this URL in your browser http://localhost:3002/v1/map/12345/2/117/image
If the above URL shows a map image, then your server is working correctly!

In the future, you don't need to run this map server manually, it will launch in the background when you laun However you can still launch d2-mapserver yourself if you wish.

Setup the map hack (d2r-map.exe)

  1. Download the latest version https://github.com/joffreybesos/d2r-mapview/releases/latest
  2. IMPORTANT: Save d2r-map.exe to the same folder as your d2-mapserver.exe**
  3. Launch D2 Resurrected
  4. Run the d2r-map-v2.x.x.exe executable
  5. Press Ctrl+O in game for options and Ctrl+H for help.

If your mapserver isn't running, then d2r-map should launch it for you.

Troubleshooting

Troubleshooting has moved to this page: https://github.com/joffreybesos/d2r-mapview/wiki/Troubleshooting