Help

Frequently asked questions

Common questions about Exile Compass. If your question is not here, ask in the Discord.

General

Is Exile Compass a PoE2 overlay or a PoE1 overlay?

Both. A switch in the title bar picks which game the overlay targets. Path of Exile 2 gets the full tool set: campaign quest tracker, permanent-reward checklist, stash regex builder, speedrun timer, crafting guides, and Path of Building import. Path of Exile 1 gets a leveling guide with an auto-progress "you are here" marker, gem-reward tracking, a passive-tree viewer, a regex builder, and the Act-Decoder zone-layout window. The timer, voice commands, add-ons and themes work in both games.

Is Exile Compass free?

Yes. Exile Compass is free and open source for Windows and Linux. There are no paid tiers. You do not need an account to use the overlay. That will not change.

Is Exile Compass safe to use? Is it actually open source?

Yes. All the code is public at github.com/juddisjudd/exilecompass. GitHub Actions builds each release from that source, so the download always matches the repo. The app only reads your local Client.txt log file and the game window's title and position, which it needs to place the overlay. It never reads or writes game memory.

Does using Exile Compass risk a ban? Does it break Path of Exile's Terms of Service?

Exile Compass only reads your local log file and the game window's title and position, and draws its own window on top of the game. It never reads or writes game memory. The only thing it does to the game window is focus it. It never sends clicks, key presses, or any other input. Exile Compass is not affiliated with, reviewed by, or endorsed by Grinding Gear Games. GGG's own rules on third-party tools are the final word, not this page.

Windows Defender or SmartScreen flagged the installer or exe. Is that a real threat?

No, it is a false positive. The Windows build is not code-signed yet. An unsigned app that updates itself and reads the game window's title looks, to antivirus heuristics, like a lot of real malware. New releases with few downloads get flagged most. You have two options. Report it to Microsoft as a false positive and pick "Software developer" as the submission type; once reviewed, this fixes it for everyone within a day or two. Or, after installing, run this exclusion script from the repo (right-click it, then Run with PowerShell as Administrator) to exclude only Exile Compass's install folder. The script is short. Read it before you run it, as with any script that runs as administrator.

Reward tracking or the leveling guide's auto-progress marker isn't doing anything. What do I need to set up?

Those features need your Client.txt log file. Go to Settings → Log File → Auto Detect, or use Browse if Auto Detect cannot find it. The log file path is saved separately for each game. If you set it in Path of Exile 2, you need to set it again after switching to Path of Exile 1, and the other way round. Once set, Path of Exile 2 uses it to check off Passive Boosts rewards as you earn them and to move the campaign guide's auto-progress marker. Path of Exile 1 uses it for the leveling guide's auto-progress marker. Both games use it for campaign timer splits.

Do voice commands record me or send audio anywhere?

No. Voice commands run fully offline. A bundled speech model listens for a fixed list of phrases that all start with "compass", so ordinary speech does not trigger anything. Nothing is recorded or uploaded. Voice replies use your system voice by default. If you add your own ElevenLabs key for a higher-quality voice, only the reply text goes to ElevenLabs, and the key is stored in your OS keychain.

Where does the campaign, crafting and build data come from? Can I contribute?

Campaign steps, permanent rewards, and crafting guides are community-authored. To submit a crafting guide or fix an error, see the Contributing section on GitHub.

Something's broken, or I have a feature idea. Where do I report it?

Open an issue on GitHub, or post it in the Discord.

Path of Exile 2

Why isn't Passive Boosts (Rewards) checking off things I already collected on this character?

Automatic reward tracking only reacts to new log events after you set it up. It does not scan your log for rewards you collected earlier on this character, and it cannot check off rewards from a previous character. Tick those off by hand, or clear tracking in Settings to start fresh.

Path of Exile 1

The PoE1 leveling guide's auto-progress marker doesn't match where I actually am. What's going on?

Auto-progress watches your log file for new zone entries. Revisiting a zone you already generated adds no new log line, so the marker looks up to 20 steps ahead in the route for a match, not only the next step. Town portals cause most desyncs. If you portal out and return a different way than the guide expects, the next zone you enter can match a later step, and the marker jumps ahead of you. Click any step that shows a position marker to move 'you are here' back to where you are. This only moves the marker. Your checked-off steps and gem progress do not change, and auto-progress carries on from there. If this happens often on your route, turn auto-progress off with the checkbox in the guide header and move the marker by hand.

Does auto-progress automatically check off leveling steps for me?

No. Auto-progress only moves the 'you are here' marker. It never checks off a step or a gem reward. This is deliberate: the marker can jump ahead of you (see the question above), so checking off steps from the same signal could mark work you have not done as complete. You always check off steps and gems by hand.

Credits

ExileCompass builds on data and code from these community projects: