WARNING: Vulkan is still in Beta. The tool now works with Vulkan but may cause PoE to close when launched. Make sure to start any overlays you want to use before starting PoE.
WARNING: This update is not compatible with previous versions, you will need to put this project in its own folder and import any custom changes you made in previous versions
You will need AutoHotkey to run this script, with a minimum version of 1.1.30.00 https://www.autohotkey.com/
Make sure to run it with PoE in windowed fullscreen or windowed mode. It is highly recommended to turn off text scaling for high resolution monitors.
Display Settings -> Scale and layout -> Change the size of text, apps, and other items -> 100% (Recommended)
NOTE: Some users will need to run this script with right-click 'Run as Administrator' in order for the automatic detection to work. Please try without this first.
As you go through the leveling zones this script will check your Client.txt file to see the last place you entered. Only the zone name is logged so it will guess the correct act and zone based on the Part you are in. If you go backwards, you may have to manually update the Part which will cause it to recheck the location.
Based on the zone you're in, notes and diagrams from this document will be shown in an overlay to make it so you don't have to leave Path of Exile while leveling: https://docs.google.com/document/d/1sExA-AnTbroJ-HN2neZiij5G4X9u2ENlC7m_zf1tqP8/edit
NOTE: Some of these zones are outdated, there is a separate effort to update them, but if you get lost just explore.
Be sure to familiarize yourself with the above document before using this tool.
Based on the act you're in, your own notes on gems, quests and socket colors can be shown in the notes section. Each zone in the Overlays folder has a text file named after it, where you can edit the zone specific information you would like available. Each Act has a guide.txt file that you can also edit for information you would like available during the whole Act. Some placeholder notes are there for an example. You can add your own Quest Rewards so you save time while leveling.
The text on any line in the guide or notes files can now be changed to different colors. Just start the line with one of the 2 character codes in the table below. I have added color to the Acts in the "Default" build as an example. The "Abbreviated" build is colored differently to show an example as well. You can change which guide to use in the settings menu or config.ini file by setting the "overlayFolder" value. This can be very helpful for setting up your own guides as well so you can switch between gems and trees for different characters.
| 2 character code | color generated |
|---|---|
| "< " or "R," | Red |
| "+ " or "G," | Green |
| "> " or "B," | Blue |
| "W," or nothing | White |
The config.ini file, which is generated on first run to avoid overwritten changes you make in future updates, can be used to change any of the many settings. You can also use the settings menu from the tray or press F10 by default. I recommend using the defaults, but almost anything can be customized with this tool.
As you level it can be hard to remember which gems to choose for rewards and which to buy. The original intention was that the Act guide would be used for this information. However it still became difficult sometimes to remember what links to look for and where to socket the new gems. You can add your desired gem setup to the build using build editor, or by modifying the ini files in the gems folder of your build. The first entry must be level 2, but after that you can either set up every reward level or just the ones you make major changes at. The best part is you can color the text to make it easier to visualize the links you need. The npc that gives you the gem is listed in [brakets] or the npc that sells you the gem is listed with a price in (paranthesis). This will auto update as you level, but does not show up automatically. It must be viewed/hidden with the hotkey (Alt+G). As always an example is included with the provided builds.
A full passive tree can now be shown when you are picking where to place your points. This requires some work, but I will outline the steps here.
- Download PoESkillTree: https://github.com/PoESkillTree/PoESkillTree/releases
- Make or Import your tree. Path of Building (and other tools) can export just the skill tree in the form "https://www.pathofexile.com/passive-skill-tree/v/#=="
- Go to Tools, Take Screenshot of Skilled Nodes...
- Export the image as tree.jpg
- Place the file in an Act folder of your Build
- Repeat for each Act you want a different tree, if an Act has no tree it will use the last one
Any image can go there, including a screen shot of poe.ninja's heatmap or any other picture you want to look at while building your tree. The steps above are simply what I used to get a clean looking tree. If you don't want a tree to show up, simply delete or rename that tree.jpg file. The name of the file can be changed in the settigs if you want to use a png instead, but tree.jpg is the default from PoESkillTree so that's what this tool uses.
The guide shows your level and percent experience gain in the current zone at the bottom right near the experience bar. This can be toggled off, or switched to experience penalty instead of gain. It picks up any level information logged to the client.txt right now so you need to add your character name to the build editor if you are playing with friends so you don't pick up their level information. You will also need to set the level every time you restart the guide unless you want to wait until you level up again for it to pick up. It also shows how many levels over the OPTIMAL level you are for a given zone. So you may be getting 100% experience, but that experience is less than what you could get in a higher zone your character is ready for. Try to keep this number at 1 or 0 to improve your speed while leveling, but do not let it stay negative.
These can now all be changed in the settings menu if you'd like different bindings.
Alt+F1 (May need to change default NVidia screenshot bindings)
This guide auto hides after a few seconds (this can be increased or removed in settings). Changing zones will show the guide again. Using Alt+F1 while it is hidden will show it again, but if you use Alt+F1 while it is shown it will stay off until manually called back.
Alt+F2
NOTE: Since they are outdated they may just get in the way for some people.
Alt+F3
Alt+G
Alt+F
F5
F6
Any of the hotkeys can also be disabled by deleting their value in the settings menu.
If you find any bugs please feel free to log an issue on GitHub or send me a message on Reddit u/JusKillmeQik.
We also now have a Discord channel where you can ask questions or share builds: https://discord.gg/fzHj3BT
All of this is based off of a post by u/Poland144 who borrowed code from many other people to make this happen. I completely re-wrote all of the functions and cleaned up the code to make it more readable and removed some unnecessary bloat. I also added in more of Engineering Eternity's notes to the overlay for beginners. The script automatically reads in up to 6 images, so feel free to delete or add images you want in the overlay. Just make sure they are 110 pixels wide by 60 pixels tall. It also took quite a bit to add the automation, but I think I got all of the bugs worked out. I'm hoping the community uses the source or uploads pull requests to make it even better. If you'd like to donate to my efforts there is a link at the top of this page.
Cheers!
Credits:
Rebslack - provided Abbreviated as an alternative guide
josemaia - pointed out minimum autohotkey level
dsnvwlmnt - many logged issues and testing
rioreiser - original script framework
Eruyome87 - updates to the library scripts
Biggoron144 - contributions to the script
_Treb/ Engineering Eternity - zone layout images