Skip to content

MrGreenPro94/d2r-mapview

 
 

Repository files navigation

Diablo 2: Resurrected map viewer

Noob friendly FREE map reveal tool for Diablo 2 Resurrected.
Use at your own risk, there is no warranty or responsibility taken for being penalised for using this.

This map hack is as simple as running an executable. It relies on a backend server that is offered for free but runs on donations.
The backend does not use d2mapapi, but instead uses a modified version of this project blacha/diablo2.

This tool is licenced under GPLv3.

Join the discord server https://discord.gg/qEgqyVW3uj

Durance of Hate Level 2

Demonstration

https://www.youtube.com/watch?v=-tezpjrZwEI

Map examples

Arcane Sanctuary Lower Kurast Canyon of the Magi

Installation

Executable

  1. Download the latest d2rmap-vx.x.x.exe and settings.ini files (found on the releases page)
  2. Launch D2R.
  3. Run d2rmap.exe while in menus or in game.
  4. You show see a 'Loading map data' message on the top left of the screen, this initial loading may take 10-15 seconds.
  5. Make sure you press TAB to show the minimap, this map will only display when your minmap is displayed.
  6. Press Ctrl+H in game for a help menu

The executable does not require administrator privileges unless you are running the game as administrator

Virustotal gave me an alert

The compiled executable will get false positives in virus scans. This is because the tool is written in Autohotkey. Autohotkey, while a powerful tool, has been used for all sorts of nefarious applications in the past.
If you look on the Autohotkey forums, you'll see this is a widely reported problem.

However, you can alternatively download and install https://www.autohotkey.com/
Then you can run src/d2r-map.ahk directly from source. This way you can be fully aware of what code you're executing and you don't have to trust an opaque executable.

Do not accept executables for this from any other source!

Please note that running this map utility this way uses my freely hosted map server. This server is getting hammered lately so it would be appreciated if you supported this project.

Bitcoin donation: 18hSn32hChp1CmBYnRdQFyzkz5drpijRa2
D2JSP forum gold: https://forums.d2jsp.org/user.php?i=1294529

Features

  • The map will show positions of:
    • Players
    • Monsters as a white dot
    • Unique/champion/superunique monsters as a larger gold dot
    • Monster immunities
    • Unique items on ground (flashing alert)
    • Set items on ground (flashing alert)
    • High runes on ground (Lem and above) (flashing alert)
    • Super chests marked (Lower Kurast chests)
    • Shrines and their type
    • Portals
    • All doors, waypoints marked
    • A purple line drawn to the next level exit
    • A yellow line drawn to the waypoint
    • A red line drawn to the nearest boss (Nihlithak, summoner etc)
    • All quest items, marked in green (Stones, Hellforge, Altars etc)
  • Highly configurable, size, color, position, opacity etc
  • Can change map size and position with key shortcuts while in game
  • Shows last game name and game time while in menu Last Game Name

If you want D2R server IP to show, look at my extra standalone tool for that https://github.com/joffreybesos/DcloneIPview

Other notes

  • Press Ctrl+H to see help in game, including a map legend
  • You can exit the maphack with Shift+F10
  • You can also right click the icon in the system tray.
  • This MH will automatically exit when you exit D2R.
  • Map download might be slow, just give it a second.
  • Please ignore the message at the top, it's to alert anyone who may have been scammed.

Discord

Join the discord server https://discord.gg/qEgqyVW3uj

Please report any scams or attempts to resell this maphack on discord.

Donations

Please consider donating either some BTC or D2JSP to support this project.

Bitcoin donation 18hSn32hChp1CmBYnRdQFyzkz5drpijRa2
D2JSP forum gold: https://forums.d2jsp.org/user.php?i=1294529

Configure

In settings.ini you should see some options to make configuration changes.

