A library for interfacing with Path of Exile game and economy data, and a set of item filters geared towards trade league players.
3.16 Scourge League Update: The trade filter is expected to be updated within the first few days of the upcoming league. Wraeblast relies heavily on economy data, and some of the cluster jewel filtering has to map passive descriptions to seemingly GGG internal, undocumented cluster jewel passive names. This work can only be done once the data is available either through data-mining or post-launch. Do note, however, that a league start filter is in the works with limited TTS, and obviously sans economy data. See the 3.16 Scourge League project board to track progress.
Wraeblast provides an experimental, feature-rich item filter development framework and toolkit, as well as a dogfooded trade league filter.
⚠️ DISCLAIMER: ⚠️ This is an experimental, proof-of-concept project, and the author is not responsible for any loss of currency or efficiency as a result of using this project's filters. Please use FilterBlade for regular gameplay unless you're brave enough to deal with a pre-alpha filter.
📊 Quantile based variants for efficient farming.†
Currently provides two variants: D2 (2nd decile) and QU4 (4th quintile). Additional quantiles will probably be included in nightly releases, depending on feedback and experimentation.
🌌 54 colormaps (108 if you include reversed colormaps, indicated
by an _r
prefix) included per quantile variant.
There are even more colormap palettes available, it would just be too cost prohibitive to include them all at present. See the Palettable documentation for colormap previews (only sequential colormaps are used).
Some form of item filter preview may be added as a feature in the future, but for now either refer to the documentation or just try them out in game.
🔊 AWS Polly Neural Text-To-Speech (NTTS) powered synthesized alert sounds for ✨all✨ valuable filter rules (quantile dependent).
Get instant, aural feedback for currency, fragments, skill gems, cluster jewels, and more. Anything tracked by poe.ninja can be supported by TTS.
Filter sounds for relevant items are also generated for varying stack sizes, for more accurate chaos value approximations.
The Aria
(New Zealand English, appropriately) voice is currently the
default for the trade league filters included with this project, but
any voice supported by AWS Polly can be used when developing new
filters.
† TLDR: think of quantiles like strictness, with an arguably better ranking of item and currency value in a trade league than hard-coded tiers.
D3
quantile,
TealGrn_r
colormap filter.TealGrn_r
colormap filter.QU4
quantile,
SunsetDark_r
colormap filter.Download the filter variant(s) of your choice from the releases,
as well as the latest, compressed TTS filter sounds. Extract both
the .filter
and the FilterSounds
directory to your Path of Exile
directory.
Filter syncing is currently not supported, and would be largely useless regardless without a way to sync filter sound files.
Note that updating the filter also requires updating the TTS files, and you can simply choose to overwrite existing files every time, or delete the entire TTS folder before installing the latest version.
┌────────────────────────┐
│ │
│ .yaml.j2 filter source ├────┐
│ │ │ ┌─────────────────────┐ ┌──────────┐
└────────────────────────┘ │ │ │ │ │
├──┤ rendered .yaml ├──┤ final │
┌─────────────────────────────┐ │ │ intermediate filter │ │ .filter │
│ │ │ │ │ │ │
│ .config.json filter options ├─┘ └─────────────────────┘ └──────────┘
│ │
└─────────────────────────────┘
.yaml.j2
is rendered with the economy data, colormaps, and filter
option overrides from the .config.json
file as context, if provided..yaml
is then parsed by the extended
filter parser, and outputs a final .filter
file, and any associated
sounds.See wraeblast --help
and wraeblast render_filter --help
for detailed
command line usage.
❯ wraeblast render_filter \
-l Scourge \
-d output \
-O filters/softcore.config.json \
-o softcore.filter -i -vvv filters/softcore.yaml.j2
For detailed library installation instructions and usage, see the technical documentation.
Additional features and tools are planned and will be incorporated into this project in the near future.