[Tool] Mappy - Overlay for stash searches

Hey guys!

I'd like to present you a tool I've been working on. The tool allows you to create your own overlay to access searches you often do more quickly than re-typing the same things every day. That might sound more complex than it actually is.

Mappy
Video Showcase

Mappy lets you create one or multiple buttons with some text (which you'd type in the search field of your stash) that you can press. The text from a button then gets written to the stash field. By doing so, you created a button you can now press everytime instead of typing in the word in the search field over and over again. It's for people who don't like typing and / or are lazy.


Example of an overlay working with the quad-tab

Next up, I'd like to guide you a little bit through the navigation of the tool:


Mappy on first start up

Mappy uses what I call categories & keywords. A keyword is the button you can press to send that word to PoE. A category is like a folder, it stores keywords and allows to hide / show them.

In order to get started, you want to create at least one category and one keyword. There are 2 ways to do so:

1. Click on the + button to add a category. Assign a name to that category and click "Add new category". Your category will appear in the main window with a new + & - button next to it. These button are for creating & removing keywords. Add some keywords to your category and you are already done.

2. Click "New Overlay" and click through the new config-window which lets you add multiple categories & keywords at once. You also have the ability to save the overlay as a new file (Allows for sharing & saving multiple overlays)


Mappy after you've set up your overlay

The buttons you created are saved and will reload each time you start the script. This is why you'd use the tool, so you never have to type the things you created in your stash again.

That's basically all there is to creating the overlay. I have also created an "Example.ini" which you can load to get a first impression and maybe work on that instead of creating your own from scratch. But there are still things I'd like to mention before you start using the tool. Reading these will make it easier for you to use the tool, as well as preventing frustration you'd otherwise get since the documentation is not up to date at the moment.

Additional informations

- Removing any category or keyword: You can remove any keyword or a whole category with all its keywords by right-clicking on the button you'd like to remove. Removing keywords will simply remove them, removing categories will show you a warning before doing so.

- Saving a new overlay: When you want to save your overlay in a new file, name it however you want but add .ini at the end of the filename. You can also copy existing files, rename them and load them from Mappy and keep on reworking from there.

- Lock you window if you want to use categories & buttons, as well as the + & - buttons. Having your window unlocked allows you to move it around but prevents you from using some of your buttons. So place it anywhere you like and lock it. You can always unlock it and reposition.

- Regions are already there as buttons. Click "Show Region" to get all the regions as clickable buttons which will use the region as input for the search field.

- You can hide the script when you don't need it with Ctrl+Numpad0. There's also a "Settings" button which allows you to change that hotkey.

- Buttons appear too dark? Check out the "Settings" button and change the transparency.

- Check out the github README.md, there may be some informations I forgot.

I might have a missed a thing or two. Or things you'd like to know / see aren't there yet. Just tell me in the comments and I'll answer whenever I have the time to do so :)

Thank you

I would also like to thank all the people that have already downloaded the tool (I don't know how many because I don't collect any data or whatsoever) and supported me on reddit, discord and github. This project does mean a lot to me since it's my first personal project and getting feedback is something I haven't experienced before. It's awesome. Getting bug reports helped me fix the tool, getting feature requests added to its functionality. Getting kind words helped me as a person. I also got to work together on the tool with a total stranger which felt amazing. Big thank you to Kashi for helping me with the development! <3

As a bonus, I'd like to create a list of screenshots from people who are using the tool. Here are the first three from my early users :)

Example 1
Example 2 - Meme edition
Example 3 - Big Setup

Reserved for future updates or missing information

I see nothing here that strikes me that it would violate the ToS, but have you contacted support to verify if anything in the current setup does?

"

Aldonés wrote:

I see nothing here that strikes me that it would violate the ToS, but have you contacted support to verify if anything in the current setup does?

I have contacted support, yes! But they just told me "I am afraid that we are not able to comment on any 3rd party tools", so it is neither a yes nor a no. :/
All I can say is it doesn't provide any gameplay advantage and doesn't manipulate the game files.

Bah, even Reddit gets a better GGG response on tools than that. As far as I can tell all Mappy is doing is providing search hotkeys, correct? I don’t see any difference in that over any chat command. So as long as it only does a single server side action it should be perfectly fine.

Yep, that's what Mappy does :)
99% of code is pretty much just gui configuration and file manipulation to save things. The only interaction with the game are 3 inputs which get sent:

1. Ctrl + F to access the search field
2. The text from the button to actually search for the word
3. Enter to complete the process

But it's good to get some confirmation on that topic, thank you!

I get an error and can't make it work.
Picture or the error:

https://i.imgur.com/n9wh6Yo.png