Setup, features, and troubleshooting

NoddPilot Wiki

Start here for setup, combat tuning, radar and loot, survival, input options, or figuring out why something is not behaving the way you expected.

Setup

Start here

Getting started

Install it, attach to your PoE2 process, pick your build, and start. These are the settings worth checking before the first run.

Create accountVerify the email
Download launcherFrom your account page
Attach to PoE2Logged into a character
Press STARTAfter checking your build and keys

Account and access

Create an account on the website and verify the email. Your account page shows your current access, downloads, and whatever plans are available right now.

The website and Windows app use the same email and password.
Verify your email before checkout. The account page will tell you if anything is still required.
Current access, prices, and payment options are always shown on the account page.

Download the launcher

Download the launcher from your account page and sign in. It starts NoddPilot and gets the current client build for you.

There is no license key to paste. Signing in activates the machine for your account.
NoddPilot client updates are handled in-app and may be required before the app can be used.
The launcher itself does not self-update. If a newer launcher is required, NoddPilot shows a banner with a link back to the website for a fresh copy.

Attach to the game

Launch Path of Exile 2, log into a character, then open NoddPilot. Pick the game process in the top bar and use Refresh if it is not listed yet.

The attach chip in the header turns green when NoddPilot has a live game process.
Before pressing START, choose the input device, combat routine, and movement mode you actually intend to use.
The default input path expects PoE2 to stay focused. The optional background-input mode is a separate, higher-risk setting covered below.
Set your flask keys, dodge key, and town-portal key before relying on survival or map-exit automation.

Know these

Hotkeys

The shortcuts you are most likely to use while the game is running.

Core controls

You should be able to stop or hide NoddPilot without hunting for its window. These are the important in-game controls.

F8: master Auto-Pilot toggle. The master key can be rebound in the app.
F7: Boss Mode. Enables flasks and combat, targets Unique enemies only, expands the chase range, runs the combat loop faster, and pauses Explore until you turn it off. Your Fast reflex dodge setting is still respected.
F9: emergency logout. Use it when you want the character disconnected immediately.
TAB: show or hide the in-game radar overlay.
Hold ESC: abort active input while you hold it. It also releases held combat input.

TAB is reserved while attached

While NoddPilot owns the overlay hotkey, PoE2 will not receive that TAB press. That is expected.

If you use TAB for a PoE2 action, move that game bind somewhere else while NoddPilot is attached.
The key returns to normal after NoddPilot closes or detaches.

If a hotkey does nothing

Another program can claim the same global key first. Use the matching control in the app, or rebind the master toggle.

START/STOP and the overlay toggle are both available from the Auto-Pilot dashboard.
Emergency logout is intentionally a keyboard-first action so it is available when the mouse is busy.

Main loop

Auto-Pilot

The main run loop. It coordinates survival, combat, looting, and movement so the subsystems do not fight over the same inputs.

Stay aliveFlasks and emergency rules stay live
FightCombat gets first claim on movement
LootOnly after safety gates pass
ExplorePush into uncleared terrain

What gets priority

Auto-Pilot is not four macros running at once. One loop decides what owns the character at any moment.

Survival checks keep running while the rest of the bot is fighting, looting, or moving.
Combat takes control when a valid threat needs attention.
Loot waits for your pickup safety gates to pass.
Exploration fills the quiet time and gives way as soon as combat or loot needs the character.

Reading the dashboard

The Auto-Pilot page is the best place to watch a new setup. It shows the active build and movement mode, subsystem status, current activity, session totals, and health checks in one view.

Each system card has its own enable switch, so START does not force every feature on.
The Current Activity card shows what the bot is doing now, what it is acting on, and what comes next.
System Health in the left rail shows whether the game reads NoddPilot depends on are healthy. Use Recheck after a patch or if behavior suddenly looks wrong.
The Report button in the top bar saves a support report with your setup and health checks to the logs folder.

Exploration and map completion

Explore works from the terrain model and cleared-area history, pushing toward ground that still needs to be covered instead of wandering randomly.

The radar shows explored and reachable terrain so you can see why the route is going where it is going.
Pause in hideout/town prevents movement where there is nothing useful to automate.
Walk to zone exits when clear can take the character toward an area transition. With WASD movement, NoddPilot can currently reach the exit but may not take the transition automatically.
Portal out when the map is finished can leave on completed objectives or wait for the full map. It will not leave while a boss is alive or an altar still needs confirmation.
Full-map mode also waits for high map coverage before leaving.

