Filtration ♦ Item Filter Script Editor ♦ [ v1.2.2 ] ♦ Updated 2019-09-11

When Item Filters were announced, Jonathan from GGG stated "As you can see, the array of UI options that we would have to provide to allow the specific filtering requirements of every player would be completely impractical."

Challenge accepted.

Introducing Filtration, a Path of Exile item filter script editor.

Filtration aims to be a full featured item filter script editor, allowing you to not only create new item filters, but edit existing ones too - no code editing required.

The application gives a concise overview of item filter scripts, including previews of how the name plates will look in-game.

Screenshot




How do I get it?

You can download Filtration and/or download the source from the GitHub page at https://github.com/ben-wallis/Filtration/releases

Filtration is fully open source under the GPL license.

Frequently Asked Questions

When I load an existing item filter some of comments aren't displayed

Filtration uses a specific marker for Section comments (comments between filter blocks), only comments in between blocks that start with # Section: are loaded as section comments. This was a design decision taken to save having to decide what to do with multiple comments in between blocks.

How can I make my script fully compatible with Filtration's features?
There is detailed information about how Filtration parses item filter scripts, and the syntax you need to use for Block Groups and Sections at the Notes for Script Creators wiki page

Scripts with Filtration Block Group Support
If your script is compatible with Filtration's Block Group Browser, let me know and I'll add it here.

♦ Antnee's Classy Item Filter for Distinguished Exiles
♦ One Filter to rule them all by Muldini
♦ Sayya's Item Filter
♦ Didii's Item Filter
♦ MaskedChimp's Item Filter

Recent Changes

2019-09-11 - 1.2.2

♦ Added Blight League Item Base Types and Item Classes to static data
♦ Adding the first Block Group to a script will now enable Block Groups for the script
♦ Removing the last Block Group from a script will now disable Block Groups for the script

2019-06-06 - 1.2.1

♦ Added Legion League Item Base Types and Item Classes to static data

2019-04-10 - 1.2.0

♦ Added support for AnyEnchantment block item type
♦ Added support for HasEnchantment block item type
♦ Added support for FracturedItem block item type
♦ Added support for SynthesisedItem block item type
♦ Fixed parsing of disabled Show/Hide blocks with extra information following the Show/Hide keyword (#133)

2018-12-06 - 1.1.0

♦ Added support for new Prophecies block item type
♦ Added Betrayal League Item Base Types and Item Classes to static data
♦ All open filter scripts are now remembered on exit and reopened when the application is started rather than just the last opened one (#95)
♦ Filter sections are once again now expanded by default when scripts are opened, unless the new "Auto-expand all sections when opening scripts" setting is disabled
♦ A new Clear Styles button has been added which removes all styles from the selected block (#96)
♦ New buttons for adding/removing DisableDropSound from all selected blocks have been added (#110)
♦ The Enable/Disable Block toggle button is now visible on both the Regular Block Items and Appearance Block Items views
♦ When there are too many block items to fit horizontally in a block a horizontal scrollbar will now appear
♦ Fixed an issue with MinimapIcon block items causing an "Unused Theme Components" message box to erroneously be shown when saving (#116)
♦ Fixed the Advanced tab in the Color Picker in the Theme Editor not being clickable (#115)
♦ Fixed the previously incorrect handling of DisableDropSound as a true/false value when in fact it is enabled/disabled purely by its presence or lack thereof in a block (#111)
♦ Fixed the application freezing for a long period of time when Ctrl+A (Select All) is performed
♦ Fixed the Switch to Appearance/Regular Block Items text overlapping block items
♦ Fixed theme saving (blank theme files were being saved) (#83)
♦ Fixed checkboxes in Block Group Browser (#97)
♦ Fixed the Select Path of Exile data directory dialog appearing after every upgrade (#94)
♦ Fixed an issue where custom sounds were only populated from the default Path of Exile data directory rather than the configured directory
♦ Clean installs no longer prompt to select the Path of Exile data directory if the default directory exists

2018-10-01 - 1.0.3

♦ Added missing AlertSound mp3 resources to installer
♦ Fixed a crash related to performing certain commands with no blocks selected
♦ Added extra logging to updater

2018-09-30 - 1.0.2

♦ Fixed crash on exit

Bugs / Issues

Please raise a bug report on the Filtration GitHub page for any bugs that you find.

You can also find me on irc.freenode.net #filtration under the nick XVar.

I will try it out, ty for that work!

"Nerdstube, deutsche Path of Exile Community"

Bumped, because this seriously needs more attention.

I'm having my coffee now, and just tinkering with this. It's fucking excellent. When I have a bit of time, I am going to try to recreate my script using your tool, and I think that will provide a solid basis for me to give you some feedback.

One thing I noticed right away is that the item previews could use some work. I use subtle borders in my filter, and because the field color of the program is so bright, they are washed out completely. I would suggest (just throwing this out there) a black or gray (or otherwise dark) border, something like this:



This is obviously a quick n dirty example, but you get the idea. It's very difficult to do anything subtle because the surrounding colors are so bright.

Great work!

Hey, thanks for the feedback :)

That's a very good point about the preview borders, I hadn't noticed that. I've made a quick tweak - the border now has 3px padding around it so the image behind (which is an image of some ground tiles from in-game) shows through around the edge.



Is that what you had in mind? It does make light borders much more visible. It'll be in the next release - probably later today.

Perfect.

I added this to your reddit post as well, but one feature I'd like to request is the ability to toggle show/hide by just clicking (or right-clicking) the show/hide box, without using the dropdown.

Reason being, I have gear-specific blocks in my script, and it would be great to be able to tell people "just open it in FFF, and click whatever boxes you wish to see/hide."

I hope that makes sense. I'm going to add a link to your program in my loot filter post, if you don't mind!

Psst..that's not my Reddit post :) That's another editor, the one written in AHK. I didn't post this to Reddit yet as I'd rather get it a bit more polished and iron out any glaring bugs before unleashing it to the masses.

I'll have a look into toggling Show/Hide - it shouldn't be too difficult to implement.

And yeah no worries at all about adding a link to it in your filter post.

Whoa, holy shit... I didn't even bother to look at the reddit links, because I assumed it was the same thing!

Good job! Looks promising. Like Antnee, +1 to have a Show/Hide direct toggle, say, on right click.

This needs more visibilty.

"

hondana wrote:

Good job! Looks promising. Like Antnee, +1 to have a Show/Hide direct toggle, say, on right click.

Thanks! The Show/Hide toggle will be in a release later today, I implemented it earlier when Antnee suggested it. I don't want to make a release for every feature that's added, I'd rather batch a few up and do at most one release per day (apart from releases for show stopping bugs).