Item filter: Difference between revisions

From Path of Exile Wiki
Jump to navigation Jump to search
({{merge}} with Guide:Item filter guide)
 
(16 intermediate revisions by 6 users not shown)
Line 1: Line 1:
{{Merge|Guide:Item filter guide|date=December 4, 2021}}
{{Split portions|Guide:Item filter guide|portions=information about item filter creation|reason=This article should cover item filters as a concept. Specifics about creating item filters should go in a separate guide|date=March 4, 2022}}
{{Guide|subject=using item filters|date=May 6, 2021‎}}
 
[[File:Item filter demonstration.gif|thumb|Item filter demonstration]]
[[File:Poe filter ggg.png|thumb|Screenshot showing how item filters work in-game.]]
[[File:Poe filter ggg.png|thumb|Screenshot showing how item filters work in-game.]]
An '''item filter''' (or '''loot filter''') is a list of rules that determines the appearance of item pickup labels in the [[Path of Exile]] user interface. This helps the player scan for valuable loot, according to their preferences.
Existing item filters are natively supported by the [[Path of Exile]] game client, but they cannot be created or edited in game. Item filters are created manually or with third-party tools. (See [[Guide:Item filter guide]].)


[[Grinding Gear Games]] implemented '''Item filters''' into the [[Path of Exile]] UI so players can customize how the game client displays items on the ground.  This feature remedies the time it takes to find useful / valuable items in game.  For those who don't have experience with programming or website development, the code for the item filters might seem complex.  However, the information provided here will open the door so that you, the player, can understand how the item filters work.
[[Grinding Gear Games]] implemented '''Item filters''' into the [[Path of Exile]] UI so players can customize how the game client displays items on the ground.  This feature remedies the time it takes to find useful / valuable items in game.  For those who don't have experience with programming or website development, the code for the item filters might seem complex.  However, the information provided here will open the door so that you, the player, can understand how the item filters work.
Line 8: Line 13:


;Step 1  
;Step 1  
:Go to: '''%USERPROFILE%/Documents/My Games/Path of Exile/'''
:Go to the following default location:
:'''PC:''' %USERPROFILE%/Documents/My Games/Path of Exile/
:For example:
:For example:
:[[File:browserlocation.jpg]]
:[[File:browserlocation.jpg]]
:'''Mac:''' Users > [username] > Library > Application Support > Path of Exile > Preferences > Item Filters
:For example:
:[[File:MacBroserLocation.png]]


;Step 2
;Step 2
Line 33: Line 42:
:Clicking 'Reload' will display this message if the Filter is working correctly:
:Clicking 'Reload' will display this message if the Filter is working correctly:
:[[File:Confirmation.png]]
:[[File:Confirmation.png]]
==Syntax==
See https://www.pathofexile.com/item-filter/about for the official page of filter rules.
===Terminology===
Please consider the following when reading this wiki page:
* Replace the values in the brackets with a single value
* x-y (i.e. 0-255) is used to show a range of valid values
* Values enclosed with [] are optional; remove the []
* Values enclosed with <> are required; remove the <>
===Basic Syntax===
The basic syntax of a script is a collection of Show and Hide blocks that each specify conditions. Anything matched by a Show block will be shown and anything matched by a Hide block will be hidden. If there are multiple conditions in a block then all of them must be matched for the block to match an item.
Every block must start with either Show or Hide, and any conditions in that block ''must'' start on the next line; indentation is optional. A line with only Show or Hide with no conditions is an "empty block," and matches ALL items, which means that a Hide at the end of the file effectively hides everything that wasn't specifically shown.
The blocks are prioritized in the order they come in the file, meaning that condition blocks that appear earlier in the file take precedence, applying their effects even if their conditions overlap with later blocks. Effectively, the script reads the filter file until it finds the first block that matches the item in question, follows that block's instructions, and then terminates.
<pre># For example, the following would hide all normal rarity items, but fail to show currencies:
Hide
    Rarity Normal
Show
    Class Currency
# To fix this, move more specific blocks earlier in the file, and save the most general for last. This would show currencies, but hide other normal rarity items:
Show
    Class Currency
Hide
    Rarity Normal