The Auto-Pilot dashboard shows the active setup, subsystem state, current activity, session totals, and health checks.

Fight loop

Combat

Target selection, movement, dodging, and a live-editable skill rotation. You can hand it the whole fight or keep movement for yourself.

Pick a targetRarity, range, and priority rules
Get in rangeClick, MoveOnly, or WASD
Run the routineCards cycle in order
Re-evaluateFight, loot, or move on

Full auto or combat-only

Full auto handles targeting, movement, dodging, and skill use. Combat-only leaves movement and dodging to you while NoddPilot aims and fires the rotation.

Engage rarities decide whether Normal, Magic, Rare, and Unique enemies are valid targets.
Leash range limits how far combat will chase.
Priority bias lets you lean toward dangerous targets or simply the closest target.
Combat-only is useful when you want to drive the character yourself but still want automated aiming and rotation timing.

Cursor ring and hands-off-mouse input

Combat-only has an optional cursor ring for manual target selection, and combat can also send clicks without dragging your real cursor around the desktop.

Only attack what my cursor is on draws a configurable ring around your last manual mouse position and limits combat to enemies inside it.
Hands off my mouse sends combat clicks to the game without moving your visible cursor. Keyboard movement and skill keys still use the normal focused-game path.
Also work when the game is not the active window is a separate opt-in mode. It can keep combat running in the background, switches movement to click-to-move, and briefly writes to game memory while acting.
Background input is a higher-risk mode than the default read-only automation path. Leave it off unless you specifically need it and accept that tradeoff.

Routine Builder

A routine is an ordered list of skill cards. The bot works through the cards in order and saves changes into the running combat loop immediately.

Each card has an input binding, name, Tap/Hold mode, optional hold time, cooldown, minimum-enemy count, its own range, and a once-per-enemy rule.
Hold with a time is useful for charge-and-release skills. Hold at 0 keeps a channel held while the target stays in range.
Drag the handle or use the arrow buttons to reorder the cast cycle.
Detect from game reads equipped skills and key binds into the routine. Any bind it cannot match is left for you to fill in.
You can create, duplicate, delete, and switch routines without restarting the app.

Movement modes

Combat supports three movement styles. Pick the one that matches your PoE2 input setup and the way you want the character controlled.

ClickToMove: clicks the ground directly.
MoveOnly: holds your PoE2 Move Only bind while clicking so movement clicks cannot fire a skill by mistake.
WASD: holds W/A/S/D toward the target. PoE2 keyboard movement must be enabled, and ESP32 users need current firmware.
Sprint re-press gap prevents rapid spacebar re-presses from turning a sprint refresh into an accidental dodge roll.

Dodging

Dodging reacts to nearby monster attacks rather than rolling on a blind timer. You control how close a threat must be and how often another roll is allowed.

Bind the same dodge key you use in PoE2. Clear the bind if you do not want combat to roll at all.
Danger radius decides how close a threatening attack must be before it is worth dodging.
Roll cooldown limits repeat rolls so the bot does not spend the fight permanently evading.
Fast reflex dodge is a single optional toggle that reacts to dangerous boss and rare attacks on a faster path than the normal combat loop.

Entity blacklist

If a prop, object, or special entity looks attackable to the game but cannot actually be killed, blacklist it.

Pick from nearby entities or type part of the name. Matching is case-insensitive.
Blacklisted entities are ignored by targeting, movement decisions, and dodge threat checks.

The dashboard keeps combat and the supporting systems visible while the run is active.

See the run

Radar and overlay

The live view of terrain, monsters, loot, POIs, combat telemetry, and the route NoddPilot is using.

Why distant monsters are missing

PoE2 only keeps nearby entities loaded. NoddPilot can show the full terrain model, but a monster outside the game's streamed entity bubble does not exist in memory yet.

Terrain and explored-area data cover much more of the zone than live monster entities.
Monsters, NPCs, and other streamed entities appear as the game loads them while you move.
The map view calls this out directly so an empty distant area is not mistaken for a broken radar.

Map layers

The Radar page is heavily filterable. Turn off whatever you do not need and keep the overlay readable for your build.

Monster filters: Normal, Magic, Rare, Unique, plus a quick Hide Normal button.
World layers: chests, NPCs, waypoints, exits, shrines, league objects, and other entities.
POI markers add stronger styling for waystones, checkpoints, and exits.
Quest markers surface the game's own discovered quest markers.
Iso mode aligns the overlay with the game's isometric camera. A legacy top-down preview is still available.