Setting Default Description
baseUrl http://localhost:3002 URL of the map server, set to public server by default, but you can use localhost if you run your own server
scale 1 The global scale setting applied to all map images, press NumpadPlus and NumpadSubtract to adjust in game
leftMargin 20 The left margin of all map images, set this to wider than your primary monitor to push it onto your secondary monitor.
topMargin 20 Top margin of map image
opacity 0.6 How transparent the map image should be, between 0 and 1
alwaysShowMap false This setting will force the map to always show, ignoring the TAB key
hideTown false This will hide town maps so they will never show
edges true This makes map images appear as walls instead of walkable area
wallThickness 1.2 Thickness of walls in when edges is turned on
showGameInfo true Shows previous game name and game time in menus
showNormalMobs true Set to false to hide normal non-unique monsters on the map
showUniqueMobs true Set to false to hide unique monsters on the map
showBosses true Show bosses with a red dot, such as Diablo, Summoner etc
showDeadMobs true Show dead mobs as a black square (useful to know which areas are clear)
showImmunities true Show immunties of normal and unique monsters
showOtherPlayers true Show other players as squares
showItems true Show items on ground (unique, set, runes)
showShrines true Show shrines
showPortals true Show portals including red portals
normalMobColor FFFFF Colour of the dot of normal monsters
uniqueMobColor D4AF37 Colour of the dot of unique monsters
bossColor FF0000 Colour of boss dots on the map
deadColor 000000 Color of dead mobs on the map
physicalImmuneColor CD853f How physical immunity will display
magicImmuneColor ff8800 How magic immunity will display
fireImmuneColor FF0000 How fire immunity will display
lightImmuneColor FFFF00 How lightning immunity will display
coldImmuneColor 0000FF How coldimmunity will display
poisonImmuneColor 32CD32 How poison immunity will display
runeItemColor FFa700 Rune alert colour when a rune is on the ground
uniqueItemColor BBA45B Unique alert color when a unique is on the ground
setItemColor 00FC00 Set item alert colour when a set item is on the ground
portalColor 00AAFF Town portal color
redPortalColor FF0000 Red portal color (cow level)
shrineColor FFD700 Shrine and shrine type text colour
shrineTextSize 14 Shrine text size
showWaypointLine false Draws a yellow line to the nearest waypoint, turned off by default
showNextExitLine true Draws a purple line to the next relevant exit
showBossLine true Draws a red line to the boss in that level (Nihlithak, Summoner etc)
increaseMapSizeKey NumpadAdd Key to increase the size of the map
decreaseMapSizeKey NumpadSub Key to decrease the size of the map
alwaysShowKey NumpadMult Key to toggle alwaysShowMap setting
moveMapLeft #Left Shortcut to move map left (Win + left)
moveMapRight #Right Shortcut to move map right (Win + Right)
moveMapUp #Up Shortcut to move map up (Win + Up)
moveMapDown #Down Shortcut to move map down (Win + Down)
performanceMode 0 Experimental, set to -1 to max out performance. This may use too much CPU and cause strange behaviour. Please report any issues in Discord as I wish to make this permanent
enableD2ML false Only enable if you use multiple D2R sessions, not tested well
windowTitle D2R:main This is ignored unless enableD2ML is turned on. It is the window title of one D2R session for multi sesion
debug false Turn this one to increase the level of the logging, note this will create huge log.txt files

Map Server

Use the hosted free map server

I offer a free to use map server on the internet.
If you use this server please consider donating to help with server costs.

Bitcoin donation 18hSn32hChp1CmBYnRdQFyzkz5drpijRa2
D2JSP forum gold: https://forums.d2jsp.org/user.php?i=1294529

This free server comes preconfigured, simply use the default configuration in settings.ini

Run your own map server

Alternatively you can host your own map server which I've also shared for free.
Please refer to SERVER.md for a full guide.

Is it safe?

No one can say for sure. Blizzard do have Warden anti-cheat that will scan your computer for running processes and compare them against a blacklist. I accept no responsibility for any outcomes or usage of this tool. Use at your own risk!

Troubleshooting

  • A log file log.txt is generated in the same folder as the executable.
  • You can also set debug logging to true in settings.ini for verbose logging.
  • Go to the discord server if you need further help https://discord.gg/qEgqyVW3uj
  • Tested and working on Diablo 2 Resurrected 1.0.67358

Warning: The keyboard and/or mouse hook could not be activated; some parts of the script will not function: This happens with certain antivirus where it will block hotkeys, you may need to 'allow' the script for hotkeys to work.

If you are having trouble with the map server, refer to troubleshooting steps at SERVER.md

Licence

This repo is licenced under GPLv3

  1. Anyone can copy, modify and distribute this software.
  2. You have to include the license and copyright notice with each and every distribution.
  3. You can use this software privately.
  4. You can use this software for commercial purposes.
  5. Any modifications of this code base MUST be distributed with the same license, GPLv3.
  6. This software is provided without warranty.
  7. The software author or license can not be held liable for any damages inflicted by the software.

Violations of the licence may make you liable for DMCA takedowns.

TODO

  • Map replaces automap (centered in screen and follows player)

If you have ideas for more features, feel free to share them on discord

About

Diablo 2 Map reveal screen overlay

Resources

License

Stars

Watchers

Forks

Packages

No packages published

Languages

  • AutoHotkey 99.9%
  • Batchfile 0.1%