</pre>
===Comments===
A line starting with # will be considered a comment and will be ignored.
===Blocks===
{| class="wikitable sortable"
! Name !! class="unsortable" | Notes
|-
| Show || If all conditions are matched, show the item and do any actions specified.
|-
| Hide || If all conditions are matched, hide the item and do any actions specified
|-
|Continue
|Continues block to other match.
This is a special flag that indicates that the filter rule matching should not stop when an item matches this block.
Note that if an item matches a Hide block that Continues, then later matches a Show block, it will use the most recently matched Show or Hide flag, and thus show. If an item matches and Continues and then never matches any further blocks, it will also show or hide based on the most recently matched block. 
|}
=== Values ===
{| class="wikitable"
!Type
!Notes
!Range
|-
|Numeric
|Like: 20. No quotation marks.
| -1,[0-9]
|-
|String
|Text with quotation marks, but not in all condition, as example is ''Class'' or ''BaseType'' where values could be strings separated by space only
|[a-zA-Z]
|-
|None
|When argument is string ''None'' must be in quotation marks like "''None''"
|"''None''", None
|-
|''Empty''
|No value
|
|}
===Comparison operators===
The following [[wikipedia:Comparison operator|comparison operators]] are used to write conditions. Note that the equal operator (<code>=</code>) is always optional; if no operator is specified, the condition is assumed to be comparing equality.
{|class="wikitable"
! Operator !! Description
|-
| <code>=</code> || Equal
|-
| <code>!</code> || Not equal
|-
| <code><</code> || Less than
|-
| <code><=</code> || Less than or equal to
|-
| <code>></code> || Greater than
|-
| <code>>=</code> || Greater or equal to
|-
| <code><nowiki>==</nowiki></code>
| Exact match
|}
===Conditions===
Notes:
* Ranges in parentheses are plausible values, but not enforced.
* Every condition can have multiple values separated by a space.
* If a multi-word value contains whitespace, it must be encapsulated in quotation marks, or else it will be parsed as separate (and possibly invalid) values.
{| class="wikitable sortable"
! style="width: 18em" | Name !! Valid Values !! class="unsortable" | Notes
|-
|AreaLevel [Operator] <Value>
|Numeric Level (0-100)
|Filters for items dropped in a particular [[Monster level]] of the current area. This is probably the most relevant of the filters, as it allows enabling/disabling filters dynamically depending on leveling.
|-
| ItemLevel [Operator] &lt;Level&gt;
| Numeric Level (0-100)
| The [[item level]] the item was generated at.
|-
| DropLevel [Operator] &lt;Level&gt;
| Numeric Level (0-100)
| The level that the item starts dropping at.
|-
| Quality [Operator] &lt;Quality&gt;
| Numeric Quality (0-20)
| The amount of [[quality]] on the item.
|-
| Rarity [Operator] &lt;Rarity&gt;
| Normal, Magic, Rare, Unique
| [[Rarity]] of the item.
|-
| Class &lt;Class&gt;
| Full or partial item class name
|The [[Item class#Item classes|item class]]. Specifying part of a class name is allowed and will match any classes with that text in the name. So for example "One Hand" will match both "One Hand Sword" and "One Hand Axe"
|-
| BaseType &lt;Type&gt;
| Full or partial item name
| The base type of the item. Specifying a part of a base type name is allowed and will match any of the base types with that text in the name.
|-
| Prophecy &lt;Type&gt;
| Full or partial prophecy name
| The prophecy name. Specifying a part of a prophecy name is allowed and will match any of the prophecies with that text in the name. Prophecies have the Class type "Stackable Currency".
|-
| LinkedSockets [Operator] &lt;Links&gt;
| Numeric Number of Links (0-6)
| The size of the largest group of [[sockets|linked sockets]] that the item has.
|-
| SocketGroup [Operator] <GroupSyntax>
| Numeric Number of Linked Sockets followed by R, G, B, D, A, W
| Supports a list of groups that each one represents linked [[sockets]] containing a specific set of colors, at least one group must be matched for the condition to pass.
Each group is composed by an optional number and a sequence of letters. The number specifies the longest link which contains the following color sequence described by the letters. Each letter is short-hand for the colour ([R]ed, [G]reen, [B]lue, [W]hite) or Special ones ([D]elve Socket, [A]byss Socket). For example, 5RRG will match any group that contains two red sockets linked with a green socket in a 5-link group. Delve and Abyss cannot be in the same group as any other, as they cannot be linked.
If a comparison operator is used, it will apply to the numeric portion, so a ">= 5GGG" will match a 5 or more linked group with 3 green sockets.
SocketGroup with A and D socket has no effect. For example "SocketGroup RGBA" or "SocketGroup DD". As Abyss and Delve sockets are never linked.
|-
| Sockets [Operator] <GroupSyntax>
| Numeric Number of Sockets (0-6) followed by R, G, B, D, A, W
| Does the exact same thing as SocketGroup but does not require the sockets to be linked. So the same example ">= 5GGG" will match 5 or more sockets not necessarily linked, with at least 3 green sockets anywhere.
Unlike SocketGroup, this condition does allow for mixing and using Delve and Abyss sockets, for example, a [[Delve Stackable Socketable Currency|Resonator]] with 3 sockets would be "DDD".
|-
| Height [Operator] <Value>
| Numeric number of slots (1-4)
| The number of slots the item takes on the Y-axis (verical axis), i.e. the height of the item.<ref>{{cite web|url=http://www.reddit.com/r/pathofexile/comments/35kv5i/item_filter_suggestions_identified_items/cr5viii|title=Item Filter Suggestions; Identified items, corrupted items, and grid sizes.|date=12 May 2015|publisher=Reddit|last=Negitivefrags|accessdate=12 May 2015}}</ref>
|-
| Width [Operator] <Value>
| Numeric number of slots (1-2)
| The number of slots the item takes on the X-axis (horizontal axis), i.e. the width of the item.
|-
| HasExplicitMod  <Value>
| Full or partial item name
| Filter by mods on an item by name. For example: [HasExplicitMod "Tyrannical" ] (Tyrannical=Local Physical Damage 155 to 169%)
|-
| AnyEnchantment <Boolean>
| True or False
| If an item has any enchantment from the Labyrinth.
|-
| HasEnchantment <Value>
| Full or partial name of enchantment
| Filter by enchantments
|-
|EnchantmentPassiveNode <Value>
|Full or partial name of enchantment
|Filter Cluster Jewels by enchantment type.
|-
|EnchantmentPassiveNum [Operator] <Value>
| Numeric number of slots (0-n)
|Filter Cluster Jewels by the number of enchantments. Only checks the "Adds X passive skills" modifier.
|-
| StackSize  [Operator] <Value>
| Numeric number of slots (1-n)
| Currency stack size
|-
| GemLevel  [Operator] <Value>
| Numeric number of slots (1-21)
| Gem Level
|-
|GemQualityType <Value>
|Superior
Divergent
Anomalous
Phantasmal
|Gem Quality Type
|-
|AlternateQuality <Boolean>
|True or False
|If an item has alternate quality or not.  Note: This is applicable to Alternate Gems introduced in 3.12.
|-
|Replica <Boolean>
|True or False
|If an item is an Replica or not. Note: This is applicable to Replica Unique introduced in 3.12.
|-
| Identified <Boolean>
| True or False
| If an item is identified or not.
|-
| Corrupted <Boolean>
| True or False
| If an item is [[corrupted]] or not.
|-
|CorruptedMods [Operator] <Value>
|Numeric number of corrupted mods (0-n).
|How many corrupted mods are present.
|-
|Mirrored <Boolean>
|True or False
|If the item is a [[Mirrored|Mirrored item]] or not. Does not drop normally, except when opening a [[Strongbox]] with the "Contains Mirrored Items", or via the Prophecy [[Kalandra's Craft]].
|-
| ElderItem <Boolean>
| True or False
| If an item is an [[Elder item]] or not.
|-
| ShaperItem <Boolean>
| True or False
| If an item is a [[Shaper item]] or not.
|-
|HasInfluence <Type>
|Shaper, Elder, Crusader,
Hunter, Redeemer, Warlord, None
|If an item has [[Influenced item|Influence]] of a certain type. Note that this also affects [[Map]]s that are influenced.
If want item that has no [[Influenced item|Influence]], choose value as None.
|-
| FracturedItem <Boolean>
| True or False
| If an item is [[Fractured item|fractured]] or not
|-
| SynthesisedItem <Boolean>
| True or False
| If an item is [[Synthesised item|synthesised]] or not
|-
| ElderMap <Boolean>
| True or False
| If the map is [[elder]] or not.
|-
| ShapedMap <Boolean>
| True or False
| If the map is [[shaped]] or not.
|-
| BlightedMap <Boolean>
| True or False
| If the map is [[Blighted_map|blighted]] or not.
|-
| MapTier [Operator] <Value>
| Numeric Tier (1-17)
| The [[Map#Tiers|map tier]] of the [[map]].
|}
===Actions===
{| class="wikitable sortable"
! Name !! Valid Values !! class="unsortable" | Notes
|-
| SetBorderColor &lt;Red&gt; &lt;Green&gt; &lt;Blue&gt; [Alpha]
| 0-255
| Sets the border colour of the item box in RGB values from 0-255 with optional Alpha (opacity) value of 0-255
|-
| SetTextColor &lt;Red&gt; &lt;Green&gt; &lt;Blue&gt; [Alpha]
| 0-255
| Sets the text colour of the item box in RGB values from 0-255 with optional Alpha (opacity) value of 0-255
|-
| SetBackgroundColor &lt;Red&gt; &lt;Green&gt; &lt;Blue&gt; [Alpha]
| 0-255
| Sets the colour of the item box in RGB values from 0-255 with optional Alpha (opacity) value of 0-255
|-
| SetFontSize &lt;FontSize&gt;
| 18-45 (default: 32)
| Sets the font-size of item text.<ref>{{cite web|url=http://www.reddit.com/r/pathofexile/comments/34iw90/psa_you_can_change_the_font_size_in_item_filters/|title=PSA: You can change the font size in item filters.|date=2 May 2015|publisher=Reddit|last=thesircuddles|accessdate=2 May 2015}}</ref>
|-
| PlayAlertSound &lt;Id&gt; [Volume]
| Disable:
* ''None''
Id:
* [1-16] Ingame Sounds
Volume:
* [0-300]
| Plays the specified Alert Sound with optional volume when dropped. Only one sound can be played at a time.
|-
| PlayAlertSoundPositional &lt;Id&gt; [Volume]
| Disable:
* ''None''
Id:
* [1-16] Ingame Sounds
Volume:
* [0-300]
| Work as PlayAlertSound with Sound Volume relative to distance where Item dropped. Could be usable with low Tier Items to smooth Sounds.
|-
| DisableDropSound
|
| Disable the drop sound. This is a separate sound from PlayAlertSound.
|-
| EnableDropSound
|
| Enable the drop sound. This is a separate sound from PlayAlertSound.
|-
| CustomAlertSound &lt;<nowiki>FileName | FileFullPath</nowiki>&gt;
| local path to the file (with quotation marks):
* "''None''" (disable)
* [reative path]
* [absolute path]
| Plays the specified custom sound when a specified item drops. (almost all of the common file extensions should be supported)
|-
| MinimapIcon &lt;Size&gt; &lt;Color&gt; &lt;Shape&gt;
|Disable:
* -1
Size:
*0 (largest) {{mico|size=medium|id=LootFilterLargeWhiteSquare}}
*1 (medium) {{mico|size=medium|id=LootFilterMediumWhiteSquare}}
*2 (small) {{mico|size=medium|id=LootFilterSmallWhiteSquare}}
Color:
*Red {{mico|size=medium|id=LootFilterMediumRedSquare}}
*Green {{mico|size=medium|id=LootFilterMediumGreenSquare}}
*Blue {{mico|size=medium|id=LootFilterMediumBlueSquare}}
*Brown {{mico|size=medium|id=LootFilterMediumBrownSquare}}
*White {{mico|size=medium|id=LootFilterMediumWhiteSquare}}
*Yellow {{mico|size=medium|id=LootFilterMediumYellowSquare}}
*Cyan {{mico|size=medium|id=LootFilterMediumCyanSquare}}
* Grey {{mico|size=medium|id=LootFilterMediumGreySquare}}
* Orange {{mico|size=medium|id=LootFilterMediumOrangeSquare}}
* Pink {{mico|size=medium|id=LootFilterMediumPinkSquare}}
* Purple {{mico|size=medium|id=LootFilterMediumPurpleSquare}}
Shape:
*Circle {{mico|size=medium|id=LootFilterMediumWhiteCircle}}
*Diamond {{mico|size=medium|id=LootFilterMediumWhiteDiamond}}
*Hexagon {{mico|size=medium|id=LootFilterMediumWhiteHexagon}}
*Square {{mico|size=medium|id=LootFilterMediumWhiteSquare}}
*Star {{mico|size=medium|id=LootFilterMediumWhiteStar}}
*Triangle {{mico|size=medium|id=LootFilterMediumWhiteTriangle}}
*Cross {{mico|size=medium|id=LootFilterMediumWhiteCross}}
*Moon {{mico|size=medium|id=LootFilterMediumWhiteMoon}}
*Raindrop {{mico|size=medium|id=LootFilterMediumWhiteRaindrop}}
*Kite {{mico|size=medium|id=LootFilterMediumWhiteKite}}
*Pentagon {{mico|size=medium|id=LootFilterMediumWhitePentagon}}
*UpsideDownHouse {{mico|size=medium|id=LootFilterMediumWhiteUpsideDownHouse}}
| Displays an icon on the minimap for specified items.
|-
| PlayEffect &lt;Color&gt; [Temp]
|Disable:
* ''None''
Color:
*Red
* Green
* Blue
* Brown
* White
* Yellow
* Cyan
* Grey
* Orange
* Pink
* Purple
Beam Visualization [Temp]:
*''Empty'' (no value, instantly)
* Temp (temporary)
| Displays a coloured beam of light above an item highlighted by an item filter.
Use the Temp parameter to have a beam only appear as the item drops.<br>Otherwise, it will be permanently visible.
|}
A list of the default RGB codes used in-game can be found in the corresponding [[Item filter guide#Color Options|item filter guide section]].
===Examples===
<!-- Someone add some examples here. Please do not add complete filters, just examples to show people how it can be setup -->
====Example 1====
* Shows all items with a red, green and blue linked socket
* Changes the text color to a light blue one
<pre>Show
    SocketGroup RGB
    SetTextColor 127 127 255
</pre>
====Example 2====
* Shows all items that match the following conditions
** Item class is either [[Ring]] or [[Amulet]]
** Item basename contains "Gold"
** Item has the "Rare" [[rarity]] level
** Item level is 75 or higher
* Effectively, this means rare [[Gold Ring]]s and [[Gold Amulet]]s with [[item level]] 75 or higher will be shown
* Changes the border to a yellow border
<pre>Show
    Class Ring Amulet
    BaseType Gold
    Rarity Rare
    ItemLevel >= 75
    SetBorderColor 255 255 0
</pre>
==Known issues==
<!-- Editors: Remove issues if confirmed fixed -->
Known issues with workaround. Use at your own risk.
===Item filters not found===
====Solution A====
* Check that the filter has the correct ending (.filter )
* Check whether the item filter is placed in the correct folder
====Solution B====
Currently (beta) item filters may not load for users who use a non-ASCII userpath. As a work around you can move your documents folder to a location which does not contain non-ASCII letters. To do so:
  Go to your user folder (%USERPROFILE%) -> right click on My Documents -> properties -> path -> move... -> select a new location to move to -> apply


==List of item filters==
==List of item filters==
Line 486: Line 51:
==Version history==
==Version history==
{{Version history table header}}
{{Version history table header}}
{{Version history table row|3.16.0b}}
{{Version history table row|3.23.0|
* Fixed a bug where [[Guide:Item filter|Item Filters]] would incorrectly assign Weapons and Jewellery a BaseDefencePercentile value of 0 rather than 100.
* The GemQualityType condition has been removed.
{{Version history table row|3.15.0d}}
}}
{{Version history table row|3.18.0e|
* "Hide Filtered Ground Items" is now enabled by default due to the performance benefits it provides. This setting will be enabled upon downloading this patch and can be disabled in the Gameplay section of the Options menu.
}}
{{Version history table row|3.17.0|
* Added new functionality and made improvements to Item Filters. You can read more about them here: https://www.pathofexile.com/forum/view-thread/3230194
}}
{{Version history table row|3.16.0b|
* Fixed a bug where [[Item Filters]] would incorrectly assign Weapons and Jewellery a BaseDefencePercentile value of 0 rather than 100.
}}
{{Version history table row|3.16.0|
* Added new functionality and made improvements to Item Filters. You can read more about them here: https://www.pathofexile.com/forum/view-thread/3187476
}}
{{Version history table row|3.15.0d|
* Rapier One Hand Swords are once again classified as Thrusting One Hand Swords. Their Weapon Range is again 14 (instead of 11). Please update your item filters!
* Rapier One Hand Swords are once again classified as Thrusting One Hand Swords. Their Weapon Range is again 14 (instead of 11). Please update your item filters!
{{Version history table row|3.15.0}}
}}
{{Version history table row|3.15.0|
* Added new functionality and made improvements to Item Filters. You can read more about them here: https://www.pathofexile.com/forum/view-thread/3147480
* Added new functionality and made improvements to Item Filters. You can read more about them here: https://www.pathofexile.com/forum/view-thread/3147480
{{Version history table row|3.14.0}}
}}
{{Version history table row|3.14.0|
* Added new functionality and made improvements to Item Filters. You can read more about them here: https://www.pathofexile.com/forum/view-thread/3079980
* Added new functionality and made improvements to Item Filters. You can read more about them here: https://www.pathofexile.com/forum/view-thread/3079980
{{Version history table row|3.13.0}}
}}
{{Version history table row|3.13.0|
* Added new functionality and made improvements to Item Filters. You can read more about them here: https://www.pathofexile.com/forum/view-thread/3009221
* Added new functionality and made improvements to Item Filters. You can read more about them here: https://www.pathofexile.com/forum/view-thread/3009221
{{Version history table row|3.12.0}}
}}
{{Version history table row|3.12.0|
* Added new functionality and made improvements to Item Filters. You can read more about them here: https://www.pathofexile.com/forum/view-thread/2935826
* Added new functionality and made improvements to Item Filters. You can read more about them here: https://www.pathofexile.com/forum/view-thread/2935826
{{Version history table row|3.11.0}}
}}
{{Version history table row|3.11.0|
* Added new functionality and made improvements to Item Filters. You can read more about them here: https://www.pathofexile.com/forum/view-thread/2873743
* Added new functionality and made improvements to Item Filters. You can read more about them here: https://www.pathofexile.com/forum/view-thread/2873743
{{Version history table row|3.10.2b}}
}}
{{Version history table row|3.10.2b|
* You can now filter for items without being required to use special alphanumeric characters, such as "Maelstrom Staff" rather than "Maelström Staff".
* You can now filter for items without being required to use special alphanumeric characters, such as "Maelstrom Staff" rather than "Maelström Staff".
{{Version history table row|3.10.1d}}
}}
{{Version history table row|3.10.1d|
* Fixed a rare bug where the client would repeatedly download an item filter.
* Fixed a rare bug where the client would repeatedly download an item filter.
* Added an EnableDropSound parameter that can be used in Item Filters.
* Added an EnableDropSound parameter that can be used in Item Filters.
* Added a chat output upon logging into a character which contains information about the currently loaded item filter if that filter is one that you are subscribed to through your account page.
* Added a chat output upon logging into a character which contains information about the currently loaded item filter if that filter is one that you are subscribed to through your account page.
{{Version history table row|3.10.1}}
}}
{{Version history table row|3.10.1|
* Fixed an issue with the PlayAlertSound parameter in Item Filters not handling the Continue command correctly.
* Fixed an issue with the PlayAlertSound parameter in Item Filters not handling the Continue command correctly.
{{Version history table row|3.10.0}}
}}
{{Version history table row|3.10.0|
* Added new item filter drop effect colour options.
* Added new item filter drop effect colour options.
* Delve areas are now considered to be the level of the monsters in the shallowest part of the Delve, meaning players will not be downscaled below the level of the shallowest part of the Delve. It also means that item filters which filter by area level will work correctly in the Azurite Mine.
* Delve areas are now considered to be the level of the monsters in the shallowest part of the Delve, meaning players will not be downscaled below the level of the shallowest part of the Delve. It also means that item filters which filter by area level will work correctly in the Azurite Mine.
{{Version history table row|3.9.2f}}
}}
{{Version history table row|3.9.2f|
* Added new functionality and made improvements to Item Filters. You can read more about them here: https://www.pathofexile.com/forum/view-thread/2771031
* Added new functionality and made improvements to Item Filters. You can read more about them here: https://www.pathofexile.com/forum/view-thread/2771031
{{Version history table row|3.9.2e}}
}}
{{Version history table row|3.9.2e|
* Fixed a bug where declining the save option when changing your Item Filter caused the most recently selected Item Filter to be used.
* Fixed a bug where declining the save option when changing your Item Filter caused the most recently selected Item Filter to be used.
{{Version history table row|3.9.2}}
}}
{{Version history table row|3.9.2|
* Fixed the item filter settings not saving when using languages other than English.
* Fixed the item filter settings not saving when using languages other than English.
* Fixed a bug where updating an item filter on the website would de-select it in-game.
* Fixed a bug where updating an item filter on the website would de-select it in-game.
{{Version history table row|3.9.0}}
}}
{{Version history table row|3.9.0|
* You can now add Item Filters to your account through the Path of Exile website. When you then log into your game client, no matter where you are logging in from, you will then have access to all of the Item Filters tied to your account (even if you're playing on Console!).
* You can now add Item Filters to your account through the Path of Exile website. When you then log into your game client, no matter where you are logging in from, you will then have access to all of the Item Filters tied to your account (even if you're playing on Console!).
{{Version history table row|3.8.1d}}
}}
{{Version history table row|3.8.1d|
* You can now use an "Exact Match" parameter in Item Filters. Simply use == to filter for exact matches. For example, BaseType == "The Demon" will show The Demon Divination Card but will not show The Demoness.
* You can now use an "Exact Match" parameter in Item Filters. Simply use == to filter for exact matches. For example, BaseType == "The Demon" will show The Demon Divination Card but will not show The Demoness.
{{Version history table row|3.8.0d}}
}}
{{Version history table row|3.8.0d|
* Updated the default item filter.
* Updated the default item filter.
{{Version history table row|3.7.2}}
}}
{{Version history table row|3.7.2|
* Increased the volume levels of all item filter sounds as they were quieter than intended.
* Increased the volume levels of all item filter sounds as they were quieter than intended.
{{Version history table row|3.6.0}}
}}
{{Version history table row|3.6.0|
* Item filters can now filter out Shaper and Elder items, if that's something you want to do for some reason.
* Item filters can now filter out Shaper and Elder items, if that's something you want to do for some reason.
{{Version history table row|3.4.1}}
}}
{{Version history table row|3.4.1|
* Fixed a bug where quest items could be hidden on the minimap when using item filters.
* Fixed a bug where quest items could be hidden on the minimap when using item filters.
{{Version history table row|3.4.0}}
}}
{{Version history table row|3.4.0|
* Items filters are now capable of displaying minimap icons and lightbeams for specific categories of items, making them much harder to miss.
* Items filters are now capable of displaying minimap icons and lightbeams for specific categories of items, making them much harder to miss.
* Added the capacity to use custom local sound files in your item filter.
* Added the capacity to use custom local sound files in your item filter.
{{Version history table row|3.3.1b}}
}}
{{Version history table row|3.3.1b|
* Fixed an issue introduced by patch 3.3.1b which caused the default loot filter to be unable to load. If you were having this issue, please close and re-open your client in order to download the fix.
* Fixed an issue introduced by patch 3.3.1b which caused the default loot filter to be unable to load. If you were having this issue, please close and re-open your client in order to download the fix.
{{Version history table row|3.3.1}}
}}
{{Version history table row|3.3.1|
* The default loot filter now plays audio when an item with 5 linked sockets drops.
* The default loot filter now plays audio when an item with 5 linked sockets drops.
{{Version history table row|3.3.0c}}
}}
{{Version history table row|3.3.0c|
* Tweaked various alert sounds in the Default Loot Filter.
* Tweaked various alert sounds in the Default Loot Filter.
{{Version history table row|3.3.0}}
}}
{{Version history table row|3.3.0|
* The item filter now supports sorting by gem levels, stack sizes and explicit item mods.
* The item filter now supports sorting by gem levels, stack sizes and explicit item mods.
{{Version history table row|3.2.1}}
}}
{{Version history table row|3.2.1|
* Added a keyword that item filters can use to disable default drop sounds. The keyword is "DisableDropSound".
* Added a keyword that item filters can use to disable default drop sounds. The keyword is "DisableDropSound".
{{Version history table row|3.1.0b}}
}}
{{Version history table row|3.1.0b|
* Fixed a bug where some items were not being filtered correctly when using the default loot filter.
* Fixed a bug where some items were not being filtered correctly when using the default loot filter.
{{Version history table row|3.0.0}}
}}
{{Version history table row|3.0.0|
* In item filters, you can now use PlayAlertSoundPositional rather than PlayAlertSound to play a positional version (the sound comes from where the item dropped).
* In item filters, you can now use PlayAlertSoundPositional rather than PlayAlertSound to play a positional version (the sound comes from where the item dropped).
* Item filters can now play a much larger array of sounds when items drop.
* Item filters can now play a much larger array of sounds when items drop.
{{Version history table row|2.5.0d}}
}}
{{Version history table row|2.5.0d|
* Various improvements have been made to the default Item Filter.
* Various improvements have been made to the default Item Filter.
{{Version history table row|2.5.0}}
}}
* Items filters can now see whether an item is corrupted with "corrupted true".
{{Version history table row|2.5.0|
{{Version history table row|2.4.2}}
* Items filters can now see whether an item is corrupted with "Corrupted true".
}}
{{Version history table row|2.4.2|
* There’s now an item filter bundled with Path of Exile that you can select in the User Interface options.
* There’s now an item filter bundled with Path of Exile that you can select in the User Interface options.
{{Version history table row|2.3.2}}
}}
{{Version history table row|2.3.2|
* Added "Identified" as a filter option for Item Filters. Valid values for this filter are "True" or "False".
* Added "Identified" as a filter option for Item Filters. Valid values for this filter are "True" or "False".
{{Version history table row|2.2.1d}}
}}
{{Version history table row|2.2.1d|
* Fixed a bug where Labyrinth Items could be displayed incorrectly when modifying how they are shown using Item Filters.
* Fixed a bug where Labyrinth Items could be displayed incorrectly when modifying how they are shown using Item Filters.
{{Version history table row|2.0.1}}
}}
{{Version history table row|2.0.1|
* Sound events triggered by item filters can now have a maximum volume of 300 (up from 100).
* Sound events triggered by item filters can now have a maximum volume of 300 (up from 100).
{{Version history table row|2.0.0b}}
}}
{{Version history table row|2.0.0b|
* Fixed a bug with Item Filters where some item types would not load if they were included in a type that was already loaded. For example, "Thrusting" when "Swords" was already loaded.
* Fixed a bug with Item Filters where some item types would not load if they were included in a type that was already loaded. For example, "Thrusting" when "Swords" was already loaded.
{{Version history table row|2.0.0}}
}}
{{Version history table row|2.0.0|
* We’ve added Item Filter functionality. You can now filter what types of items you want to see, cause sounds to play, change the font colour, size, and other options. For more information about item filters, check out www.pathofexile.com/itemfilters
* We’ve added Item Filter functionality. You can now filter what types of items you want to see, cause sounds to play, change the font colour, size, and other options. For more information about item filters, check out www.pathofexile.com/itemfilters
 
}}
|}
{{Version history table end}}


==See also==
==See also==
* [[Item filter guide]]
* [[Item filter guide]]
* [[List of item filters]]
* [[List of item filters]]
==References==
{{reflist}}


==External links==
==External links==
*[https://www.pathofexile.com/item-filter/ladder/follower Path of Exile - Popular Item Filters]
*[https://www.pathofexile.com/item-filter/ladder/follower Path of Exile - Popular Item Filters]
*[[poeforum:1235695|Path of Exile (Forum) - Item Filters Announcement]]
*[https://www.pathofexile.com/forum/view-thread/1235695 Path of Exile (Forum) - Item Filters Announcement]
*[[poeforum:1260664|Path of Exile (Forum) - The Guide to Loot Filters]]
*[https://www.pathofexile.com/forum/view-thread/1260664 Path of Exile (Forum) - The Guide to Loot Filters]


[[Category:Guides]]
[[Category:User interface]]
[[Category:Item mechanics]]
[[ru:Фильтр предметов]]
[[ru:Фильтр предметов]]

Latest revision as of 14:00, 28 January 2024

It has been suggested that information about item filter creation be split into another article titled Guide:Item filter guide.

Reason: This article should cover item filters as a concept. Specifics about creating item filters should go in a separate guide

Proposed since March 4, 2022

Item filter demonstration
Screenshot showing how item filters work in-game.

An item filter (or loot filter) is a list of rules that determines the appearance of item pickup labels in the Path of Exile user interface. This helps the player scan for valuable loot, according to their preferences.

Existing item filters are natively supported by the Path of Exile game client, but they cannot be created or edited in game. Item filters are created manually or with third-party tools. (See Guide:Item filter guide.)

Grinding Gear Games implemented Item filters into the Path of Exile UI so players can customize how the game client displays items on the ground. This feature remedies the time it takes to find useful / valuable items in game. For those who don't have experience with programming or website development, the code for the item filters might seem complex. However, the information provided here will open the door so that you, the player, can understand how the item filters work.

Using an existing filter

Step 1
Go to the following default location:
PC: %USERPROFILE%/Documents/My Games/Path of Exile/
For example:
Mac: Users > [username] > Library > Application Support > Path of Exile > Preferences > Item Filters
For example:
Step 2
Locate an existing filter, i.e. from List of item filters or elsewhere.
Step 2A - Copying file
If the item filter is supplied as downloadable file with the .filter extension, you can simply download it and save it in the folder.
Step 2B - Copying Contents
Create a text file with the name you want your Filter to have. When you Save this file, be sure to select 'Save As' and set the file type to "All Files (*.*)". Copy the contents of the filter into the file.
Then save the file as: filtername.filter
It should look like this if done correctly
If you cannot see your file extension, Show/Hide File extensions in Windows
Step 3
Go to the in-game Options menu and click on the UI tab. You should see this new option, located at the very bottom of the list:
If your Filter is not a .filter file, or it is not located in the same folder as your production_Config.ini file, you won't see this option.
Step 4
Clicking 'Reload' will display this message if the Filter is working correctly:

List of item filters

Main page: list of item filters

Note: For sorting by multiple columns hold SHIFT.

General purpose filters

NameAuthorReleaseIngame FeaturesOther FeaturesFiltration Support
ColoursBordersFont
Size		BackgroundItem
Hiding		LevelingEndgameVendor
recipes		CraftingCustomizableGeneralThemes
Ajido's Aesthetically Pleasing Loot FilterAjido (Twitch YouTube)2015-07-17majormajoryesyesyesyesyespartialyesyesyesno
EpicFail42's Loot FilterEpicFail422015-06-25minormajorpartialminorpartialmajoryesyesminornoyesno
Highwind's Lootfilterffhighwind2015-12-10majormajormajormajoryesyesyesyesyesyesyesyes
Ment's Item FilterMent20082015-04-11partialmajormajorminoryesyesyesyesyesyesnono
NeverSink's LootfilterNeverSink2015-04-15partialpartialmajormajoryesyesyesyesyesyesyesyes
One Filter to rule them allMuldini2015-05-03minorminorminorminoryesyesyesyesyesyesyesno
SimplefilterKoszmarnica2020-12-31yesyesyesyesyesyesyesyesyespartialpartialno
StupidFatHobbit's SovereignStupidFatHobbit2016-03-02partialyesmajormajoryesyesyesyesyesyesnono

Specialized filters

Filters that are intended for a specialized purpose, such as leveling a specific class or otherwise.

NameAuthorReleaseIngame FeaturesOther FeaturesFiltration SupportDescription
ColoursBordersFont
Size		BackgroundItem
Hiding		LevelingEndgameVendor
recipes		CraftingCustomizableGeneralThemes


Version history

Version Changes
3.23.0
  • The GemQualityType condition has been removed.
3.18.0e
  • "Hide Filtered Ground Items" is now enabled by default due to the performance benefits it provides. This setting will be enabled upon downloading this patch and can be disabled in the Gameplay section of the Options menu.
3.17.0
3.16.0b
  • Fixed a bug where Item Filters would incorrectly assign Weapons and Jewellery a BaseDefencePercentile value of 0 rather than 100.
3.16.0
3.15.0d
  • Rapier One Hand Swords are once again classified as Thrusting One Hand Swords. Their Weapon Range is again 14 (instead of 11). Please update your item filters!
3.15.0
3.14.0
3.13.0
3.12.0
3.11.0
3.10.2b
  • You can now filter for items without being required to use special alphanumeric characters, such as "Maelstrom Staff" rather than "Maelström Staff".
3.10.1d
  • Fixed a rare bug where the client would repeatedly download an item filter.
  • Added an EnableDropSound parameter that can be used in Item Filters.
  • Added a chat output upon logging into a character which contains information about the currently loaded item filter if that filter is one that you are subscribed to through your account page.
3.10.1
  • Fixed an issue with the PlayAlertSound parameter in Item Filters not handling the Continue command correctly.
3.10.0
  • Added new item filter drop effect colour options.
  • Delve areas are now considered to be the level of the monsters in the shallowest part of the Delve, meaning players will not be downscaled below the level of the shallowest part of the Delve. It also means that item filters which filter by area level will work correctly in the Azurite Mine.
3.9.2f
3.9.2e
  • Fixed a bug where declining the save option when changing your Item Filter caused the most recently selected Item Filter to be used.
3.9.2
  • Fixed the item filter settings not saving when using languages other than English.
  • Fixed a bug where updating an item filter on the website would de-select it in-game.
3.9.0
  • You can now add Item Filters to your account through the Path of Exile website. When you then log into your game client, no matter where you are logging in from, you will then have access to all of the Item Filters tied to your account (even if you're playing on Console!).
3.8.1d
3.8.0d
  • Updated the default item filter.
3.7.2
  • Increased the volume levels of all item filter sounds as they were quieter than intended.
3.6.0
  • Item filters can now filter out Shaper and Elder items, if that's something you want to do for some reason.
3.4.1
  • Fixed a bug where quest items could be hidden on the minimap when using item filters.
3.4.0
  • Items filters are now capable of displaying minimap icons and lightbeams for specific categories of items, making them much harder to miss.
  • Added the capacity to use custom local sound files in your item filter.
3.3.1b
  • Fixed an issue introduced by patch 3.3.1b which caused the default loot filter to be unable to load. If you were having this issue, please close and re-open your client in order to download the fix.
3.3.1
  • The default loot filter now plays audio when an item with 5 linked sockets drops.
3.3.0c
  • Tweaked various alert sounds in the Default Loot Filter.
3.3.0
  • The item filter now supports sorting by gem levels, stack sizes and explicit item mods.
3.2.1
  • Added a keyword that item filters can use to disable default drop sounds. The keyword is "DisableDropSound".
3.1.0b
  • Fixed a bug where some items were not being filtered correctly when using the default loot filter.
3.0.0
  • In item filters, you can now use PlayAlertSoundPositional rather than PlayAlertSound to play a positional version (the sound comes from where the item dropped).
  • Item filters can now play a much larger array of sounds when items drop.
2.5.0d
  • Various improvements have been made to the default Item Filter.
2.5.0
  • Items filters can now see whether an item is corrupted with "Corrupted true".
2.4.2
  • There’s now an item filter bundled with Path of Exile that you can select in the User Interface options.
2.3.2
  • Added "Identified" as a filter option for Item Filters. Valid values for this filter are "True" or "False".
2.2.1d
  • Fixed a bug where Labyrinth Items could be displayed incorrectly when modifying how they are shown using Item Filters.
2.0.1
  • Sound events triggered by item filters can now have a maximum volume of 300 (up from 100).
2.0.0b
  • Fixed a bug with Item Filters where some item types would not load if they were included in a type that was already loaded. For example, "Thrusting" when "Swords" was already loaded.
2.0.0
  • We’ve added Item Filter functionality. You can now filter what types of items you want to see, cause sounds to play, change the font colour, size, and other options. For more information about item filters, check out www.pathofexile.com/itemfilters

See also

External links

ru:Фильтр предметов

Retrieved from "https://www.poewiki.net/index.php?title=Item_filter&oldid=1418237"