Read Me

• Numeric Stat Search
  Use a stat code, a comparison operator, and a value.
  Example search: req-str<=95
  Example result: items with required strength less-than-or-equal-to 95.
  
  • Notes
    • Stat codes can be found on the Stat Reference page.
    • You can also search with just a stat code, and it will default to greater-than-or-equal-to 1.
      Example search: abs-cold
      Example result: items with any amount of cold absorb.


• Non-numeric Stat Search
  For now, all stats are implemented with numeric values even if the values are not visible. So, just try searching with a simple value range, or just use the stat code on its own to default to greater-than-or-equal-to 1.
  Example search: eth>=1
  Example result: ethereal items.
  Example search: cold-sunder
  Example result: items that sunder monster cold immunity.
  


• Item slot
  Use slot:{value}
  Example search: slot:shield
  Example result: items that fill the shield slot
  Valid values: head, neck, chest, waist, finger, hands, feet, weapon, shield, inventory, socket, bonus


• Combined query
  Combine multiple filters by separating them with spaces.
  Example search: slot:shield req-str<=95 cast[skill:frost-nova&chance>=5]
  Example result: shields with required strength no more than 95 and have at least 5% chance to case frost nova.


• Chance to Cast Skill and Skill Charges Stat Search
  Use the stat code cast with a sub-query in brackets.
  Example search: cast[skill:frost-nova&chance>=5]
  Example result: items with at least 5% chance to cast frost nova.
  
  
  
  • Sub-query parameters
    • skill – skill names can be found on the Skills Reference page.
      Example search: cast[skill:frost-nova]
      Example result: items with chance or cast or charges of frost nova.
    • type – the cast/trigger type, valid values: attack, striking, struck, kill, die, level, charges
      Example search: cast[type:attack]
      Example result: items with chance to cast any skill on attack.
    • chance, level, charges – numeric values using comparison operators
      Example search: cast[chance>=5]
      Example result: items with at least 5% chance to cast any skill.
  
  
  • Notes
    • Multiple conditions can be combined with &
      Example search: cast[skill:frozen-orb&type:striking&chance>=9]
      Example result: items with at least 9% chance to cast frozen orb on striking
    • chance and charges should not be used together in the same sub-query since it won't match any items.


• If you find errors in the data or have questions, please DM me on Discord Malchar#5035 or Reddit Malchar2

Change Log

• 2026/7/10 Added searching with stat code only. The comparison operator and value default to >=1.
  Added handling for composite stats. Example: searching for resist-fire will include items that have "All Resistances", since "All resistances" includes fire resist.

Dev Roadmap / Known Bugs

• Item search logic does not account for item level, so you could get items with impossible combinations of staff mods.
• Data parsing: Handle binary stats like "ethereal" better.
• Data parsing: Class specific items should not be able to have affixes that add skills for another class. Example: + paladin skills can incorrectly appear on necro voodoo heads.
• Feature: Add autofill open sockets as a search option.
• Feature: click item result to see all its stats.
• Feature: Derived stats - calculated from base stats, like defense-effective = defense-base * defense-enhanced, average dmg, poison dps, etc.
• Stat aggregation: Implement item colors per affix and color merging logic.