Combat Intel

Combat Intel puts monster action telemetry directly in the overlay so you can see what nearby enemies are doing, not just where they are.

Combat Intel shows nearby action state and compact cast bars.
Danger pulse highlights monsters that are actively casting or winding up an attack.
Safe lanes show the escape-lane fan and the route combat has committed to when it needs to kite or flee.
Range ring shows the current combat reach around the player.
Intel debug exposes raw telemetry for troubleshooting and is not meant as the everyday view.

Loot, prices, and alerts

Ground drops can be shown on the radar and over the actual item in the world, with value filtering and alerts.

Loot pips are colored and sized by item class/value, with optional price labels.
Price data comes from an offline snapshot bundled with the app, so normal mapping does not depend on a live pricing request.
Minimum value hides cheap priced drops while unpriced items remain visible.
Drop alerts can fire a toast and optional sound. Separate alerts can warn when a Unique/league object appears or when a Rare/Unique comes close.
Save loot log writes the session's valuable drops to CSV and JSON under Documents\NoddPilot\loot-logs.

World overlays and diagnostics

Several layers are drawn over the game world rather than only inside the radar panel.

Health bars and optional nameplates track living monsters in place.
Reachability colors terrain the bot can path to and terrain that is walkable but cut off from the player.
Zone banners, POI styling, safe lanes, range rings, and loot labels can all be toggled separately.

GPU overlay

The GPU overlay is the faster rendering path and is where the glow/bloom effects live. The standard overlay remains available as a fallback.

The GPU path targets a synced 60 fps overlay.
Glow FX and bloom intensity apply to the GPU renderer.
If the GPU path renders badly on a particular machine, turn it off and use the standard overlay.

RADAR · live overlay

YouNormal monsterRare / uniqueElite threatPlanned route

The in-game radar keeps terrain, loaded monsters, loot, and the current route in one view.

Items

Loot pickup and stash sorting

Pick up the drops you actually want, then route the backpack into your stash without hand-clicking every item.

Drop appearsTier and value rules decide if it matters
Safety checkDanger and inventory gates
Pick it upWalk and click
Sort laterCalibrated stash tabs

Auto-Pickup

Auto-Pickup walks to matching ground items and clicks them when the safety checks allow it.

Tier switches cover Unique, Currency, Rare, Gem, High base, and Normal items.
Min value filters priced drops in exalted value. Set it to 0 if you do not want a value floor.
Unpriced drops are allowed through the value filter so missing price data does not automatically hide a useful base.
The live panel shows matching drops and backpack space while the system is running.

Pickup safety

Looting only matters if the character survives the click. The pickup page has its own guard rails.

Stop when inventory full prevents pointless pickup clicks.
Pause when a Rare/Unique is nearby holds looting until the danger radius clears.
Pause in hideout/town keeps the system quiet outside maps.
The click-debug overlay shows the player, item, target click, and screen center if pickup aim needs troubleshooting.

Stash sorting

Open your stash, scan the backpack, and NoddPilot can route items into the tabs you calibrated.

Calibrate the backpack grid once for your resolution/UI scale.
Capture each stash tab you want the sorter to use by name.
The optional tab-strip capture lets Load all tabs click through a whole stash column before export.
Dry Run shows the plan before any item is moved.
Captured stash tabs reset on logout because layouts can differ by character or league.

Stay alive

Flasks and survival

Threshold flasking, dodge support, emergency logout, auto-refill, and optional revive handling.

Watch vitalsHP, MP, and ES
FlaskNormal threshold or critical floor
Bail outAuto-logout or F9
RecoverRefill or revive when configured

Auto-Flask

Auto-Flask watches live HP, MP, and energy shield and presses the configured flask when a rule crosses its threshold.

HP and MP have independent thresholds and flask keys.
ES threshold can use the life-flask rule for ES/CI setups. Set it to 0 to disable that rule.
Critical HP floor bypasses the normal randomized cooldown and dumps the life flask immediately when HP gets dangerously low.
Normal flask presses use a min/max cooldown window instead of the exact same interval every time.

Emergency logout

Auto-logout is the last survival gate when flasking is not enough. It can trigger at a configured HP level, and the manual F9 hotkey is always available.

Emergency auto-logout can be enabled or disabled independently of normal flasking.
The current trigger also accounts for sudden burst damage so a fast drop can bail out before the normal threshold loop catches up.
F9 performs the manual emergency disconnect from inside the game.

