A library for interacting with Path of Exile game and economy data, and a unique loot filter generation framework.

Overview

wraeblast

Discord

A library for interfacing with Path of Exile game and economy data, and a set of item filters geared towards trade league players.

Filter Generation

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.

Framework Features

  • Economy insights API powered by poe.ninja
    • Integration with pandas for data normalization and analysis
    • Local caching and rate limiting
  • Powerful extended item filter framework
    • Internally uses single API to express both standard and extended filter rules
    • Jinja2-templated YAML filter format
    • Some extended filter features include:
      • Rule tagging
      • Presets (i.e. feature flags)
      • Styles
      • Template environment helpers for 🌈 color manipulation, πŸ“ˆ economy data quantization and grouping, πŸ”Š filter alert sound generation (TTS), and more
  • Matplotlib colormap integration, enabling procedural generation of item-based (not just tier-based like many popular community filters) filter colors.
  • ...and many other technical features under the hood.

Filter Features

  • πŸ“Š 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.

Demos

Installation

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.

Rationale Development Manifesto

  • Path of Exile's current loot system requires complex filters for efficient gameplay 🀦
  • Complex filters require a πŸ”¨ filter generation/templating layer πŸ”¨ (this is exactly what NeverSink has done)
  • Many community maintained filters (including NeverSink's) are ✨ awesome ✨ and work well for the majority of the playerbase, but have some shortcomings:
    • πŸš€ Über strict isn't always ΓΌber enough for softcore juiced map blasters (filter "strictness" in general is a trap)
    • 🌈 Filter customization is somewhat limiting and tedious to do through a web interface (loot filters are code)
    • πŸ“ˆ Economy-based presets and filters leverage a small subset of the available data from poe.ninja
    • πŸ› Filter rules take the kitchen sink approach and include a large amount of rules for low-value recipes and items
    • πŸ”Š Default alert sounds and sound rules are usually sparse, and adding custom sounds is a time-consuming process

Architecture

  β”Œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”
  β”‚                        β”‚
  β”‚ .yaml.j2 filter source β”œβ”€β”€β”€β”€β”
  β”‚                        β”‚    β”‚  β”Œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”  β”Œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”
  β””β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”˜    β”‚  β”‚                     β”‚  β”‚          β”‚
                                β”œβ”€β”€β”€    rendered .yaml   β”œβ”€β”€β”€  final   β”‚
β”Œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β” β”‚  β”‚ intermediate filter β”‚  β”‚ .filter  β”‚
β”‚                             β”‚ β”‚  β”‚                     β”‚  β”‚          β”‚
β”‚ .config.json filter options β”œβ”€β”˜  β””β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”˜  β””β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”˜
β”‚                             β”‚
β””β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”˜
  1. Economy insights data (currently just poe.ninja) is fetched and cached
  2. The .yaml.j2 is rendered with the economy data, colormaps, and filter option overrides from the .config.json file as context, if provided.
  3. The resulting intermediate .yaml is then parsed by the extended filter parser, and outputs a final .filter file, and any associated sounds.

Usage

See wraeblast --help and wraeblast render_filter --help for detailed command line usage.

❯ wraeblast render_filter \
    -l Expedition \
    -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.

Roadmap

  • Base filter generation functionality that nobody cares about
  • Basic filters for different play styles: HC SSF, SC SSF, casual, deli farming, harby farming, legion farming, and all-around blasting πŸš€
  • Features for league launches: shimming new item classes without relying on poe.ninja data, early league specific colormaps, thresholds, etc.
  • Performance improvements
  • Unit tests and documentation
  • Filter preview image generation
  • Filter compression/deduping of rules
  • Investigate auto-updating, but yet another downloadable tool to do it is out of the question (probably)
  • Integration with poeprofit (i.e. dedicated styles and sounds for profitable strategies)
  • Web frontend for downloading up-to-date filters (sans the complex configuration menus full of knobs and sliders and color pickers)
  • Become obsolete when PoE 2 comes out πŸ‘»

[REDACTED]

Additional features and tools are planned and will be incorporated into this project in the near future.

Comments
  • Error on Loading

    Error on Loading

    So Ive installed it exactly like the installation guide said, when loading it up on POE, I didnt see the filter except a filter called new filter. So I used that and I got line 4906: Unable to parse parameter for BaseType rule: No base types found matching "Blood Magic Support"

    opened by HelloMikko 5
  • Question regarding 6sockets

    Question regarding 6sockets

    The filter is currently showing 6Sockets even on Q5, even though they're practically worthless. Is this by choice or is it an oversight?

    on Q4+, an awakened sextant being 1.7-2c is hidden, while the 6socket is shown.

    opened by Cloudslapper 3
  • Conda environment compatability.

    Conda environment compatability.

    Background:

    As this seems to be a mix of data science and software development project, there are some things to think about. Conda as a package and python virtual environment manager is ubiquitous in data science, sometimes to the consternation of Python programmers. Conda will just work with traditional (and admittedly janky) setuptools based package requirements. It can also use an environment.yml file specifically for conda, or even just a simple pip requirements file.

    Description of the problem:

    I went down a rabbit hole chasing down getting poetry to work using my conda based python installation, and setting up poetry inside of a conda based (python) virtual environment. The official docs of poetry recommend a base installation separate of package managers like conda (https://python-poetry.org/docs/#alternative-installation-methods-not-recommended). Documentation is lacking in how poetry interacts with conda virtual environments (https://github.com/python-poetry/poetry/issues/1724). Poetry devs decided to reject even considering conda compatibility and closed the issue (https://github.com/python-poetry/poetry/issues/105). There are some scripts for taking a poetry based pyproject file and converting it to a conda one (https://github.com/dojeda/poetry2conda), however, they are unmaintained, and require individually reviewing packages, knowing whether their Pypi or conda names are used, and editing the pyproject.toml file to point to the correct package manager, source, names, etc, possibly for many dependencies. Poetry also requires a workaround to install a package in editable mode, which is sometimes used for development work.

    As a result of this, I spent more than half an hour trying to simply create a virtual environment that I could work on wraeblast with.

    Issue:

    Wraeblast is difficult to get running for people using conda, without possibly messing up your development environment (as several documented issues on poetry's github page shows). There are issues with poetry's own dependencies bleeding into the virtual environment or even your root/base python environment. This is caused by a lack of providing "the old way" of packaging python software, as existing workflows were configured to work from this (admittedly somewhat flawed) system.

    Suggestion:

    Provide and maintain either a traditional setup.py, an alternative requirements.txt, or even better, a conda environment.yml file for easily starting to work on wraeblast. It would have taken me about 20 seconds instead of more than half an hour, and especially as you said on reddit, if you want some data scientist type people taking a look at the package, it would make the process of contributing much more accessible for that community.

    Conclusion:

    Please add a non-poetry way of dependency tracking that works with existing workflows prevalent in other communities, or at least a guide on how to get this running using poetry and the recent PEP suggested pyproject.toml files.

    enhancement 
    opened by emirkmo 2
  • Line 3088: Unable to parse parameter for BaseType

    Line 3088: Unable to parse parameter for BaseType

    Line 3088: Unable to parse parameter for BaseType rule: No base types found matching "Scourged Bone Crypt Map"

    newest nightly

    Edit: every entry with Scourged 'map' as its basetype, makes the filter fail to load.

    bug 
    opened by Cloudslapper 0
  • Line 22274: Unable to parse parameter for BaseType rule: No base types found for exactly matching

    Line 22274: Unable to parse parameter for BaseType rule: No base types found for exactly matching "Maven's Orb"

    As of March 2022 I am getting this error: Line 22274: Unable to parse parameter for BaseType rule: No base types found for exactly matching "Maven's Orb"

    opened by joyzer 0
  • Some T1 Item Bases might not get displayed

    Some T1 Item Bases might not get displayed

    Just ran some Abysses and noticed ilvl86 Stygian Vises not showing up on strictness D2

    Since the Base is worth 12-16c, the filter might be missing that:

    https://poe.ninja/challenge/base-types?name=stygian&level=86%2B

    opened by kxc0re 8
Releases(v0.3.0)
Owner
David Gidwani
David Gidwani
A fast Python implementation of Ac Auto Mechine

A fast Python implementation of Ac Auto Mechine

Jin Zitian 1 Dec 07, 2021
πŸ’‰ μ½”λ‘œλ‚˜ μž”μ—¬λ°±μ‹  μ˜ˆμ•½ 맀크둜 μ»€μŠ€ν…€ λΉŒλ“œ (속도 ν–₯상 버전)

Korea-Covid-19-Vaccine-Reservation μ½”λ‘œλ‚˜ μž”μ—¬ λ°±μ‹  μ˜ˆμ•½ 맀크둜λ₯Ό 기반으둜 ν•œ μ»€μŠ€ν…€ λΉŒλ“œμž…λ‹ˆλ‹€. 더 λΉ λ₯Έ λ°±μ‹  μ˜ˆμ•½μ„ λͺ©ν‘œλ‘œ ν•˜λ©°, 속도λ₯Ό μš°μ„ ν•˜κΈ° λ•Œλ¬Έμ— μ‚¬μš©μžλŠ” 이에 λŒ€μ²˜κ°€ κ°€λŠ₯ν•΄μ•Ό ν•©λ‹ˆλ‹€. μ§€μ •ν•œ μ’Œν‘œ λ‚΄ λŒ€κΈ°μ€‘μΈ λ³‘μ›μ—μ„œ μž”μ—¬ λ°±μ‹ 

Queue.ri 21 Aug 15, 2022
Rabbito is a mini tool to find serialized objects in input values

Rabbito-ObjectFinder Rabbito is a mini tool to find serialized objects in input values What does Rabbito do Rabbito has the main object finding Serial

7 Dec 13, 2021
jfc is an utility to make reviewing ArXiv papers for your Journal Club easier.

jfc is an utility to make reviewing ArXiv papers for your Journal Club easier.

Miguel M. 3 Dec 20, 2021
a tool for annotating table

table_annotate_tool a tool for annotating table motivated by wiki2bio,we create a tool to annoate all types of tables,this tool can annotate a table w

wisdom under lemon trees 4 Sep 23, 2021
A python module to update the console without flashing.

A python module to update the console without flashing.

Matthias 112 Dec 19, 2022
Cardano Stakepools: Check for scheduled blocks in current epoch.

ReLeaderLogs For Cardano Stakepool Operators: Lightweight Scheduled Blocks Checker for Current Epoch. No cardano-node Required, data is taken from blo

SNAKE (Cardano Stakepool) 2 Oct 19, 2021
MicroMIUI - Script to optimize miui and not only

MicroMIUI - Script to optimize miui and not only

Groiznyi-Studio 1 Nov 02, 2021
Python program to do with percentages and chances, random generation.

Chances and Percentages Python program to do with percentages and chances, random generation. What is this? This small program will generate a list wi

n0 3 Jul 15, 2021
Handy Tool to check the availability of onion site and to extract the title of submitted onion links.

This tool helps is to quickly investigate a huge set of onion sites based by checking its availability which helps to filter out the inactive sites and collect the site title that might helps us to c

Balaji 13 Nov 25, 2022
Pass arguments by referenceβ€”in Python!

byref Pass arguments by referenceβ€”in Python! byrefis a decorator that allows Python functions to declare reference parameters, with similar semantics

9 Feb 10, 2022
Lock files using python and cmd

Python_Lock_Files Lock files using python and cmd license feel free to do whatever you want to with these files, i dont take any responsibility tho, u

1 Nov 01, 2021
Analyze metadata of your Python project.

Analyze metadata of your Python projects Setup: Clone repo py-m venv venv (venv) pip install -r requirements.txt specify the folders which you want to

Pedro Monteiro de Carvalho e Silva Prado 1 Nov 10, 2021
Aggregating gridded data (xarray) to polygons

A package to aggregate gridded data in xarray to polygons in geopandas using area-weighting from the relative area overlaps between pixels and polygons.

Kevin Schwarzwald 42 Nov 09, 2022
Helpful functions for use alongside the rich Python library.

πŸ”§ Rich Tools A python package with helpful functions for use alongside with the rich python library. σ € σ €  The current features are: Convert a Pandas

Avi Perl 14 Oct 14, 2022
Python script to launch burp scans automatically

SimpleAutoBurp Python script that takes a config.json file as config and uses Burp Suite Pro to scan a list of websites.

Adan Álvarez 26 Jul 18, 2022
Stubmaker is an easy-to-use tool for generating python stubs.

Stubmaker is an easy-to-use tool for generating python stubs. Requirements Stubmaker is to be run under Python 3.7.4+ No side effects during

Toloka 24 Aug 28, 2022
Random Number Generator Analysis With Python

Random-Number-Generator-Analysis Governor's Honors Program Project to determine

Jack Prewitt 2 Jan 23, 2022
This utility lets you draw using your laptop's touchpad on Linux.

FingerPaint This utility lets you draw using your laptop's touchpad on Linux. Pressing any key or clicking the touchpad will finish the drawing

Wazzaps 95 Dec 17, 2022
osqueryIR is an artifact collection tool for Linux systems.

osqueryIR osqueryIR is an artifact collection tool for Linux systems. It provides the following capabilities: Execute osquery SQL queries Collect file

AbdulRhman Alfaifi 7 Nov 02, 2022