Getting Started with PD2 Filters

Everything you need to know to install, use, and customize item filters

What Are Item Filters?

Item filters are text files that control how items appear on the ground in Project Diablo 2. They can:

  • Show or hide items based on conditions (type, quality, stats, etc.)
  • Change colors of item names to make important drops stand out
  • Add map icons so you can spot drops on the minimap
  • Play sounds when valuable items drop
  • Add descriptions with extra info like item level or vendor price
Filter files use the .filter extension and are plain text — you can edit them with any text editor like Notepad, VS Code, or Notepad++.

Installing a Filter

The easiest way to use a filter is through the PD2 Launcher:

  1. Open the PD2 Launcher
  2. Click Item Filter Profiles
  3. Browse the available filters and select one
  4. The launcher downloads and activates it automatically

You can browse all available community filters on our Filters page.

To install a filter manually, place the .filter file in
Diablo II\ProjectD2\filters\local\
Then select it from the "Local" section in the launcher.

Using Filters In-Game

Once a filter is installed:

  1. Open PD2 Options in-game (not regular D2 options)
  2. Enable Loot Filter
  3. Choose a Filter Level (strictness) — most filters offer multiple levels
  4. Press Numpad 0 to reload the filter after making changes
Filter Level 0 always means "Show All Items" — it's built in and always available regardless of the filter. Levels 1–12 are defined by the filter author.

How Filters Work

Every filter rule follows this pattern:

ItemDisplay[conditions]: output
  • Conditions (inside []) — what items this rule matches
  • Output (after :) — how to display matching items

Key rules:

  • Rules are checked top to bottom — the first match wins
  • An empty output hides the item: ItemDisplay[key]:
  • %NAME% shows the item's default name
  • Lines starting with // are comments (ignored)

Simple Examples

// Hide keys
ItemDisplay[key]:

// Hide gold under 100
ItemDisplay[GOLD<100]:

// Show all unique items with purple text and a map icon
ItemDisplay[UNI]: %PURPLE%%NAME%%MAP%

// Show all items normally (catch-all, goes last)
ItemDisplay[]: %NAME%

Making Your First Edit

Let's say you want to customize an existing filter. Here's how:

  1. Find your filter file in Diablo II\ProjectD2\filters\local\
  2. Open it with a text editor (Notepad++ or VS Code recommended)
  3. Find the rule you want to change, or add a new rule near the top (higher = higher priority)
  4. Save the file
  5. Press Numpad 0 in-game to reload
Tip: Always keep a backup of the original filter before editing. If something breaks, you can restore it.

Common Edits

// Make Shakos stand out with red text and a border icon
ItemDisplay[uap]: %RED%SHAKO!%BORDER%

// Show socket count on normal items
ItemDisplay[NMAG SOCKETS>0]: %NAME% [%SOCKETS%]

// Hide normal items below level 30
ItemDisplay[NMAG !SUP CLVL>30]:

// Highlight runes above Lem (#20) with gold + sound
ItemDisplay[RUNE>19]: %GOLD%%RUNENAME% Rune%MAP%%SOUNDID-4718%

%RUNENAME% displays the rune's name (e.g. "Ber"), %MAP% adds a minimap icon, and %SOUNDID-4718% plays a drop sound.

Next Steps

Remember: You can always set Filter Level to 0 in-game to show all items, even if your filter has a bug. Numpad 0 reloads the filter instantly — no need to restart the game.