The Build hub is built around one character. Set a poe.ninja profile once and it fills the Overview, Skills, Items and Planner tabs, and Upgrades can read the same character. For anything else, such as a guide build or an old PoB file, use Load a Different Build.
Over the game, the Passives & Heatmap tool window shows the Planner. It is on the Feature Bar by default. Its hotkey, Passives And Heatmap, is unbound, so assign one under Overlays → Hotkeys → Tool windows if you want one.
Your character
Open Build → Overview. The Active character banner at the top shows who is loaded. With no profile yet, paste your poe.ninja character profile link (it looks like poe.ninja/poe2/profile/{account}/{league}/character/{name}) and press Set Profile. The profile has to be public on poe.ninja.
The banner then carries Refresh (with how long ago the character was updated), Change Profile and Load a Different Build. It stays the same on all four character tabs, so switching tabs never re-imports.
Load a Different Build
Load a Different Build opens the import form for a one-off build. It reads from any of these:
Your Path of Building builds. If Path of Building is installed, the top card lists the builds it has saved on this PC: "Loaded straight from Path of Building on this PC — nothing to paste." Click one to load it. After you re-import a character in PoB, press ↻ Refresh. Build → Upgrades reads this same list.
A Mobalytics or Maxroll URL. Paste the build guide's address and press Import URL. You get class, skills, gear and passives. Guides with several variants (leveling, early maps, endgame) show a Variant chip for each one, labeled with its passive count.
A poe.ninja profile. Paste another character's profile link and press Import Profile.
Grinding Gear Games' passive-tree planner. Paste the share link (or just the code) and press Import Tree. That gives you the class, the ascendancy and every allocated passive. A tree link has no gems, gear or level, and the note under the box says so.
A `.build` file from the in-game Build Planner. Drop it on the box. The game saves these under Documents/My Games/Path of Exile 2. ePOE reads the skills and the description, but it cannot place the passives, because GGG publishes no mapping from the file's passive names to the tree's nodes. For the tree, use the planner share link instead.
A PoB code. In Path of Building, use Import/Export → Generate and paste the code into the text box, then press Import Code. It is decoded on your machine.
When a build is showing, press Save Build and it appears under Saved builds, where you can reload it without importing again. A saved PoB build is re-read from its file if that file is still on disk, so it picks up your latest changes.
Reading the build
Overview shows the class, ascendancy and level, then the Character sheet. For PoB builds the sheet is recomputed in the background by Path of Building itself, and PoB live marks those numbers. The full list of computed stats opens below the sheet, with a filter. Skills lists every gem setup, and Items shows the gear.
Planner shows the Passive tree, then the allocated Keystones, Ascendancy and Notable passives.
Your poe.ninja character's tree is for reading: it shows the character as poe.ninja last saw it. To plan or change a tree, load the build with Load a Different Build and press Edit Tree (see Editing a tree below). Drag to pan, scroll to zoom and hover a node to see its name. Fit Build frames your allocation, Whole Tree zooms out and ⛶ Pop Out gives it the whole window. The ascendancy is drawn as a medallion at the tree's center, using its real in-game layout.
Icons: Off is the default, and the tree shows plain dots. Switch it on to use the real game icons and ascendancy art. They are downloaded from Path of Building's public sheets the first time and cached locally.
Editing a tree
A build you load with Load a Different Build has an Edit Tree button on its Passive tree card. Press it and the tree becomes a planner; Done Editing turns it back into the plain view. Your poe.ninja character's own tree stays read-only, because it mirrors the live character.
- Allocate. Hover a passive and the path to it lights up in green. Click to allocate the whole path. ePOE always takes the shortest route out of what you already have.
- Refund. Hover an allocated passive and it turns red, together with every passive that would be cut off from your class start without it. Click to refund them all at once.
- Search. Type in Search Passives… to ring every passive whose name or stats match. Matches shows how many there are.
- Class and ascendancy. Pick them from the Class and Ascendancy lists. Changing class keeps the passives that still connect to the new start. Changing ascendancy clears the ascendancy passives.
- Attribute passives. Clicking a "+5 to any Attribute" passive opens a chooser. Pick Strength, Dexterity or Intelligence, or Refund it from there.
- Undo and Redo. Use the buttons, or Ctrl+Z and Ctrl+Y (Ctrl+Shift+Z works too). The counter shows your Passive Points and Ascendancy Points.
When the tree looks right, take it with you:
- Copy GGG Link copies a link to Grinding Gear Games' own passive-tree planner, and Open in GGG Planner opens it in your browser. Weapon-set passives and attribute choices come along.
- Copy PoB Code copies a Path of Building import code for the edited build. It needs a build that came with Path of Building data: one of your local PoB builds, or a PoB code.
- Save to Path of Building writes the edited tree straight back into the build file. Only the builds listed under your Path of Building builds on this PC can be saved, and ePOE first keeps a timestamped
.bakcopy next to the file. If the file changed after you opened it (say you edited it in PoB meanwhile), the save is refused with "This build changed since it was opened". Load the build again and redo the edit. After a save, Path of Building recalculates the character sheet and the editor lists what changed. Without Path of Building installed the save still happens, and the editor says Stats Not Recalculated.
Not editable yet: tagging passives to weapon set 1 or 2 (tags a build already has are kept and saved), jewels, anoints, and the Abyssal Lich ascendancy, which the editor shows but won't save.
The reference tabs
Under the tree, a Reference card has four tabs: Keystones, Ascendancy, Notables and Meta Heatmap. The first three are offline lists that match against stat text, so searching "block" finds every node that mentions it. Ascendancy also has a Class filter. The Reference works even with no character loaded.
Meta Heatmap
This tab shows how often tracked characters allocate each passive. It opens poe.ninja's public Builds page in a separate window. ePOE does not use poe.ninja's private API, and nothing is scraped.
- The League is the one set under Settings → Price Checks.
- Class or ascendancy narrows the heatmap. Changing it reloads the open window.
- Press Open Live Heatmap (or Open In Browser). Then use Zoom (drag from 25% to 300%, or type any percentage from 1% to 500%) and Opacity to fit it over your screen. If poe.ninja changes its page layout, the zoom greys out until ePOE is updated.
- Freeze In Game captures the open window and pins that image over the game. Unfreeze removes it. You have to open the live heatmap first.
Snapshots
Save Snapshot stores the current heatmap as an image, with an optional name. The image lives in a heatmaps folder in your ePOE data, and ePOE keeps the newest 50. Each row has Recall (show it over the game again, even offline), Rename and Delete.
Two hotkeys do this without the dashboard, and both are unbound by default. Freeze Meta Heatmap freezes the live window, or unfreezes the image that is already showing. Recall Last Heatmap Snapshot shows your newest snapshot. Assign them under Overlays → Hotkeys → Tool windows. They only work while the Passives & Heatmap overlay is switched on.
On epoe.io
The website has a quick viewer at epoe.io/builds, with no account needed. Paste a Path of Building code and press View Build, or import a poe.ninja profile, to see the class, ascendancy, level, skill gems and passive count. The code is decoded in your browser. Copy Share Link gives you a link to the same build, as long as the code is short enough to fit in one. The full passive tree, Upgrades and the leveling tools are in the desktop app.
Tips
- Snapshot the meta at the start of a league. Recalling it weeks later shows you how the tree has shifted.
- Heatmaps show popularity, not power. A red node means lots of people took it. That is worth a look, but it doesn't make the node right for your build.
- Keep your own character on the profile. Use Load a Different Build for guides and experiments, so the profile keeps pointing at the character you play.
Related
- Upgrades to score gear against your character or your PoB builds.
- Ascendancy Roulette if you haven't picked a class yet.