slashdiablo-maphack

A customized maphack for reddit's slashdiablo D2 server

This maphack is based on BH maphack, written by McGod from the blizzhackers forum. It was extensively customized for the slashdiablo realm by Deadlock39, who created versions 0.1.1 and 0.1.2.

Currently works with client version 1.13C.

Major features include:

• Full maphack
  • Monsters, missiles displayed on map
  • Infinite light radius
  • Configurable monster colors (see wiki for details)
  • Indicators of current level's exits
• Configurable item display features (see wiki for details)
  • Modify item names and add sockets, item levels, ethereality
  • Change colors and display items on the map
• One-click item movement
  • Shift-rightclick moves between stash/open cube and inventory
  • Ctrl-rightclick moves from stash/open cube/inventory to ground
  • Ctrl-shift-rightclick moves from stash/inventory into closed cube
• Auto-party (default hotkey: 9)
• Auto-loot (default hotkey: 7)
• Use potions directly from inventory (default hotkeys: numpad * and -)
• Display gear of other players (default hotkey: 0)
• Screen showing secondary attributes such as IAS/FHR (default hotkey: 8)
• Warnings when buffs expire (see "Skill Warning" in config file)
• Stash Export
  • Export the inventory & stash of the current character to an external file
• Experience Meter
  • Show the current %, % gained, and exp/sec above the stamina bar
• Reload configs in-game with ctrl+r or numpad 0 (numpad 0 is configurable)

Imports from LoliSquad's branch:

• Cow King and his pack now has a separate color on the minimap
• If your game name consists of word+number, it will guess your next game name to be +1 (x123 -> x124)
  • Autofill Next Game: True, defaults to true
• Remembers your last game's password
  • Autofill Last Password: True, defaults to true
• You can inspect Valkeries, Shadow Masters and Iron Golems to see what they spawned with or was made of
• Improved in-game color palette (16x16, removed an excess color square that didn't exist)

The hotkeys for all features can be changed in the config file.

Example config can be found here:

Stash Exporting is configured through Mustache Templates, see sample below:

Add this to the bottom of your BH.cfg:

// Stash Export
// Mustache Templates
Mustache Default:	stash
Mustache[stats]: {{#defense}}\n\n    >{{defense}} defense{{/defense}}{{#stats}}\n\n    > {{value}}{{#range}} ({{min}}-{{max}}){{/range}} {{^skill}}{{name}}{{/skill}}{{skill}}{{/stats}}
Mustache[header-unique]: {{#quality=Unique}}**{{^name}}{{type}}{{/name}}{{name}}** (L{{iLevel}}){{#sockets}}[{{sockets}}]{{/sockets}}{{/quality}}
Mustache[header-magic]: {{#quality$Magic|Rare}}**{{^name}}{{type}}{{/name}}{{name}}** (L{{iLevel}}){{#sockets}}[{{sockets}}]{{/sockets}}{{/quality}}
Mustache[header-else]: {{#quality^Unique|Magic|Rare}}{{^isRuneword}}{{^name}}{{type}}{{/name}}{{name}}{{/isRuneword}}{{#isRuneword}}**{{runeword}}** {{type}}{{/isRuneword}} (L{{iLevel}}){{#sockets}}[{{sockets}}]{{/sockets}}{{/quality}}
Mustache[header]: {{>header-unique}}{{>header-magic}}{{>header-else}}{{#count}} **x{{count}}**{{/count}}
Mustache[item]: {{>header}}{{>stats}}{{^isRuneword}}{{#socketed}}\n\n  * {{>>item}}{{/socketed}}{{/isRuneword}}\n
Mustache[stash]: {{#this}}* {{>item}}\n\n{{/this}}

Release Notes for JimmyTheJ's 1.8.12 changes

• Added several keywords to ItemDisplay
  • MAXDUR for enhanced durability percent
  • FRES for fire resistance
  • CRES for cold resistance
  • LRES for lightning resistance
  • PRES for poison resistance
  • Stats can now be combined in a limited pool by adding a + between them:
    • STR, DEX, LIFE, MANA, FRES, LRES, CRES, PRES
    • EX: STR+DEX+FRES>40
  • FOOLS for Fool's mod. Used without any operators or numbers
  • GOODSK for + skills of any of the user defined good classes
  • GOODTBSK for + skills tab of any of the user defined good tab skills
  • Configuration file has two new lines:
    • Skills: True, None
    • ClassSkills: True, None
    • This is followed by a line for each Class skill and Tab skill like so:
      • SkillsList[6]: False // Assassin
      • ClassSkillsList[2]: True // Amazon Javelin
      • ClassSkillsList[8]: True // Sorceress Fire
    • The numbers in braces corresponds to the internal code for the skill so it is important

Release Notes for BH Maphack v1.8

• Stash export improvements:
  • Add account name to stash export file name
  • Add rare and crafted item names to stash export
• Map boxes are drawn on top of other things
• Add four possible box sizes to draw on the map
  • Big to small: border, map, dot, px
  • example config line:
    • ItemDisplay[tsc]: %green%+ %white%TP%map-97%%line-20%%border-20%%dot-0a%%px-33%
      • the new format is border-xx where the xx is the color code
      • things like %red%%map% will still work and won't override a border that is set
  • 
  • 
• Support multiple ItemDisplay lines with the same key
• Draw all of an item's map config lines, not just the first
• Add some fancy ItemDisplay magic (see example configs)
• Add ability to reload BH config (default key: numpad 0; hard coded: control r)
• Add ability to draw lines to or hide monsters on map
  • Monster Hide[149]: // chicken
  • Monster Line[479]: 0x9B // shenk
• Add DARK_GREEN as a color
• Other color; add Other Extra
  • This enables places like Black Marsh to have lines to The Hole and The Forgotten Tower
  • Add support for various possible paths at the start of act 3
  • Other Extra is for supporting an extra exit on a level (e.g. Hole Level 1 exit from Black Marsh).
• Remove need for Visual Studio Redistributable
• ItemDisplay conditions can now use && for AND and || for OR
• %replacement_strings% don't need to be in caps
• Fixed toggle key for xp meter (default: numpad 7)
• Updated stats page
  • Custom stats can be added like: Stat Screen[red_cooldown]: // reduced cooldown
• Can be loaded on Diablo start

Release Notes for BH Maphack v1.7a

• A fork of Underbent's v1.6 by Slayergod13

Updates to Underbent's v1.6 changes:

• BH.Injector
  • Refactored the injection process so that it no longer executes the core maphack logic inside of the loader lock.
    • This resulted in a minor frame rate increase
    • More importantly it allowed the BH.dll to load the Stormlib.dll for the purpose of reading the MPQ files
  • No longer needs to load Stormlib.dll
  • No longer writes out temporary mpq text files
  • Fixed a bug where opening the injector without any windows open would cause the injector to crash
• BH.dll
  • Now loads the MPQ data inside the maphack
• Item Module
  • Now relies on the data read from the MPQ files within the maphack dll

New Features & Bug Fixes:

BH Config

• Can now read lines of arbitrary length
• Fixed a bug where lines with a single '/' would be truncated instead of waiting for a double slash "//"

StashExport

• New Module Capable of exporting the current characters inventory in JSON or custom formats using mustache templates
• Uses the MPQ data to figure out the item information
• Templates can be specified in the BH.cfg using mustache syntax: https://mustache.github.io/mustache.5.html
  • Subset of mustache implemented (and some additions):
    • Literals
      • Support for SOME escape characters added (\r\n\t)
    • Variables
    • Partials
      • Added ability to isolate the child scope to prevent infinite recursion in partials (the context would no longer have access to its parent context)
      • {{>partial}} {{>>isolated-partial}}
    • Sections
      • Inverse
      • Conditional (for truthy values)
      • Iterator (for arrays)
      • And some new additions:
        • Comparisons:
          • String Equality: {{#key=value}}
          • String Inequality: {{#key!value}}
          • Float Greater: {{#key>value}}
          • Float Less: {{#key<value}}
          • String In Set: {{#key$value1|value2|value3}}
          • String Not In Set: {{#key^value1|value2|value3}}
• Added several data structures to support the StashExport module
  • JSONObject - Used to contain the item data in a generic fashion, also makes the templating MUCH easier
  • TableReader/Table - Used to read the txt/tbl files in the data directory, these files are used for parsing the item stats
  • MustacheTempalte - Used for templating text

Features

• Can identify item quality
• Can identify which unique/set/runeword the item is
• Can identify the magix prefix/suffixes
• Attempts to collapse known aggregate stats (all res) using the aggregate name
• Will collapse identical items into a single entry with a count (useful for runes and gems)
• Can exclude stats on items that are fixed so that only the important stats are shown
• Can get stats for jewels that have been placed into a socketed item
• See sample output further down

D2Structs

• Adjusted some structures to better state the purpose of some previously "unknown" or unspecified bytes

ScreenInfo

• Added display for current/added/rate of gain for experience
  • BH Toggle: "Experience Meter"

Maphack

• Refactored the rendering pipeline for the automap objects (monsters, items, missiles, etc) so that the frames could be recycled.
  • This allows the system to reuse calculations from previous frames and only store the draw commands.
  • This can result in a large frame rate increase on slower machines
• Added ability to display chests on the automap

ItemDisplay

• The predicate parser will no longer use exceptions for control flow.
  • The old design was resulting in a large frame rate penalty that has been aleviated

New Configuration Items & Defaults:

// Maphack section:
// Toggles whether or not to show chests on the automap
Show Chests:			True, VK_X
// Controls how many frames to recycle the minimap doodads for (higher values save more frames)
Minimap Max Ghost: 20

// Experience Display
Experience Meter:		True, VK_NUMPAD7

// Stash Export
// Mustache Templates
Mustache Default:	stash
Mustache[stats]: {{#defense}}\n\n    >{{defense}} defense{{/defense}}{{#stats}}\n\n    > {{value}}{{#range}} ({{min}}-{{max}}){{/range}} {{^skill}}{{name}}{{/skill}}{{skill}}{{/stats}}
Mustache[header-unique]: {{#quality=Unique}}**{{^name}}{{type}}{{/name}}{{name}}** (L{{iLevel}}){{#sockets}}[{{sockets}}]{{/sockets}}{{/quality}}
Mustache[header-magic]: {{#quality$Magic|Rare}}**{{^name}}{{type}}{{/name}}{{name}}** (L{{iLevel}}){{#sockets}}[{{sockets}}]{{/sockets}}{{/quality}}
Mustache[header-else]: {{#quality^Unique|Magic|Rare}}{{^isRuneword}}{{^name}}{{type}}{{/name}}{{name}}{{/isRuneword}}{{#isRuneword}}**{{runeword}}** {{type}}{{/isRuneword}} (L{{iLevel}}){{#sockets}}[{{sockets}}]{{/sockets}}{{/quality}}
Mustache[header]: {{>header-unique}}{{>header-magic}}{{>header-else}}{{#count}} **x{{count}}**{{/count}}
Mustache[item]: {{>header}}{{>stats}}{{^isRuneword}}{{#socketed}}\n\n  * {{>>item}}{{/socketed}}{{/isRuneword}}\n
Mustache[stash]: {{#this}}* {{>item}}\n\n{{/this}}

Stash Export Sample:

Raw JSON:

[
  {
    "iLevel": 4,
    "name": "Viridian Small Charm of Life",
    "quality": "Magic",
    "stats": [
      {
        "name": "maxhp",
        "value": 10
      },
      {
        "name": "poisonresist",
        "value": 7
      }
    ],
    "type": "Small Charm"
  },{
    "defense": 98,
    "iLevel": 17,
    "quality": "Rare",
    "socketed": [
      {
        "iLevel": 1,
        "isGem": true,
        "quality": "Normal",
        "type": "Ruby"
      },
      {
        "iLevel": 1,
        "isGem": true,
        "quality": "Normal",
        "type": "Sapphire"
      }
    ],
    "sockets": 2,
    "stats": [
      {
        "name": "item_armor_percent",
        "value": 29
      },
      {
        "name": "tohit",
        "value": 15
      },
      {
        "name": "normal_damage_reduction",
        "value": 1
      },
      {
        "name": "fireresist",
        "value": 10
      },
      {
        "name": "item_lightradius",
        "value": 1
      },
      {
        "name": "item_fastergethitrate",
        "value": 17
      }
    ],
    "type": "Chain Mail"
  },{
    "iLevel": 99,
    "name": "Annihilus",
    "quality": "Unique",
    "stats": [
      {
        "name": "all-stats",
        "range": {
          "max": 20,
          "min": 10
        },
        "value": 14
      },
      {
        "name": "res-all",
        "range": {
          "max": 20,
          "min": 10
        },
        "value": 16
      },
      {
        "name": "additional xp gain",
        "range": {
          "max": 10,
          "min": 5
        },
        "value": 6
      }
    ],
    "type": "Small Charm"
  },{
    "iLevel": 87,
    "name": "Wizardspike",
    "quality": "Unique",
    "type": "Bone Knife"
  },
  {
    "defense": 168,
    "iLevel": 80,
    "isRuneword": true,
    "quality": "Normal",
    "runeword": "Spirit",
    "socketed": [
      {
        "iLevel": 1,
        "isRune": true,
        "quality": "Normal",
        "type": "Tal Rune"
      },
      {
        "iLevel": 1,
        "isRune": true,
        "quality": "Normal",
        "type": "Thul Rune"
      },
      {
        "iLevel": 1,
        "isRune": true,
        "quality": "Normal",
        "type": "Ort Rune"
      },
      {
        "iLevel": 1,
        "isRune": true,
        "quality": "Normal",
        "type": "Amn Rune"
      }
    ],
    "sockets": 4,
    "stats": [
      {
        "name": "mana",
        "range": {
          "max": 112,
          "min": 89
        },
        "value": 100
      },
      {
        "name": "cast3",
        "range": {
          "max": 35,
          "min": 25
        },
        "value": 25
      },
      {
        "name": "abs-mag",
        "range": {
          "max": 8,
          "min": 3
        },
        "value": 7
      }
    ],
    "type": "Kurast Shield"
  },{
    "count": 8,
    "iLevel": 1,
    "isGem": true,
    "quality": "Normal",
    "type": "Chipped Ruby"
  },
  {
    "count": 7,
    "iLevel": 1,
    "isGem": true,
    "quality": "Normal",
    "type": "Flawed Emerald"
  }
 ]

Using the template above:

* **Viridian Small Charm of Life** (L4)

    > 10 maxhp

    > 7 poisonresist

* **Chain Mail** (L17)[2]

    >98 defense

    > 29 item_armor_percent

    > 15 tohit

    > 1 normal_damage_reduction

    > 10 fireresist

    > 1 item_lightradius

    > 17 item_fastergethitrate

  * Ruby (L1)


  * Sapphire (L1)
  

* **Annihilus** (L99)

    > 14 (10-20) all-stats

    > 16 (10-20) res-all

    > 6 (5-10) additional xp gain
    

* **Wizardspike** (L87)


* **Spirit** Kurast Shield (L80)[4]

    >168 defense

    > 100 (89-112) mana

    > 25 (25-35) cast3

    > 7 (3-8) abs-mag
    
    
* Chipped Ruby (L1) **x8**

* Flawed Emerald (L1) **x7**

Which renders as:

• Viridian Small Charm of Life (L4)

  10 maxhp

  7 poisonresist

• Chain Mail (L17)[2]

  98 defense

  29 item_armor_percent

  15 tohit

  1 normal_damage_reduction

  10 fireresist

  1 item_lightradius

  17 item_fastergethitrate

  • Ruby (L1)
  • Sapphire (L1)

• Annihilus (L99)

  14 (10-20) all-stats

  16 (10-20) res-all

  6 (5-10) additional xp gain

• Wizardspike (L87)

• Spirit Kurast Shield (L80)[4]

  168 defense

  100 (89-112) mana

  25 (25-35) cast3

  7 (3-8) abs-mag

• Chipped Ruby (L1) x8

• Flawed Emerald (L1) x7