Filter Info

In-Game Settings
The Settings menu can be accessed in-game from the lower left corner. Hotkeys can be set for each option.

These options enable simple rules for changing how certain items are displayed. Except for the tooltip changes made by Show iLvl, they'll be overwritten if Advanced Item Display is checked.


 * Show Ethereal: adds (Eth)
 * Show Sockets: adds sockets such as (4)
 * Show iLvl: adds item levels such as (L99)
 * adds ILVL to tooltips for all items
 * adds ALVL to tooltips for magic/rare/crafted items unless ALVL = ILVL
 * Show Rune #: adds rune numbers such as [33]
 * Alt Style: uses different style for Ethereal, iLvl, and Rune # options
 * Color Mod: rune numbers are colored (1-10 white, 11-16 tan, 17-22 orange, 23-33 red)
 * Shorten Names: shortens potion/scroll names

These two options are not affected by lootfilters.


 * Always Show Items: shows items on the ground without needing to hold alt
 * Always Show Item Stat Ranges: shows ranges in item tooltips for variable attributes

These are the main options that affect custom filtering.


 * Advanced Item Display: enables the filter
 * Item Drop Notifications: shows notifications when specified items drop
 * Item Close Notifications: shows notifications when getting close to specified items
 * Item Detailed Notifications: makes notifications match the displayed item name
 * Verbose Notifications: adds "drop" or "close" to the notification (overridden by Item Detailed Notifications)

The default hotkey to reload the filter file is Numpad 0 and can be changed in the configuration file.

Installation
Filters can be selected from the launcher and enabled via the in-game Settings menu.

To install manually, download a filter file and save it to Diablo II\ProjectD2\local and then select it from the launcher. Make sure the relevant in-game settings are enabled.

List of Public Filters
Filters updated for the current season are highlighted green. Older filters are highlighted red.

Some tools are available on the Guides and Links page that may be useful when editing filters.
 * FilterBird (filter simulation)
 * Item Filter Highlighting (syntax highlighting for Notepad++)
 * Loot Filter Hints (syntax highlighting for Visual Studio Code)

FAQ
This section lists common issues and frequently asked questions about filters.


 * 1) Which is the best filter for me?
 * 2) * There isn't a "best" filter. Different filters are made for different reasons, and vary in terms of how strict they are with the items they show or notify, how much and what kind of extra information they provide, and how they alter the appearance of items. It's difficult to make recommendations without knowing what you're looking for in a filter and people may not be familiar with more than a few filters, so comparing filters yourself may be the best way to find a filter that suits you.
 * 3) What's the best way to compare different filters?
 * 4) * Filters usually include descriptions about how strict they are, what features they have, and how items are displayed. Some even include example images. If that isn't enough, FilterBird can be used to compare most items between filters one-at-a-time, and singleplayer can be used with an item pack and local filter so that the filter can be altered and reloaded in-game to compare any number of items.
 * 5) If I want to use a customized filter, how do I save my changes?
 * 6) * Put the customized filter into ProjectD2\filters\local and select it from "Local" in the launcher. Local filters won't be updated automatically, so if yours is based on a public filter, you may want to follow that filter in case any important changes are made to it.
 * 7) How do I turn off the filter or go back to original?
 * 8) * The filter can be turned off by disabling Advanced Item Display in the in-game settings. To reset everything to default, close the game and launcher, delete the filters folder as well as default.filter and loot.filter in the ProjectD2 folder, and then relaunch the game.
 * 9) How do I use a filter with PlugY?
 * 10) * The same filter configuration you have for multiplayer will also be used for singleplayer. The filter configuration is updated when the game is opened from the launcher - select a filter from the launcher and press Play in order to update it. This also updates the filter itself if you're using a non-local version. Afterward, close the game/launcher and open the game with PlugY.
 * 11) Will a loot filter from older seasons work in the current season?
 * 12) * Unless the older filter was extremely simple, it will likely behave in unexpected and undesireable ways. Using an outdated filter is not recommended.
 * 13) My settings button is gone
 * 14) * Close the game & launcher, delete UI.ini, and then relaunch the game to return the settings button to its default position.
 * 15) My launcher shows no filters in the list
 * 16) * Close the launcher and re-open it. Repeat if they still don't show or if the server/GitHub is down. Also, try whitelisting the launcher and game in your antivirus and/or firewall.
 * 17) My launcher says "Coming Soon!" for item filters
 * 18) * You have an old version of the launcher. Download the new version from projectdiablo2.com after making backups of your your ddraw.ini and ProjectDiablo.cfg files. (they'll be overwritten with default settings)
 * 19) My filter isn't working
 * 20) * Make sure the in-game settings are setup correctly.
 * 21) * Use the launcher to select your filter. If you don't use the launcher, these may be common issues:
 * 22) ** Having two PD2 installations and pasting your filter into the wrong one
 * 23) ** Saving the filter file with the wrong name (e.g. default.filter.filter, default.txt, or default.filter.txt)
 * 24) ** Having a PD2 installation inside of a Diablo II folder which is inside another Diablo II folder (folderception!)
 * 25) ** Not saving and closing the filter file after pasting rules into it
 * 26) My filter is displaying strange characters for certain items
 * 27) * Certain special characters will only be displayed correctly if your filter file is encoded in ANSI rather than the default of UTF-8. Most text editors will allow the encoding to be modified - for example, Notepad++ includes "Encoding" as one of the primary menu options.