Open Source · MIT Licensed

Level faster in Path of Exile

A transparent in-game overlay that auto-advances as you play. Zone-by-zone tasks, quest-aware gem rewards, and passive tree tracking — all pulled from your Path of Building XML.

Download for PoE 1
PoE 2 — Coming Soon
See all releases

What It Does

The overlay sits on top of your game and tells you what to do in each zone. It reads your PoE log file in real time and advances automatically when you enter a new area.

Import a build from Path of Building and it loads:

Skill gem links
Passive tree progression
Quest gem reminders based on class + gems in your build
Build notes from PoB XML <Notes>
01

Auto-advancing route

Detects zone changes from Client.txt and updates your guide step automatically.

02

PoB-aware tasks

Loads gems, passives, notes, and quest reward reminders from your build XML.

03

Per-character progress

Saves progress per character/build and resumes automatically each session.

Video Walkthrough

Watch the walkthrough for a full in-game overview.

Features

Updated to match the current overlay behavior and settings support.

Auto-Advancing Guide

Detects zone changes from Client.txt and shows the next step.

PoB Build Picker

Scans your PoB Builds folder and loads .xml builds directly.

Quest-Aware Gem Rewards

Replaces generic quest reward text with exact gem claims when matched.

Quest Gem Checklist

Shows pending quest/Lilly gems and lets you mark gems collected.

Passive Tree Overlay

Visual tree with allocated, next, and future nodes.

Build Notes Overlay

Toggle PoB notes in-game.

Leveling Regex Helper

Preset/custom regex shown in town and copyable to clipboard.

Configurable Hotkeys

Change hotkeys from the Settings window.

Configurable Regex Presets

Edit regex presets from the Settings window.

System Tray Support

Close button hides to tray; tray menu supports Show, Settings, Quit.

Progress Persistence

Saves per character + build and resumes automatically.

Skill Gem Tracker

Gem links grouped by PoB skill set with active/support styling and disabled gems dimmed.

Quick Start & Setup Guide

Download and run the portable EXE, or run from source. Then complete setup once and play.

Download

Grab PoE-Leveling-Overlay.exe from the Releases page.

Open Releases

Run from Source

$ git clone https://github.com/Tysktillan/poe-leveling-overlay.git
$ cd poe-leveling-overlay
$ npm install
$ npm start

Requires Node.js v18+

1

Game Log Path

The overlay auto-detects your PoE Client.txt from common install locations. If needed, click Browse next to Game Log on startup.

2

Select a Build

  • • On startup, the app lists detected PoB .xml files.
  • • Click a PoB build to load it.
  • • Click Change to point at another PoB Builds folder.
  • • Optional custom build-*.json entries can also appear.
3

Link Your Character

After selecting a build, type anything in Local chat in-game. This links the current character so progress resumes per character/build.

4

Optional Settings

Right-click the tray icon and open Settings.

  • • Change hotkeys
  • • Add/remove regex presets
  • • Reset to defaults or route defaults
5

Play

The overlay advances on zone changes and updates route tasks, gems, passives, and notes.

Hotkeys (Default)

Hotkeys are configurable in Tray -> Settings.

Overlay

Ctrl+Shift+FToggle interactive mode
Ctrl+Shift+HHide/show main overlay
Alt+Shift+RightNext step
Alt+Shift+LeftPrevious step
Ctrl+Shift+TToggle passive tree overlay
Ctrl+Shift+DToggle build notes overlay
Ctrl+Shift+RReset to build selection
EscapeClose active overlay window

Passive Tree

Shift + ScrollTree zoom
Shift + DragTree pan

Tree Legend

Allocated nodes
Next node to pick
First node (labeled)
Future allocations

Path of Building Integration

Covers skill gems, quest reward rewrites, passive tree progression, regex presets, and data storage behavior.

Skill Gems

  • • PoB skill sets (A1, A3, EarlyMaps, etc.) appear in a dropdown.
  • • Active gems are highlighted.
  • • Support gems are styled separately.
  • • Disabled gems are dimmed.

Quest Gem Rewards

  • • Cross-references loaded class, build gems, and current quest_reward step.
  • • Rewrites matching quest reward tasks to the exact gem claim.

Passive Tree

The tree overlay reads PoB <Spec> nodes and allocates by tier, prioritizing notable/keystone nodes.

Total passives = (character level - 1) + passive quest rewards

Regex Presets

  • • Presets come from route.json (leveling_regex) and are shown in town.
  • • You can choose a preset or use custom regex.
  • • If custom presets are saved in Settings, they override route defaults.
  • • Regex can be copied with one click.

Data Storage

Settings and progress are stored in Electron userData (release builds are typically under %APPDATA%\PoE Leveling Overlay).

  • • settings.json stores configured hotkeys and custom regex presets.
  • • progress-<character>.json stores progression per character/build.
  • • Legacy files next to main.js are migrated when found.

Build the Portable EXE

$ npm run dist
Output: dist/PoE-Leveling-Overlay.exe

Stop alt-tabbing. Start leveling.

Free, open source, and works with any build from Path of Building.