Skip to content
Riley edited this page Mar 21, 2024 · 17 revisions

Initial setup

Resolution

Unique Matcher currently supports only resolution of 1920x1080px in fullscreen mode. If you play PoE in windowed mode, the accuracy may decrease. Playing in 1920x1080px windowed mode on larger screen (e.g. 4K) should still work, though the processing speed might be impacted due to loading larger images.

Socket notches

Using socket notches other than the basic ones will decrease accuracy on socketed items (the more sockets, the lower the accuracy). Even though testing showed that notches are not such a big problem, for the best results use the basic ones.

Changing the screenshot shortcut

Use the menu option Edit > Change screenshot shortcut to configure the shortcut for the AHK script.

Running the app

Obtaining screenshots

In the Installation section you should have started the AHK shortcut script. By pressing Win+S a new screenshot is put into data/queue folder.

Screenshot from 2023-09-23 18-39-03

The app processes screenshots from the data/queue folder, on success they are placed in data/done and on error into data/errors.

Results

Results are saved into a CSV file in data/results. The files are named according to the current date and time. If you click the Create snapshot button, a new file will be created and used until the app is closed or you click the button again. This is useful to differentiate between several runs/maps/locations.

Combining results

Since version 0.5.0 you can combine several results CSVs into one. Click on Results > Combine CSVs and then check all files you want to combine. Clicking on the file name will display a preview.

Screenshot from 2023-09-23 18-34-49

Logs

In case you find an issue, report it in Issues and include the last log from data/logs.

Factors affecting detection accuracy

Socket notches

As already mentioned, Socket Notches affect the accuracy. Here you can see the difference:

Good Okay Not so good
1 2 3

Background noise

Note

This has been fixed in v0.7.0

Since the item image is semi-transparent, you can see what's in the background and so does Unique Matcher. If the item cannot be detected, try moving it somewhere without stuff in background. See different Maligaro's Cruelty for example:

Good Problematic Problematic
m3 m1 m2

General rule of a thumb is that the more uniform the background, the better the results. This usually affect small items (rings, amulets, ...) and "thin" items (daggers, wands, ...) more than others.

Daggers and wands with 2-3 sockets

These items are 1x3 in inventory, but if there are 2 or 3 sockets, they obscure the item image. This can result in mis-detected items. See Taproot for example:

Taproot_unid

Turquoise Amulets

This item base is known to cause issues. If you take a look at Turquoise Amulets uniques, Maligaro's Cruelty is a bit similar to Ungil's Harmony. If this is combined with some background noise, these two can be mis-detected.

Aliased items

Some items have variants that have the same image. The best example is Agnerod South and its variants North, West and East. This is impossible for Unique Matcher to distinguish, so it will detect Agnerod South every time either variant drops.

Berek's rings

Berek's Pass, Berek's Grip and Berek's Respite are three very similar Two-Stone Rings. In this case a different method is used for identifying those than with other items. But it still might not be 100% accurate, so if one of these drop, please pay attention to the result table to check if they were correctly identified.

Berek's Pass Berek's Grip Berek's Respite
bereks-pass bereks-grip bereks-respite
Clone this wiki locally