Town refill

When the life flask runs dry, NoddPilot can portal to town, use the well, and return through the portal to the same map.

Bind a town-portal key in PoE2 first, then enter the same key in NoddPilot.
The refill trip waits for a safe moment and aborts rather than forcing through a dangerous or timed-out state.
Your explored map state is kept while the refill trip runs.

Auto-revive

Softcore users can let NoddPilot click Resurrect at Checkpoint and continue after a death.

The revive position is stored as X/Y percentages of the game window because UI scale and resolution move the button.
Calibrate it once by watching a death and nudging the click point until it lands cleanly.
Turn the feature off if you want death handling left entirely to you.

Input and risk

Input, ESP32, and game tweaks

Windows input works out of the box. ESP32 is optional, and the memory-writing features are clearly separated behind their own opt-ins.

Pick inputWindows or ESP32
Flash if neededESP32 firmware lives in Settings
Optional isolationSeparate Windows account
Opt in carefullyBackground input and Game Tweaks write memory

Windows input vs. ESP32

You do not need extra hardware. NoddPilot can use Windows input immediately, or an ESP32-S3 can act as a physical USB keyboard/mouse for the same automation.

The Auto-Pilot page shows the live input backend and lets you choose it.
A responding ESP32 appears with its COM port. If it disappears, Windows input remains available.
ESP32 changes how input reaches the game. It does not make automation safe from enforcement or policy risk.

Flash the ESP32

Settings includes a firmware flasher for the Seeed XIAO ESP32-S3 and compatible ESP32-S3 boards with native USB.

Plug the board in, choose its COM port, and click Flash.
If auto-reset does not enter flash mode, hold BOOT and tap RESET, then try again.
Reflash when release notes call out a firmware change, especially if you use WASD movement.

Optional isolated game account

Settings can create a separate locked-down Windows account for running PoE2 with less access to the NoddPilot folder.

Setup creates the standard Windows account and applies folder permissions with a UAC prompt.
Launch game isolated starts PoE2 under that account. NoddPilot then needs to be restarted as admin to attach across the account boundary.
Remove reverses the setup.
This is an isolation measure, not a promise of invisibility or account safety.

Game Tweaks are different

Unlock zoom, Extended sight, and Reveal minimap are optional client tweaks in Settings. Unlike the normal automation path, these features write to the running game.

All Game Tweaks are off until you acknowledge the warning and enable them.
Unlock zoom removes the normal camera zoom-out limit.
Extended sight widens the player-light reveal radius.
Reveal minimap uncovers area terrain while leaving markers governed by the game.
Closing NoddPilot restores the game-side values it changed.

RecommendedTreat Game Tweaks and background input as a higher-risk category. The normal automation path can stay read-only, but these opt-in features cannot.

Account and support

Account, updates, and Discord

Where access is managed, how updates behave, and what to send support when something goes wrong.

Plans and checkout

Plans, prices, seat availability, and payment options can change. The account page always shows what is available right now.

The storefront supports short-term access, a monthly subscription, and lifetime access when those options are enabled.
Monthly availability can be capped, so the account page may show no open seats.
Email verification is required before checkout.
For prices and payment methods, use the account page rather than an old screenshot or forum post.

Connecting Discord

Connect Discord from the account page after signing in. The site handles the link and access-role sync.

Active access grants the Subscriber role and its private channels.
Role state follows account access automatically.
Disconnecting removes the account link without deleting either account.

App updates and launcher updates

Client and launcher updates are handled differently, which is worth knowing before a patch day.

A required NoddPilot client update blocks the app until you install it, then restarts into the new build.
The launcher cannot update itself. When a new launcher is required, use the in-app banner to open the website and download it again.
After a PoE2 patch, NoddPilot may lock automation until that exact game build has been verified. It unlocks after the verified build data is published.

Logs, reports, and privacy

Settings has the version, account state, machine ID, logs folder, settings folder, crash-report toggle, and ESP32 flasher.

Open logs folder is the first place to go when support asks for a session log.
The top-bar Report button saves a diagnostic report containing setup, rotation, keybind, and health-check information. It does not include account credentials or game data.
Anonymous crash reporting can be disabled in Settings.
The machine ID identifies the licensed PC and may be useful during account support.

Fixes

Troubleshooting

Check attachment, health, and safety gates before rebuilding a routine or assuming the game patch broke everything.

