How to edit the config

How to navigate through the configuration file (BH.cfg)

by KevinVickers

The SlashDiablo MH configuration file is BH.cfg. This file can be opened and edited in any text editor such as Notepad, Sublime, etc.

It is possible that Windows does not associate .cfg files to Notepad or your favoritate text editor. If you are unable to open the file by double-clicking on it, right-click the BH.cfg file and use "Open with..." and select your text editor.

Find the lists of items in the tier system

Using the Find function in your text editor (CTRL+F) you will be able to quickly jump to where you need to go.

To access the Uniques and Sets category, search for 'Uniques and Sets':

To access the Socktables section, search for 'Socktables'. To access the Shopping section, search for 'Shopping'.

How to change an item to a different tier

You may want to change an item to a different tier for various reasons. In the example below, I will move The Oculus from Tier 4 to Tier 3. This could be due to the fact that I no longer need any other Tier 4 items and would like to filter those out.

Since I still need an Oculus, I will move it to Tier 3 and turn off notifications for Tier 4. Before we start with the step-by-step instructions let's take a look at what makes an item belong in a specific Tier:

On the screenshot above, two items are highlighted:

• Mang Song's Lesson (Tier 3)
• The Oculus (Tier 4)

The Mang Song's Lesson is identified as a Tier 3 item by the following attributes:

• %RED%: Gives it a red color
• T4: T4 adds the mention T4 to the item name
• %TIER-3%: The Tier group in which it belongs, this is used to define Tiers for use with the in-game "ping level" setting.

Therefore, if we would like to move The Oculus from Tier 4 to Tier 3, we would need to make the following changes:

Before:

// The Oculus
ItemDisplay[UNI oba]: %GOLD%T4%MAP% %NAME%%TIER-4%

After:

// The Oculus
ItemDisplay[UNI oba]: %RED%T3%MAP% %NAME%%TIER-3%

Additionally, to keep your configuration file organized, we recommend you move the entire line from the Tier 4 to the Tier 3 category in the configuration file as such:

You would now be able to reload the configuration in-game by using CTLR+R or the changes will only take effect once you re-open your game.

How to modify the item filter

You can navigate to the Item Filter section of the configuration file by searching for 'Item Filter'.

First, please take note that any lines that begin with // are what we refer to as commented lines, these are ignored by maphack.

You may visit this section to modify what is completely hidden in-game by maphack. In order to be completely hidden, items must meet specific criteria:

• The line in the Item Filter section is NOT commented (does not start with //)
• The in-game 'filter level' is set to a high enough value. The default item filter lines check FILTLVL to determine if the line should be active or not.
• There is no explicit whitelisting of the item in the config. As of BH 1.9.9, whitelist rules take priority over blocking rules. A whitelist rule is one that assigns at minimum a name to the item, for example, ItemDisplay[cap]: %NAME% would whitelist caps.

For example, by default the piles of gold under 3000 are hidden to players who have the filter level set to more than 0 (at least 'minimum'). If you wish to always see all gold piles, simply add // in front of this line. This will turn it into a comment and will be ignored by maphack.

If you wish to hide piles of gold under 5000, simply change the 3000 in the default configuration to 5000.

 ItemDisplay[FILTLVL>1 NMAG !RW axe]: // Axe
 //ItemDisplay[FILTLVL>1 NMAG !RW 2ax]: // Double Axe

The snippet above shows an Axe and a Double Axe. The Axe will be hidden once the character you are playing sets the filter level to more than 1 (at least moderate). The Double Axe will not be hidden since the line is commented with //.