Attached?Correct process, green chip
Healthy?System Health and build lock
Enabled?Master plus per-system toggles
Still broken?Report + logs + Discord

START is on but nothing moves

Start with the state the app already exposes. Most dead-looking sessions are an attach, focus, health, or enable-state problem.

Confirm the attach chip is green and the correct PoE2 process is selected.
Check the individual system switches. START does not override a subsystem you deliberately disabled.
If you use the normal input path, keep PoE2 focused. Only the separate background-input option is designed to work while another window is active.
Check System Health for a red or blocked area, then press Recheck.
Town/hideout pauses and nearby-danger gates can intentionally stop movement or looting.

The app says PoE2 updated

NoddPilot has a build lock for game patches. If the running PoE2 build has not been verified yet, automation is blocked on purpose.

Do not try to tune around a build lock. The app is refusing to act because its game reads may no longer be trustworthy.
The lock clears after the new build has been verified and published.
Use the Discord link in the lock screen for patch status if you need an update.

Radar looks empty or wrong

First decide whether the missing thing is terrain or a streamed entity. Those come from different data.

Distant monsters may not be loaded yet. Move closer and see whether they enter the entity bubble.
If the entire overlay is missing, toggle it from the dashboard or press TAB.
Use Reachability when a monster is visible but combat refuses to path to it.
After a game patch, check System Health before assuming a filter is wrong.

Combat behaves badly

Look at the routine, target filters, and movement state before changing global settings.

Attacking a prop or unkillable object: add it to the entity blacklist.
Ignoring packs: check Engage rarities, leash range, and Reachability.
Skill missing or firing at the wrong time: inspect that card's binding, range, cooldown, Tap/Hold state, and conditions.
Accidental dodge rolls while moving: raise Sprint re-press gap.
Too much dodging: lower Danger radius, raise Roll cooldown, or turn off Fast reflex dodge.

Send a useful report

The fastest support ticket is one that includes the session where the problem actually happened.

Click Report in the top bar or open Settings and use Open logs folder.
Include what you expected, what happened instead, and roughly when it happened.
If the problem is repeatable, say which routine, movement mode, and input backend were active.
Use Discord for the report so support can ask for the exact follow-up data it needs.

Terms

Glossary

A few terms used throughout the app.

Around the app

Terms from the dashboard and runtime state.

Auto-Pilot: the shared loop coordinating survival, combat, pickup, and exploration.
Routine: the combat script made from ordered skill cards.
System Health: the current read/offset checks for the game data each subsystem needs.
Build lock: the full automation lock shown when the running PoE2 build has not been verified yet.
Input backend: Windows input or a responding ESP32 HID bridge.

Combat

Terms from the Combat page.

Combat-only: NoddPilot aims and fires while you keep control of movement and dodging.
Cursor ring: the manual target area around your last real mouse position.
Leash range: the maximum chase distance for a target.
Priority bias: the balance between target danger/rarity and simple distance.
Fast reflex dodge: the optional faster reaction path for dangerous boss and rare attacks.

Map and movement

Terms used by the radar and exploration system.

Entity bubble: the nearby region where PoE2 currently has live entities loaded.
Reachable: terrain NoddPilot can currently path to from the player's connected walkable region.
Frontier: the edge between cleared and uncleared terrain that exploration can push toward.
Iso mode: the game-aligned isometric radar view.
Full-map exit: the portal-out mode that waits for boss/altar checks and high map coverage instead of leaving as soon as objectives are complete.

Read this

Safety notice

Automation can put the account at risk. NoddPilot's default automation path is read-only, but some optional features deliberately move into a higher-risk memory-writing category.

Know which mode you are using

Automating gameplay may violate the game's Terms of Service, and enforcement is outside our control. No input method or isolation setup can promise a safe account.

The normal automation path reads game state and controls the character through Windows input or optional ESP32 HID input.
Background input and Game Tweaks are explicit opt-ins that write to the running game. They are a different, higher-risk category.
ESP32 and the isolated Windows-account setup can reduce parts of the software footprint, but neither makes automation policy-compliant or undetectable.
Test a new routine while you are present before leaving it to run. Bad ranges, keys, movement settings, or revive coordinates can still kill a character even when the software is functioning correctly.
Do not use an account you are unwilling to lose.

After a PoE2 patch: NoddPilot may lock automation until the new game build has been verified. If you see that lock, do not retune your routine around it. Check the patch status and let the build verification finish first.