wiki_en

← Home

---

POEFixer Wiki

Welcome to the POEFixer documentation. Below is a breakdown of the program's functionality, organized by interface tabs.

---

1. Status

The Status tab shows your license and connection information, and handles application updates.

License & Connection

• Connection Status: Displays whether you are connected to the POEFixer server (green = connected, red = disconnected).
• License Info: Shows your current license tier and expiration date.
• Version: Displays the current application version.

Updates

When a new version is available, the Status tab notifies you with version details and a changelog.

• [Download Update] — Downloads the update file with a progress bar showing percentage, speed, and ETA.
• [Apply Update] — After download completes, applies the update. The file is verified via SHA256 hash before applying to ensure integrity.
• [Open Folder] — Opens the folder containing the downloaded update file.
• Mandatory Updates: If your version is below the minimum required, the application will prompt you to update before you can continue.

Server Messages

The server can send important announcements (maintenance, warnings, etc.) which appear as a modal dialog with a title, message, and dismiss button.

2. Trade Cookies

Trade requests go out over the tls-client library using the user-supplied POESESSID and cf_clearance cookies. Set them in Configuration → Settings → Trade Cookies — see Trade-Cookies for the step-by-step. Or switch to the Trade-Bridge: a free browser extension does all trade-site work (no cookies needed) and POEFixer only buys in-game — you can also build your own extension against its documented API.

---

3. Trade

The Trade tab is the command center for real-time market monitoring. It utilizes the official Path of Exile WebSocket API to receive instant notifications about new item listings that match your search criteria.

Interface Overview

The main view displays a list of all your active trade search connections.

Connection List Columns

1. Status:
   • Green: Connected and listening for new items.
   • Orange: Connecting...
   • Red: Disconnected.
   • Rate Limit: If you are rate-limited by the API, a countdown timer will appear here showing when you can reconnect.
2. Name: The name of your search (e.g., "Headhunter").
   • Click: Opens the search URL in your default web browser.
   • Tooltip: Hover to see the full URL.
3. Statistics:
   • Handshake Icon: Number of items found in this session.
   • Check Icon: Number of successful whisper messages sent.
   • X Icon: Number of failed whisper attempts.
   • Bolt Icon: Spend limit usage percentage (color-coded: green < 75%, yellow >= 75%, red >= 100%).
4. Actions:
   • Play/Stop Button: Manually start or stop the live search for this specific connection.
   • Shopping Cart: Opens the Manual Buy menu to bulk purchase items from this search.
   • Pen (Edit): Update the Name or URL of the connection.
   • Gear (Settings): Opens the detailed Settings & Logs window for this connection.
   • Clipboard (Logs): Opens trade logs for this specific connection.
   • Trash (Delete): Permanently remove this search connection.

Trade Modes

The system supports two modes of buying items:

Active Live Search

Real-time WebSocket notifications from the trade site. When an item matching your filters is listed, the system automatically:

1. Sends a whisper message to the seller.
2. Navigates to the seller's hideout (Memory Scanner mode).
3. Accepts the trade when the trade UI appears.
4. Verifies the item was received via inventory snapshot comparison.

Manual Buy

User-triggered bulk purchase from a search URL. Click the Shopping Cart icon on any connection to:

• Buy N Items — Purchase a specific number of items.
• Buy All — Purchase all available items from the search results.

Note: Active Live Search and Manual Buy are mutually exclusive — you cannot run both simultaneously on the same connection. If you try, a warning modal will explain the conflict.

In Browser extension mode the Manual Buy runs through the extension (same item count, filters, spend limits, auto-stash) — see Trade-Bridge.

Global Controls

At the bottom of the tab, you will find global controls:

• Connect All: Sequentially connects to all enabled searches. It adds a small delay between connections to prevent triggering API rate limits.
• Disconnect All: Immediately stops all active searches.
• Add Link: Manually add a trade search URL if you prefer not to use the Login tab browser.
• All Trade Logs: Opens a modal showing trade history across all connections.

Auto-Stash (Memory Scanner Mode Only)

When the Memory Scanner is enabled, the trade system supports automatic inventory management during trading.

• Enable Auto-Stash: Checkbox to turn on automatic stash deposit during trade flows.
• Inventory Threshold: When your inventory fullness exceeds this percentage (10-80%), the system will automatically teleport to your hideout and deposit items into the stash before continuing purchases.
• Protected Slots: You can mark specific inventory slots as protected — items in these slots will never be moved to the stash.

How Auto-Stash Works

1. Before each purchase, the system takes an inventory snapshot and checks fullness.
2. If fullness exceeds the threshold, the system teleports to your hideout.
3. It walks to the stash, opens it, and Ctrl+Clicks all non-protected items into the stash.
4. After the stash dump completes, it returns to trading.

Auto-Stash Settings (in Settings tab)

Setting	Range	Default	Description
Stash Inventory Threshold	10-80%	50%	Fullness % that triggers stash dump
Stash Click Retries	1-20	5	Max attempts to open stash entity
Item Transfer Max Clicks	5-200	145	Max Ctrl+Click attempts before aborting
Item Transfer Delay	30-1000ms	100ms	Delay after each Ctrl+Click
Stash Open Verify Delay	50-2000ms	200ms	Delay after clicking stash entity
Movement Key	Virtual key	T (0x54)	Key used for walking to stash
Walk Cursor Distance	100-800px	400px	Pixels ahead of player for walk cursor
Protected Inventory Slots	12x5 bitmask	0	Bit-per-slot protection mask

Safety: A stop hotkey immediately halts all stash operations. Input blocking is always safely released. Every Ctrl+Click verifies the stash UI is still open.

Connection Settings & Logs

Clicking the Gear icon on any connection opens a detailed modal window.

1. General Settings

• Auto Reconnect: If enabled, the tool will automatically try to reconnect if the connection drops.
• Enable Notification: Shows a popup notification overlay in-game when a new item is found.
• Multi-Item Whisper Delay: Adds a configurable delay (in milliseconds) between whisper messages. This is crucial for high-volume searches to avoid being flagged for spamming.

2. Currency Filters

Filter incoming notifications based on the listing price. This allows you to ignore listings that are too cheap or too expensive without changing the website filters.

• PoE 1 / PoE 2 Support: The list of currencies automatically adjusts based on the selected game mode.
• Min/Max: Set minimum and maximum quantities for specific currencies (e.g., only notify for items listed between 100 and 150 Chaos Orbs).

3. Trade Logs

On the right side of the settings window, you can see a history of items found by this specific search.

• Item Card: Displays the item icon, name, and listed price.
• Seller Info: Shows the player name and how long ago the item was listed.
• Mods: Lists the explicit modifiers of the item.
• Status Indicators:
  • Travel: Indicates if the seller's hideout was successfully visited.
  • Buy: Indicates if the trade message was successfully copied/sent.
• Filtering: Filter by status (Pending, Success, Failed), date range, search URL, or text search.
• Statistics: Per-day, per-search-URL, and per-session statistics are available.

---

4. Spend Limit

The Spend Limit tab lets you set currency spending caps for your trade searches. This prevents overspending by automatically stopping purchases when your defined limits are reached.

Overview

Spend limits are rule-based: you define how much of a specific currency you're willing to spend, and the system tracks your progress in real-time. Rules can apply to all trade connections or to specific ones.

Creating a Rule

Click the green [+ Add Limit] button to open the rule creation dialog:

1. Currency: Select from 8 supported currencies — Divine Orb, Exalted Orb, Chaos Orb, Regal Orb, Vaal Orb, Orb of Alchemy, Orb of Annulment, Mirror of Kalandra.
2. Limit Amount: Set the maximum quantity you want to spend.
3. Link Selection: Choose which trade connections this rule applies to:
   • Select none = applies to all connections (global rule).
   • Select specific connections = applies only to those.
4. Click [Save] to activate the rule.

Rules Table

The main interface shows all your rules in a table with 6 columns:

Column	Description
Enable	Checkbox to toggle the rule on/off without deleting it
Currency	Icon and name of the currency being tracked
Limit	Maximum amount allowed
Progress	Visual progress bar + "spent / limit (percentage%)" text. Colors: green (< 75%), yellow (>= 75%), red (>= 100%). Shows a REACHED badge when the limit is hit
Applied To	Shows "All Links" or pill-shaped badges for specific connections
Actions	Edit (pencil), Reset counter (rotate), Delete (trash) buttons

How It Works

• The system tracks every currency spent through both Active Live Search and Manual Buy trade flows.
• When a rule's limit is reached and the rule is enabled, further purchases using that currency are blocked.
• Rules use independent tracking per currency — you can have separate limits for Divine Orbs and Chaos Orbs simultaneously.
• Disabled rules are visually dimmed (45% opacity) and do not enforce limits.

Summary Panel

Below the rules table, a card-based summary shows aggregated spending per connection:

• One card per connection plus a "Global" card.
• Each card shows total spending broken down by currency with icons.

Controls

• [+ Add Limit] — Create a new rule.
• [Reset All] — Reset all spending counters to zero (rules remain).
• Per-rule [Reset] — Reset only that rule's counter.

---

5. Settings

The Settings tab is the control center for configuring the application's global behavior, game integration, and user interface preferences.

Game Selection

• Path of Exile 2 / Path of Exile 1: Select the game mode you are currently playing. This adjusts the trade search URLs, window detection logic, and scanner compatibility.
• League: Choose your current league (e.g., Standard, Hardcore, or temporary leagues) from the dropdown menu to ensure trade searches target the correct economy.

Note: Game Client, League, Trade Cookies, and Scan Method settings are locked while trade connections or bots are actively running. You will see a modal explaining which connections need to be disconnected before you can change these settings. Disconnect first, then change the setting.

Manual Process Selection

When you have multiple game instances running, this lets you pick which one POE2Fixer attaches to.

• Manual process selection (checkbox): Toggle on to enable manual selection. The current attachment is preserved until you pick a specific process.
• Process dropdown: Lists running game processes by <name>.exe (PID: NNNNN). Selecting a different process closes any active trade operations and reattaches.
• Refresh button (↻): Re-enumerates running processes — click after launching/closing a game instance.
• Auto-clear: If the selected process closes, the checkbox automatically unchecks and POE2Fixer falls back to its default auto-attach behavior.

The selection is session-only — every restart starts in automatic mode.

Scanner Type

Choose how the application reads data from the game client.

• WGC (Windows Graphics Capture):
  • Description: Captures the game window visually even when it's in the background. Recommended for PoE 1 or if Memory Scanner is unavailable.
  • Corner Density: Adjusts the threshold for frame analysis (advanced setting).
  • Use Full Window: When enabled, scans the entire game window. If disabled, you can manually define a specific screen area to scan (useful for ultrawide monitors or specific setups).
  • Select Area: Interactive tool to draw the scanning rectangle on your screen.
• Memory Scanner (PoE 2 Only):
  • Description: Directly reads game memory to identify items and entities. This is generally faster and more accurate for PoE 2 but requires the game to be in a compatible state.

Trade Cookies

Trade requests go out over the tls-client library using the user-supplied POESESSID and cf_clearance cookies. See Trade-Cookies for the step-by-step on how to obtain and paste them.

• POESESSID: Your logged-in pathofexile.com session token. Click 📋 Paste to set.
• cf_clearance: Cloudflare anti-bot clearance cookie. Click 📋 Paste to set.
• Both values are stored DPAPI-encrypted in Configs/general/cookies.dat (machine-bound).
• The masked display is uncopyable — use the reveal button to verify the values in-place.

Click Settings

Configure how the application interacts with the game mouse input, primarily for automated trading or inventory management.

• Enable Auto Click: Master switch to allow the application to perform mouse clicks.
• Click Count: Number of clicks to perform per action (if there is no currency in the inventory, the item may not be bought the first time).
• Click Interval: Delay (in milliseconds) between clicks.
• Scan Timeout: Maximum time (in seconds) the scanner will attempt to find an item before giving up.
• Hold Ctrl: Automatically holds the Ctrl key during clicks (useful for fast-moving items between inventory and stash).
• Return Cursor: Returns the mouse cursor to its original position after performing a click action.
• Block Input: Temporarily blocks user mouse input while the application is performing an automated action to prevent interference.
• Enable Rate Limit: Limits the frequency of actions to prevent flagging by game servers.
• Fast Trade: Optimizes settings for rapid trading interactions.
• Fast Mouse Click: Reduces the input delay for mouse down/up events.

Advanced

• Return to Hideout: Automatically attempts to type /hideout in chat after certain actions (if configured).
• Streamer Mode: Hides the application's overlay and windows from streaming software (like OBS) so viewers only see the game.

Prices

POEFixer keeps item prices up to date automatically — there is no manual "Reload prices" button. Price data is fetched in the background and refreshed periodically, so the NinjaPricer overlay and in-game price tags stay current. Item icons are downloaded once on first launch (into Resources/images/) and shown next to prices and on the RuneShape reward overlay. Underlying price data is sourced from poe2scout.

• Price league: Choose which league's economy the prices reflect. Auto (current league) follows the current softcore league; or pick a specific league — Runes of Aldur, HC Runes of Aldur, Standard, or Hardcore. The league currently live in-game is marked (current).
• Status line: Shows League: <name> | Loaded: <N> items once prices are ready, or Loading prices… while they are still being fetched.

Theme & Appearance

• Theme: Choose from 8 visual themes for the entire application:
  • Dark — Default dark theme with subtle contrast.
  • Light — Light theme for well-lit environments.
  • Blue — Dark theme with blue accent colors.
  • Midnight — Deep dark theme with minimal brightness.
  • Emerald — Dark theme with green accent colors.
  • Rose — Dark theme with pink/rose accent colors.
  • Nord — Dark theme inspired by the Nord color palette.
  • Sunset — Warm dark theme with orange/amber accents.
• Font Scale: Adjust the global text size (0.8x to 1.5x) for better readability on high-resolution displays.

Language & Interface

• Language: Switch the application's interface language (e.g., English, Russian, Korean, etc.). 11 languages are supported.
• All theme-related strings are localized across all supported languages.

---

6. AutoPot [PoE 2]

The AutoPot tab provides automated flask usage and utility features specifically for Path of Exile 2. It includes a comprehensive system for managing your character's Health (HP), Energy Shield (ES), and Mana (MP) through automated actions and visual overlays.

Key Features

1. Input Device & Driver Status

The system relies on a virtual controller to simulate input safely.

• ViGEmBus Driver: Checks if the required ViGEmBus driver is installed and provides a download link if missing.
• Controller Detection: Automatically detects physical controllers (Gamepad) and virtual controllers.
• Safety Warnings: Warns if you have bound gamepad keys but no controller is detected.

2. Vitals Overlay (HUD)

A customizable visual overlay that displays your current HP, ES, and MP on top of the game.

• Display Modes: Choose from 7 different styles:
  • Horizontal Bars (Classic look)
  • Vertical Bars (Compact side view)
  • Percent Text (Simple text readout)
  • Circles (Ring indicators)
  • Compact Blocks (Minimalist squares)
  • Minimal Dots (Unobtrusive dots)
  • Glass Panel (Transparent background)
• Customization:
  • Scale: Adjust the size of the overlay (0.5x to 3.0x).
  • Toggle Visibility: Independently show or hide HP, ES, and MP bars.
  • Numeric Values: Toggle between percentage and absolute numbers.
  • Draggable: When the menu is open, a "Drag Hint" appears, allowing you to move the overlay anywhere on the screen.

3. Automation Modes

Select the logic that best fits your character build:

• Life: Monitors HP only.
• Energy Shield (ES): Monitors ES only.
• Life + ES: Monitors both.
• Mind Over Matter (MOM): Monitors MP (often used for damage mitigation).
• MOM + Life: Monitors MP and HP.
• MOM + ES: Monitors MP and ES.
• All: Monitors HP, ES, and MP simultaneously.

4. Threshold Configuration

Precise control over when potions are used.

• Sliders: Set the percentage threshold (1-100%) for HP, ES, and MP. When values drop below this level, the corresponding key is triggered.
• Smart Visibility: Only sliders relevant to your selected Mode are shown to keep the UI clean.

5. Auto Disconnect (Chicken)

A safety feature to automatically log out or disconnect if your vitals drop to a critical level.

• Separate Triggers: Independent enable toggles and thresholds for HP, ES, and MP.
• Visual Indicators: Thresholds are visualized on the Vitals Overlay as dashed lines or markers, showing exactly when the disconnect will trigger.

6. Key Bindings & Delays

Configure which keys to press for each action.

• Key 1: Typically used for Health (HP) or Energy Shield (ES) depending on the selected mode.
• Key 2: Typically used for Mana (MP) or as a secondary flask trigger.
• Key 3: Dedicated key for Energy Shield (ES), available exclusively in "All" mode.
• Input Types: Supports both Keyboard keys and Gamepad buttons.
• Delays: Set a cooldown (in milliseconds) for each key to prevent spamming actions too quickly.

7. Radar [PoE 2]

An advanced visual assistant and map overlay system designed specifically for Path of Exile 2. It helps with navigation, entity tracking, and filtering.

Key Features

1. General Settings

Customize the core behavior of the radar.

• Draw Walkable Map: Toggles the visualization of the game's navigation mesh (walkable terrain). Useful for seeing valid paths in dark areas.
  • Color: Customize the color of the map overlay.
  • Border Thickness: Adjust the outline thickness of the map borders.
• Map Fix: Toggles a correction mode for map alignment issues.
• Visibility Logic:
  • Hide in Town/Hideout: Automatically disables the radar in safe zones to reduce clutter.
  • Hide in Background: Hides the overlay when the game window is not in focus (alt-tabbed).
  • Hide on Pause: Hides the overlay when the game is paused.
  • Hide Outside Network Bubble: Hides entities that are outside the server's update range to prevent "ghost" entities (stale data).
• Show Player Names: Toggles the display of names above players.

2. Icons

Customize the visual representation of entities on the radar.

• Groups: Entities are categorized into groups (Base, League, Breach, Delirium, Expedition, etc.).
• Customization: For each group, you can assign specific icons and adjust their size. This allows you to differentiate between a normal monster, a boss, or a specific league mechanic at a glance.

3. Path Finder

A powerful navigation tool that draws lines/paths to specific targets.

• Enable Path Finder: Toggles the path drawing system.
• Multicolor: Randomizes path colors for better distinction between multiple targets.
• Important POI: Toggles the display of "Points of Interest" (like Quest Objectives or Waypoints) with optional text backgrounds.
• Target Management:
  • Add Target: Manually add a target by name.
  • Add from Map: Enter an interactive mode to click on an object on the radar to add it as a target.
  • Add to Global/Area: Choose whether the target should be tracked in all areas (Global) or only the current zone (Area).
• Ignored Areas: You can disable the Path Finder in specific zones to avoid clutter.

4. Filters (Entity Management)

Fine-tune which entities are shown on the radar and how they are displayed.

• Add Nearby Entities: A dropdown list that scans the current memory for valid entities near the player (Monsters, Chests, NPCs, etc.). Select an entity and click "Add" to instantly create a filter for it.
• Manual Input: For advanced users, allows adding filters by manually typing the metadata path.
• Edit Mode: Click the "E" button next to any filter to open the detailed editor:
  • Name: Set a custom display name.
  • Color: Choose a custom text color.
  • Icon: Toggle icon display, choose a specific icon, and adjust its size.
  • Draw Path: Specific toggle for drawing a path to this entity (if Path Finder is enabled).
  • Ignore: Completely hide this entity from the radar.

8. Smoother

The Smoother tab is a comprehensive tool designed to optimize game performance and customize visual elements. It works by modifying the game's data files (.ggpk or similar) to disable or alter specific graphical features.

Key Features

Game Selection & Setup

• Game Version: Support for both Path of Exile 1 and Path of Exile 2.
• Path Configuration: You must specify the path to the game's Content.ggpk file (or Bundles2 directory for PoE 2). The tool includes a file browser and validation to ensure the correct path is selected.
• Backup System:
  • Create Backup: Automatically creates backups of original files before applying any patches.
  • Restore All: A single button to revert all changes and restore the game to its original state.
  • Clear Backup: Deletes stored backups and hashes (useful if you want to start fresh).
  • Game Updates: Automatically detects if the game has been updated and prompts you to create a new backup to prevent corruption.

Performance Patches

Toggle individual patches to disable specific graphical effects. This can significantly boost FPS on lower-end systems.

• Fog / Atlas Fog: Removes fog effects from maps and the Atlas.
• Shadows & Lights: Disables dynamic shadows and lighting calculations.
• Particles: Removes environmental particles (rain, dust) and general particle effects.
• Corpses: Prevents corpses from rendering (PoE 1 only).
• Delirium: Removes the visual fog and overlay associated with the Delirium league.
• EpkRemoval: Removes effect packages for cleaner visuals.
• Camera: Enables extended camera zoom limits (configurable via a slider).

Advanced Customization Tools

1. Color Mods

Customize the text colors of item modifiers and stats.

• Search & Add: Search for specific stats (e.g., "Physical Damage") and assign them a custom color.
• Presets: Includes default presets for dangerous mods (Reflect, No Regen) or valuable drops.
• Export/Import: Share your color configurations with others via JSON files.
• Edit Descriptions: You can even rewrite the text description of mods for better clarity.
• Mod Language: Pick the language of mod descriptions from a dropdown listing every language found in the game files, independent of the app's interface language. Players on non-English clients (for example Traditional Chinese) can search and match mods in their own language. Mod data is fetched automatically, so no manual extraction step is required.

2. Spell Effects

A powerful tree-based editor to disable specific spell effects.

• Tree View: Browse through all game effects organized by category.
• Selective Disabling: Disable effects for specific skills (e.g., "Discharge", "Tornado Shot") to reduce visual clutter without removing everything.
• Search: Quickly find effects by name.

3. Black Screen (Performance Mode)

An extreme optimization mode that removes textures and shaders, rendering the game world mostly black while keeping essential gameplay elements visible.

• File Extensions: Choose which file types to ignore (e.g., .dds textures, .wav sounds).
• Animation Blocks: Disable specific animation categories like ParticleEffects, Lights, or WindEvents.
• SkinMesh Settings:
  • Ignore List: Select specific 3D models (metadata) to keep visible even in Black Screen mode. This is crucial for keeping your character, specific bosses, or important mechanics visible.
  • Scanning: The tool scans game files to build a complete list of available models for you to toggle.

9. AutoCraft

The AutoCraft tab provides a powerful automation tool for crafting items using currency spam (e.g., Chaos Orb) until specific modifiers are hit.

Overview

AutoCraft works by automatically applying a selected currency to an item repeatedly. After each application, it scans the item's modifiers to check if they match your desired criteria. If a match is found, the process stops immediately.

Getting Started

Mod data is downloaded automatically from the server on startup — no manual setup is required. (You do not need to load GGPK data in the Smoother tab for AutoCraft.)

1. Enable the Module: Go to the AutoCraft tab in the main POEFixer window and check the "Enable AutoCraft" box.
2. In-Game Activation:
   • Switch to the game window.
   • Hover your mouse cursor over the item you wish to craft in your inventory.
   • Press Ctrl + Alt.
   • This will open the AutoCraft Overlay window.

Interface Description (The Overlay)

The crafting process is managed entirely through the in-game overlay window.

• Target Item: Displays the name of the item currently selected for crafting.
• Currency: A dropdown menu to select the currency type you want to use (e.g., Chaos Orb, Orb of Alteration). The tool automatically detects available currency in your inventory.
• Limit: A safety feature that sets the maximum number of currency items to use. The default is 10. The bot will stop if this limit is reached, preventing accidental loss of all currency.
• Search Mods:
  • Type in this field to search for specific modifiers (e.g., "maximum life", "resistance").
  • A list of matching mods will appear below. Click a mod to select it for configuration.
• Mod Configuration:
  • Once a mod is selected, you can set minimum values for its stats (e.g., if you want at least "+80 to Maximum Life", set the value to 80).
  • Click the "+ Add" button to add it to your Target List.
• Target Mods List:
  • Displays all the criteria you are looking for.
  • Logic: The system uses "OR" logic. This means if any single mod in this list is found on the item with the required values, the crafting process will stop as a "Success".
  • Use the "Edit" or "X" (Delete) buttons to manage your targets.

Crafting Process

1. Setup: Ensure you have enough of the selected currency in your inventory.
2. Start: Click the green "START CRAFT" button in the overlay.
3. Execution:
   • The bot will automatically right-click the currency.
   • It will hold Shift to enable bulk application.
   • It will left-click the target item to apply the currency.
   • After each click, it instantly reads the item's new modifiers.
4. Stopping:
   • Success: A matching mod is found.
   • Limit Reached: The configured currency limit is hit.
   • Manual Stop: You click the "STOP" button.
   • Emergency Stop: Press the emergency stop hotkey (default: Escape).
   • Error: If the item or currency is moved/lost.

Warning: The bot simulates mouse clicks. Do not move your mouse or use the keyboard while the crafting process is running (except to press the emergency Stop hotkey or clicking Stop in the UI).

Settings

The AutoCraft module has configurable settings:

• Speed Dial: a -10..+10 slider (geometric scale, default: +7). 0 ≈ 500 ms per click, +10 ≈ 50 ms, -10 ≈ 3000 ms. The numeric value shown next to the slider is the live per-click delay in milliseconds. Lower the dial if crafting is unstable on a slow connection.
• Behavior:
  • Default Max Currency (1-1000, default: 10) — maximum currency to use per session.
  • Stop on First Match — halt on first successful mod match.
  • Auto Pick Currency — automatically select the right currency.
  • Check Mods Every Click — verify mod changes after each application.
• Safety:
  • Emergency Stop Key (default: Escape) — instantly stops the crafting process.
• Craft Log: Toggle display of a scrollable crafting history log (max 50 entries by default).

Templates

The overlay supports multiple named craft templates. Each template stores its own currency selection, currency limit, and target mod list independently.

• Switching templates: Click any tab in the template strip to make it the active template. The active tab is highlighted. Start Crafting always runs the currently active (highlighted) template.
• Creating a template: Click the + button at the right end of the strip to create a new template with default settings.
• Renaming a template: Click the [Rename] button next to the active tab to open an inline text field. Edit the name, then press Enter or click OK to confirm, or Cancel to discard.
• Deleting a template: Click the [Delete] button next to the active tab. An inline confirmation prompt appears — click Yes to confirm or No to cancel.

Note: Ctrl+Alt on a base item opens the craft overlay window. The template you had active last time is restored automatically.

Import / Export

The Import/Export panel appears below the Enable Auto Craft checkbox (click to expand it).

• Quick clipboard actions (collapsed panel):
  • Copy all — copies all templates to the clipboard as JSON.
  • Paste — replaces all templates with the clipboard content (prompts for confirmation if templates already exist).
• Expanded panel — Export:
  • Select one or more templates from the list, then either Copy to clipboard or Save to file (saved as a .json file under Configs/auto_craft/exports/; you choose the file name).
• Expanded panel — Import:
  • Paste from clipboard or Load from file — select a previously exported .json file.
  • If an imported template name already exists, it is imported as a copy named Name (2) (or (3), etc.) to avoid overwriting existing work.

Custom Craft (Node Editor)

The Custom Craft sub-tab within AutoCraft provides a visual node-graph editor (similar to Unreal Engine Blueprints) for building complex crafting automation workflows. Instead of simple currency spam, you can create multi-step crafting recipes with conditions, loops, and stash interactions.

Getting Started

1. Switch to the AutoCraft tab and select the Custom Craft sub-tab.
2. Click [+ New Config] to create a new crafting configuration.
3. Drag nodes from the context menu (right-click on the canvas) onto the editor.
4. Connect nodes by dragging from output pins to input pins.
5. Click [Run] to execute the graph.

Editor Interface

• Canvas: Drag to pan, scroll to zoom. Right-click for the node creation context menu.
• Toolbar: New/Save/Load/Import/Export configurations, Run/Stop execution.
• Config Tabs: Multiple configurations can be open simultaneously as tabs.
• Properties Panel: Right sidebar showing settings for the selected node.
• Undo/Redo: Ctrl+Z / Ctrl+Y (up to 50 history steps).
• Auto-Save: Dirty configurations are auto-saved after 2 seconds of idle time.

Pin Types

Pins are the connection points on nodes. Each pin has a type that determines what data it carries:

Pin	Color	Shape	Description
Exec	White	Triangle	Execution flow (determines order of operations)
Bool	Red	Circle	True/False values
Int	Green	Circle	Integer numbers
Float	Lime	Circle	Decimal numbers
String	Orange	Circle	Text values
Item	Purple	Diamond	Item references
Inventory	Cyan	Diamond	Inventory references
Entity	Yellow	Diamond	Entity references

Available Nodes (29 total)

Flow Control (6):

• Start — Entry point of the graph.
• Branch (If) — Routes execution based on a Bool condition (True/False outputs).
• WhileLoop — Repeats execution while a condition is true.
• ForLoop — Repeats execution a fixed number of times.
• Delay — Pauses execution for a configurable duration.
• Log — Outputs a message to the execution log.

Stash & Inventory (5):

• OpenStash — Opens the stash by walking to it and clicking.
• SwitchStashTab — Switches to a specific stash tab by name.
• TakeItemFromStash — Picks up an item from a stash slot.
• CloseStash — Closes the stash UI.
• CheckCursor — Checks if an item is currently attached to the cursor.

Item Inspection (5):

• GetItemMods — Reads all modifiers from an item.
• GetModAtIndex — Gets a specific modifier by index.
• HasMod — Checks if an item has a specific modifier (supports Any/Minimum/Maximum/Exact matching).
• GetItemRarity — Returns the rarity of an item.
• GetItemBaseName — Returns the base type name of an item.

Crafting (3):

• FindItemInInventory — Locates an item in player inventory or stash (with visual item picker).
• FindCurrency — Finds a currency item by name in inventory or stash.
• UseCurrencyOnItem — Applies currency to an item (right-click currency, shift+click item). Supports cross-tab crafting when currency and item are in different stash tabs.

Comparison & Logic (5):

• CompareInt — Compares two integer values.
• CompareString — Compares two string values.
• AND / OR / NOT — Boolean logic gates.

Variables (2):

• SetVariable — Stores a value in a named variable.
• GetVariable — Retrieves a value from a named variable.

Utility (2):

• Comment — A non-functional note for documenting your graph.
• Reroute — A pass-through node for cleaner wire routing.

Cross-Tab Crafting

Custom Craft supports crafting with currency and target items in different stash tabs:

1. The graph finds currency in one tab and the target item in another.
2. Right-clicks the currency (attaches to cursor), then switches to the target item's tab.
3. Shift+clicks the target item to apply the currency.
4. Automatically handles tab switching for each iteration in loops.

Templates

A built-in Chaos Orb Reroll template is included as a starting point — it demonstrates a loop that applies Chaos Orbs until a desired modifier is found.

Configuration Storage

Configurations are saved as JSON files in Configs/custom_craft/. You can import/export configurations to share with others.

---

10. HealthBars

The HealthBars tab offers a highly customizable overlay system that displays Health (HP) and Energy Shield (ES) bars directly over entities in the game world. This visual aid helps you quickly identify high-priority targets, monitor your own status, and execute mechanics like Culling Strike with precision.

Global Settings

These settings apply to the entire HealthBars system or define defaults.

• Enable HealthBars: Toggles the entire feature on or off.
• Draw in Town / Draw in Hideout: Choose whether to display health bars when you are in safe zones like towns or your hideout.
• Interpolate Position: Smooths the movement of the health bars to match the entity's movement.
  • Interpolation Rate: Adjusts the smoothness speed (in milliseconds). Lower values are more responsive, while higher values are smoother.
• Height Offset: Globally adjusts the vertical position of all health bars relative to the entity model (useful if bars are floating too high or clipping into the model).
• Culling Strike Thresholds:
  • Define the percentage of HP at which the bar changes color to indicate the monster is within Culling Strike range.
  • Configurable separately for White, Magic, Rare, and Unique monsters.

Entity Groups

You can independently configure health bars for different types of entities. This allows you, for example, to have large, distinct bars for Unique bosses while keeping White monster bars subtle or hidden.

Supported Groups:

• White Monsters: Normal enemies.
• Magic Monsters: Blue enemies.
• Rare Monsters: Yellow enemies.
• Unique Monsters: Bosses and unique enemies.
• Friendly Monsters: Minions and allied NPCs.
• Player: Your character and other players.

Per-Group Configuration

Each group has its own collapsible section with the following options:

Visibility & Elements

• Enable Group: Toggles health bars for this specific group.
• Show Health Bar: Displays the main HP bar.
• Show ES Bar: Displays the Energy Shield bar (stacked above the HP bar).
• Show Culling Strike: Changes the HP bar color when the target is below the defined Culling Strike threshold.
• Show Text: Displays the numerical HP value (e.g., "1.5M", "100K").
  • Show Text Background: Adds a background box behind the text for better readability.

Colors

Customize the visual appearance with a full color picker (supports transparency):

• Health Color: Color of the HP bar.
• ES Color: Color of the Energy Shield bar.
• Background Color: Background color of the empty portion of the bars.
• Text Color: Color of the numerical text.
• Text Background: Color of the text background box.

Dimensions & Layout

• Scale (Width/Height): Adjusts the size of the health bar.
• Shift (X/Y): Fine-tune the position of the bar relative to the entity (pixel offset).
• Graduations: Adds vertical tick marks to the bar to help estimate HP percentages.
• Border Thickness: Adjusts the thickness of the black outline around the bars.
• Bar Gap: Sets the vertical spacing between the HP bar and the ES bar.

11. Atlas

The Atlas tab provides a comprehensive overlay for the in-game Atlas, offering enhanced visualization, pathfinding, and management tools to streamline your mapping strategy. It helps you track completion, find specific maps, and plan your route through the Atlas.

Key Features

1. Interactive Overlay

The core feature is a highly customizable overlay that draws directly over the in-game Atlas screen.

• Enable Overlay: Toggles the entire Atlas overlay system on or off.
• Hide When Not Focused: Automatically hides the overlay when the game window is not in focus to save resources and screen space.
• Controller Mode: Optimized navigation and display adjustments for players using a controller.

2. Search & Routes

Easily locate specific maps and see exactly how to reach them.

• Search Maps: A dedicated search bar allows you to type a map name (partial matches supported, comma-separated multi-search). The overlay shows only matching maps.
• Search in map properties: A search term also matches a map's content (Breach, boss, essence, effect descriptions...) and its biome name — type "breach" to light up every revealed map carrying a Breach.
• Line mode — how found maps are pointed at:
  • Straight line from center: the classic dashed pointer from the screen center toward every match, with optional grid distance label, distance limit slider and edge-pinning of off-screen matches.
  • Route through maps: the line follows the actual atlas connections from your nearest accessible map to the target, and a counter badge next to the map shows how many maps you must complete before you can enter it (0 = enterable right now). A green dot marks the map to start running. Unreachable phantom matches get no line at all.
• Route thickness / colors: Both line styles are fully color- and thickness-customizable.
• Search Groups: Save searches as named, toggleable groups. While a group is enabled its terms work exactly like text typed into the search box, and matching maps get lines/routes in the group's own color — keep one group for "Breach farm", another for unique maps, and flip them on/off as needed.

3. Map Content Icons

See what every map contains at a glance — using the game's own icons.

• Content icons: Each map's content (Breach, Delirium, Expedition, Ritual, Essence, bosses, corruption and more) is drawn as a row of in-game icons above the map name. Three modes: Off, All maps, or Only hidden (fog) maps — the latter avoids doubling the icons the game already draws on revealed maps.
• Tooltips: Hover an icon to see the content's name and full effect description (in your client language).
• Per-type visibility: Toggle individual content types on/off in the settings, with icon previews.
• Icon size: Adjustable.

4. Display Customization

Filter what is shown to focus on your current goals.

• Hide Completed: Hides maps you have already completed — including their search lines and routes (completed Citadels remain visible as landmarks).
• Hide Inaccessible: Hides maps that you cannot currently enter — including their search lines and routes.
• Biome Borders: Draws a colored border around maps belonging to specific biomes — per-biome colors and visibility, adjustable thickness.
• Colors & Scaling:
  • Background/Font Colors: Set global default colors for the map cards.
  • Scale Multiplier: Adjust the size of overlay elements relative to the game UI.
  • Anchor Nudge: Fine-tune the alignment of the overlay if it doesn't perfectly match the game window.

5. Map Groups

Create custom collections of maps for tracking specific strategies (e.g., "Citadels", "Farming", "Boss Rushing").

• Ctrl+Click on the Atlas: Hold Ctrl and click any map card right on the atlas — a small picker pops up with two sections: Map groups (assign/remove the map) and Search groups (toggle the map as a search term). No need to type names.
• Route to group maps: Each group has a Route to group maps checkbox — the overlay draws a route (with the maps-to-complete counter) to every uncompleted map of the group, in the group's own route color. Perfect for Citadels, Towers or any custom target list.
• Custom Groups: Create named groups of maps; reorder, rename or delete them. Map entries are editable in place and can be copied to the clipboard with one click.
• Styling: Assign unique background, font and route colors to each group for quick visual identification on the Atlas. The Overall size slider scales names, cards and content icons together.

---

12. Hotkeys (Custom Hotkeys)

The Hotkeys tab is a powerful automation and macro system that allows you to create complex behaviors, auto-aim scripts, and reaction-based triggers. It has three subtabs: Custom Hotkeys (manual macros), Skills (per-skill action sequences), and System Hotkeys (built-in shortcuts).

Custom Hotkeys

This section allows you to define your own macros. You can organize them into groups, set specific conditions, and chain multiple actions together.

Groups

• Add Group: Create a new folder to organize your hotkeys (e.g., "Combat", "Buffs").
• Toggle: Enable or disable entire groups at once.
• Rename: Double-click a group name to rename it.

Hotkey Configuration

Each hotkey consists of an identity, a trigger/output key, global conditions, and a list of actions.

1. Identity:

   • Enabled: Toggle individual hotkeys.
   • Name: Double-click to rename (e.g., "Auto Pot", "Aim Bot").
   • ID: A unique number (e.g., #1) used for chaining macros.

2. Global Conditions:

   • Focus: If checked, the hotkey only works when the game window is in the foreground (prevents accidental triggers while alt-tabbed).
   • Safe Zone: If checked, the hotkey is disabled in Towns and Hideouts (prevents wasting resources).

3. Output Key (Trigger):

   • Click the button to assign a key (Keyboard, Mouse, or Gamepad).
   • Function: This is the key the program will simulate pressing when actions are executed. It can also serve as a manual trigger for "Chain" actions.
   • Modifiers: Supports Ctrl, Shift, Alt, and Gamepad LT.

Actions

You can add multiple actions to a single hotkey. They execute in sequence or loop based on their settings.

• Repeat:

  • Simply presses the Output Key repeatedly.
  • Infinite: Runs forever while the hotkey is active.
  • Count: Runs a specific number of times.
  • Interval: Time (ms) between presses.

• Chain (Link Hotkeys):

  • Triggers another hotkey by its ID.
  • Trigger Mode:
    • Program Only: Fires only if this hotkey was triggered automatically.
    • User Only: Fires only if YOU physically pressed the key.
    • Always: Fires in both cases.
  • Delay: Time to wait before triggering the next hotkey.

• Vitals (Health / Energy Shield / Mana):

  • Triggers the key press when your HP/ES/Mana meets a condition (e.g., < 50%).
  • Useful for Auto-Pot, Auto-Logout, or panic skills.

• Buffs / Charges:

  • Check Charges: Triggers based on Power/Frenzy/Endurance/Spirit charge counts.
  • Check Buff: Triggers if a specific buff name is present/absent or has a certain stack count/time left.
  • Charged Staff: Specific check for "charged_staff_stack".

• Monster Count:

  • Triggers when a certain number of monsters (with optional Rarity filters) are within a specific radius.
  • Useful for using AoE skills automatically when surrounded.

• Hold:

  • Holds the Output Key down for a specified duration (ms).

• MouseMove (Auto-Aim):

  • The most advanced action. It finds a target, moves the mouse cursor to it, and (optionally) presses the key.
  • Target Types:
    • Monster: Filter by Rarity (Normal/Magic/Rare/Unique).
    • Chest: Filter by type (Strongbox, Expedition, Breach, etc.).
    • Player/NPC: Select specific names from the current area.
    • Custom: Target any entity by its Metadata path.
  • Settings:
    • Radius: Max distance to search for targets.
    • Hold Time: How long to track the target.
    • Debug Mode: Draws a red circle (radius) and white text (entity metadata) in the overlay.
    • Scan All: Ignores standard filters and targets everything (for testing).

Skills (Skill Action System)

A second subtab of Hotkeys (alongside Custom Hotkeys) for building per-skill macros. You bind a Global Key to a sequence; pressing it runs a configurable tree of Skill Actions (key presses, delays, cooldown / cast-time waits, mouse targeting, conditional blocks, …) with in-game verification and a global Esc abort. Sequences are organized into groups and can be exported / imported.

Charged Skill action

Holds a channeling skill's key until a buff reaches a target charge count, then releases — useful for skills like Snipe that build up stages while the key is held.

• Buff name: the buff to watch — the "Chg" column in Debug → Buffs (e.g. channelling_seconds_70). A From buffs picker lists your current buffs with their charge counts; a partial name also matches (the game appends a per-gem suffix to gem-sourced buffs).
• Charges < > = Value: release the key the moment (buff charges) <op> value becomes true. Use > or = to build up; < is for buffs that decay.
• Max hold ms: safety timeout (default 6000). If the buff never reaches the target, the key is released anyway and the sequence continues.
• While charging:
  • Block (wait) — hold here until charged (or timeout), then continue with the next action.
  • Continue (bg) — keep running the following actions while the key stays held; it releases in the background the moment the buff charges.
• Use custom key: by default it holds the sequence's skill key; enable this to hold a different key.

Targeting by monster debuff

The Mouse Move action and the Monster / Player conditional blocks can filter targets by a buff/debuff on the target itself, combined with the existing Rarity / HP / distance filters:

• Buff name + Has / Lacks: match only entities that have (or do not have) the named buff/debuff.
• Charges < > =: optionally require the buff to be at a certain stack count.

Example: Mouse Move → Monster, Rarity = Rare, Has debuff "X", Hold-and-continue → (child) press your skill homes the cursor only onto a Rare monster that carries that debuff and uses the skill on it.

System Hotkeys

Built-in global shortcuts for controlling the application.

• Menu Toggle: Show/Hide the overlay menu. Supports modifiers (None, Ctrl, Shift, Alt).
• Stop Trade: Emergency stop for trade automation. Supports modifiers.
• Pause Live Search: Pause all live search notifications. Supports modifiers.
• Bot Hotkey: Start/stop the bot.
• Radar - Add from Map: Adds the entity under your cursor to the Radar filter list.
• Radar - Add POI: Adds a Point of Interest at the cursor location.

13. Notifications

The Notifications tab configures how and where you receive alerts about trade events and game activity. It supports three notification channels: Desktop pop-ups, Discord DMs, and Telegram messages.

Desktop Notifications

System-level Windows toast notifications that appear on your screen.

• Enable Desktop Notifications: Master toggle.
• Position: Choose where notifications appear — Top-Right, Top-Left, Bottom-Right, Bottom-Left.
• Display Time: How long the notification stays visible (3-30 seconds).
• Enable Sound: Plays a sound effect when a notification appears.
• Display Options:
  • Show Icon: Displays the item's icon image.
  • Show Price: Shows the listed price and currency.
  • Show Seller: Shows the seller's account name.
  • Show Mods: Lists the item's explicit modifiers.
• [Test Notification] — Sends a sample notification to preview your current settings.

Remote Notifications (Paid Feature)

Receive notifications on your phone or desktop via Discord or Telegram when you are away from the game.

Note: Remote notifications require a paid license tier.

Discord Integration

• Status Indicator: Shows "Linked" (green) or "Not Linked" (yellow).
• [Link Discord] — Opens an OAuth2 flow to connect your Discord account. You will receive trade notifications as Discord DMs from the POEFixer bot.
• [Unlink] — Removes the Discord connection.

Telegram Integration

• Status Indicator: Shows "Linked" (green) or "Not Linked" (yellow).
• [Link Telegram] — Initiates the linking process via the POEFixer Telegram bot. Follow the deep-link to start a conversation with the bot.
• [Unlink] — Removes the Telegram connection.

Test Remote Notifications

• [Send Test] — Sends a test notification to all linked services. Has a 30-second cooldown between tests (shows countdown timer).

Event Notifications

Configure which game events trigger remote notifications (Discord/Telegram):

Event	Description
Game Problem Detection	Alerts when game crashes or disconnects
Inventory Full	Alerts when player inventory reaches capacity
Stash Full	Alerts when stash tab reaches capacity
Update Available	Alerts when a new POEFixer version is released
Spend Limit Reached	Alerts when a currency spending limit is hit
Currency Not Found	Alerts when the system cannot find a specified currency item

Each event has an independent toggle checkbox.

---

14. Follow Bot

The Follow Bot tab allows your character to automatically follow another player or entity. This is particularly useful for playing with a support character (Aurabot) or dual-boxing.

Key Features

1. General Control

• Bot Mode: Select between Follow Bot and Map Clear Bot from the dropdown at the top.
• Enable Follow Bot: Master switch to start/stop the bot.
• Status Indicator: Displays the current state of the bot (e.g., Following, WaitingForTarget, Stuck) with color coding for quick status checks.

2. Target Settings

Configure who to follow and how close to stay.

• Target Name: Manually enter the name of the player/character to follow.
• Pick Player: A dropdown list showing nearby players. Select one to automatically fill the Target Name.
• Stop Distance: The distance at which the bot will stop moving towards the target (default: 80 units).

3. Movement Settings

Fine-tune how the bot moves and interacts with the game.

• Move Key: Assign the key used for movement (usually your "Force Move" key in-game). Click the button and press the desired key to bind it.
• Click Ahead Distance: How far ahead of the current position the bot should try to click (1.0-80.0 grid units).
• Click Interval: Time (in ms) between movement clicks (16-500ms).
• Update Interval: How often the bot logic runs (8-200ms).
• Path Recalc Interval: How often the pathfinding algorithm recalculates the route to the target (50-2000ms).
• Return Cursor: If enabled, returns the mouse cursor to its original position after a movement click.
• Require Focus: If enabled, the bot only moves when the game window is in the foreground.
• Disable in Town: Automatically pauses the bot when in town or hideout.

4. Human Mouse Movement

Makes mouse movement look natural instead of teleporting the cursor.

• Enable Human Mouse: Toggle realistic cursor movement.
• Speed: Movement speed multiplier (0.3-3.0).
• Curvature: How curved the mouse path is (0.0-3.0).
• Tremor: Natural hand shake simulation (0.0-3.0).
• Overshoot: How much the cursor overshoots the target (0.0-0.5).

5. Dodge Roll

• Dodge Roll Key: Key to press for dodge rolling (default: Space).
• Dodge When Stuck: Automatically dodge roll when the bot gets stuck.
• Dodge Roll Cooldown: Minimum time between dodge rolls (500-30000ms).

6. Anti-Stuck Settings

Mechanisms to handle situations where the bot gets stuck.

• Stuck Timeout: How long (in ms) to wait without successful movement before declaring "Stuck" (1000-10000ms).
• Max Recovery Attempts: Number of attempts to un-stuck before giving up (1-10).

7. Game Launcher Integration

If the game is not running, the bot can automatically:

1. Launch the game process.
2. Wait for the login screen and click "Log In".
3. Wait for character select and click "Play".
4. Wait for the game to load, then start the bot.

Configure the Game Path field to point to your game executable for this feature.

8. Debug Settings

Visual tools to diagnose pathfinding and logic.

• Debug Overlay: Enables drawing debug information on the screen.
• Show Path: Draws the calculated path to the target.
• Show Waypoints: Highlights the specific points the bot is clicking.
• Show Stop Radius: Visualizes the circle around the target where the bot will stop.

---

15. Map Clear Bot

The Map Clear Bot is a fully autonomous mapping bot that explores areas, fights monsters, opens chests, and picks up items. It is accessed from the Bot tab by selecting "Map Clear Bot" from the Bot Mode dropdown.

How It Works

The Map Clear Bot uses a coverage-based exploration algorithm:

1. It divides the map into a grid of cells.
2. It systematically visits unvisited cells, prioritizing nearby areas.
3. When monsters are detected, it switches to combat mode.
4. When chests are found, it opens them.
5. When items drop, it picks them up.
6. It continues until the coverage threshold is reached or you stop it.

Movement & Exploration

All movement settings from the Follow Bot section apply (Move Key, Click Ahead Distance, Human Mouse, etc.). Additional Map Clear-specific settings:

• Coverage Threshold: Target exploration percentage before considering the map "complete" (50-100%, default: 95%).
• Exploration Radius: How far ahead the bot looks for unexplored cells (5-30 grid units).
• Coverage Cell Size: Size of each grid cell for coverage tracking (2-8 grid units).

Combat Settings

• Enable Combat: Toggle automatic monster fighting.
• Combat Radius: How far away the bot detects and engages monsters (100-1000 pixels).
• Max Combat Time: Maximum time spent fighting before moving on (1000-30000ms). Prevents getting stuck on unkillable enemies.

Anti-Surround

A safety feature to avoid getting surrounded by too many monsters.

• Enable Avoid Surround: Toggle the flee mechanic.
• Minimum Monster Count: Number of nearby monsters that triggers fleeing (1-20).
• Detection Radius: How far to check for surrounding monsters (50-1000 pixels).

Chest Interaction

• Open Chests: Enable automatic chest opening.
• Chest Type Filters: Toggle which chest types to open:
  • Normal, Magic, Rare, Strongbox, Expedition, Breach.
• Chest Detection Radius: How far to look for chests (100-800 pixels).
• Chest Click Radius: Maximum distance for clicking a chest (50-300 pixels).
• Chest Open Delay: Wait time after clicking a chest (50-2000ms).
• Max Chest Attempts: How many times to try opening a chest before giving up (1-10).

Item Pickup

• Enable Item Pickup: Toggle automatic loot collection.
• Pickup Radius: How far to look for items (50-3000 pixels).
• Max Pickup Attempts: How many times to try picking up an item (1-20).
• Animation Wait Time: How long to wait for pickup animation (100-3000ms).

Bot States

The Map Clear Bot cycles through these states automatically:

State	Description
Exploring	Moving to unvisited map areas
Combat	Fighting detected monsters
OpeningChest	Interacting with a nearby chest
PickingUpItem	Collecting dropped loot
ReturningToRoute	Returning to exploration path after combat/loot
Stuck	Recovery mode — trying to get unstuck
Completed	Coverage threshold reached

Debug Overlay

The debug overlay for Map Clear Bot shows additional information:

• Show Path — The planned exploration route.
• Show Panel — Debug panel with current state, coverage %, blacklisted entity count.
• Entity Type Filters — Filter which entity types appear in debug: Monster, NPC, Chest, Player, Shrine, Item, Transition, Delirium, Other.
• Entity Details — Select any entity to see its ID, path, type, subtype, HP/ES, position, and component data.

---

16. Launcher (Limited User)

The Launcher tab provides a secure and isolated environment for running the game. It allows you to create and manage "Limited Users" — Windows accounts with restricted permissions — and launch the game under these specific user contexts. This is particularly useful for security (Sandboxing) and for running multiple instances of the game with separate configurations/permissions.

Key Features

User Management

The core of this tab is the management of restricted Windows user accounts.

• User Selection: A dropdown menu lets you choose which Limited User account to use for launching the game.
• Create New User: Click the "Create New" button to open a dialog where you can define a new username and password. This creates a real Windows user account on your system with limited privileges.
• Delete User: Remove the currently selected Limited User from your system.
• Manage All Users: View a list of all users on the system. Warning: This allows you to delete any user, so use this with caution.

Game Configuration

• Game Path: Specify the full path to your game executable (e.g., PathofExile.exe or PathofExile_x64.exe).
• Browse: Use the "..." button to open a file explorer and select the executable file.

Launching

• Launch Game: The large button at the bottom starts the game using the credentials of the selected Limited User. The application handles the complex process of logging in the user in the background and starting the process securely.

Detailed Functionality

1. Isolation: By running the game as a different user, the game process is isolated from your main user's files and other running processes.
2. Configuration Saving: The launcher automatically saves your selected game path and user preferences, so you don't need to re-enter them every time.
3. Security: Passwords and credentials are managed securely by the application's backend.

---

17. Logs

The Logs tab is a powerful system event viewer that allows you to monitor the application's internal state, debug issues, and track automated actions in real-time. It offers extensive filtering and management tools to keep the information relevant and readable.

Interface Overview

The interface is divided into four main areas: the Control Bar, Category Filters, the Log List, and the Status Bar.

1. Control Bar (Top)

Located at the top of the tab, this bar provides quick access to global filters and window management.

• Search: A real-time text filter. Type here to instantly filter logs by message content or timestamp.
• Level Filters: Toggle buttons to show/hide logs based on severity:
  • Info: General informational messages (Blue).
  • Warning: Potential issues or important alerts (Yellow).
  • Error: Critical failures or errors (Red).
  • Debug: Deep internal state information (Grey, available in Debug builds only).
• Category Filter Toggle: Click the filter icon to expand/collapse the detailed Category selection panel.
• Detach/Attach Window: Moves the Logs tab into a separate, floating window. This is useful for keeping logs visible on a second monitor while using other tabs in the main application.
• Save to File: Exports the current log history to a text file in the logs/ directory. Useful for sharing with developers for support.

2. Category Filters (Collapsible)

When expanded, this section allows fine-grained control over which modules generate logs.

• Categories: You can enable or disable logs for specific features like Trade, Radar, AutoPot, AutoCraft, Hotkeys, Bot, etc.
• Trade Subgroups: The Trade category is further divided into subgroups for precise debugging:
  • Connection: Status of the trade site connection.
  • Buy: Buy actions and clipboard operations.
  • WebSocket: Live data stream events.
  • RateLimit: Warnings about API rate limits.
  • Icon: Item icon loading status.
• Bot Subgroups: The Bot category has subgroups:
  • Settings: Bot configuration changes.
  • Skill: Skill usage and cooldowns.
  • Monster: Monster detection and combat.
  • Objects: Chest interaction.
  • Items: Item pickup events.
• All / None: Quick buttons to enable or disable all categories at once.

3. Log List (Center)

The main area displays the chronological history of events.

• Format: Each entry shows the Timestamp, Level Icon, Category Icon, and the Message.
• Context Menu: Right-click on any log entry to access copy options:
  • Copy Line: Copy the selected log line to clipboard.
  • Copy Visible: Copy only the currently filtered logs.
  • Copy All: Copy the entire log history.
• Auto-Scroll: The list automatically scrolls to the newest entry unless you manually scroll up to inspect older logs.

4. Status Bar (Bottom)

Displays statistics and maintenance tools.

• Counters: Shows the "Total" number of logs in memory and the "Shown" number based on current filters.
• Clear All: Permanently deletes all log entries from memory.
• Clear Filtered: Deletes only the logs that are currently visible (passing the active filters).

---

18. Debug [PoE 2]

The Debug tab provides low-level inspection tools for examining game memory structures in real-time. It is primarily designed for plugin developers and advanced users who need to understand entity data, component values, and UI element hierarchy.

1. Performance

Real-time performance monitoring:

• Frame Timing: FPS counter, total milliseconds per frame.
• Worker Thread Breakdown: Per-stage timing for UpdateGameData, UpdateEntities, UpdateInventories, etc.
• PathFinder Status: Initialized state, grid dimensions, cached paths count.
• Plugin Performance: Per-plugin UI/settings rendering time.

2. Player

Current player state inspection:

• Vitals: HP, ES, MP — current, max, and percentage values.
• Buff List: Scrollable table of all active buffs with name, charges, time remaining, total duration, flask slot, effectiveness, and source entity ID.
• Position: Grid position, world position, terrain height.
• Component Cache: Addresses for all player components.

3. Entity List

A filterable table showing all entities currently loaded in the game.

• Columns: Entity ID, Address, Metadata Path, Type, SubType, State, Rarity, Zone (InnerCircle/OuterCircle/Far).
• Type Filters: Quickly filter by entity type — Monsters, Chests, NPCs, Players, Items, Shrines, AreaTransitions, ExpeditionMarkers, ExpeditionRemnants, etc.
• Distance Filter: Slider to show only entities within a specific range (0-5000 grid units).
• Search: Text-based search by metadata path.
• Count Display: Shows total number of entities and filtered count.

4. Entity Watch (Component Inspector)

Click on an entity in the list to "watch" it. The application's worker thread will then read detailed component data for that entity every frame.

Available Components:

• Life: Health/EnergyShield/Mana vitals (each with Current, Total, Regeneration, ReservedFlat, ReservedPercent).
• Render: World position (X/Y/Z), grid position, terrain height, model bounds (X/Y/Z).
• Positioned: Reaction value, IsFriendly flag.
• Targetable: IsTargetable, IsHighlightable, IsTargettedByPlayer, HiddenFromPlayer, MeetsQuestState flags.
• Animated: Current animation path, animation ID.
• Stats: CurrentWeaponIndex, IsShapeshifted, stat dictionaries for items and buffs (stat ID -> value).
• Actor: AnimationId, AnimationName, active skills list (with Name, UseStage, CastType, Cooldown, CanBeUsed), DeployedCounts.
• Buffs: All active buffs with name, charges, time remaining, total duration, flask slot, effectiveness, source entity ID.
• All Components: Displays a full list of all component name->address pairs, even for components without dedicated parsing.

5. Component Explorer

A dedicated sub-tab for inspecting game object components in detail. The game uses 21 component classes, of which 8 have full data parsing in the debug UI.

• Parsed Components (8): Life, Render, Positioned, Targetable, Animated, Stats, Actor, Buffs — these are displayed with full field breakdowns in the Entity Watch panel.
• Additional Components (13): Base, Charges, Chest, DiesAfterTime, MinimapIcon, Mods, NPC, Player, Shrine, Stack, StateMachine, Transitionable, TriggerableBlockage — these are listed with name and address in the "All Components" view.
• Distance Filter: 0-5000 grid unit range selector.

6. Inventory Debug

Inspect the game's inventory system in detail.

• ServerData: Displays the ServerData component address.
• Inventory List: Shows all player inventories (ID, Address, Name).
• Inventory Watch: Select an inventory to inspect:
  • Slot Grid: Visual representation of occupied/empty slots.
  • Item List: All items with their metadata path, rarity, slot position.
  • Item Mods: Full mod breakdown (Implicit, Explicit, Enchant, Hellscape) with values.

7. UI Explorer

Navigate the game's UI element tree hierarchy.

• Game UI Root: Inspect elements under the in-game UI root (panels, menus, buttons).
• Top-Level UI Root: Access the top-level UI root for login/loading screens.
• Tree Navigation: Expand/collapse UI elements to see children, addresses, and properties.
• Search: Filter elements by name/path.
• GameCullValue: Displayed for UI scale calculations.

---

19. Plugins

The Plugins tab manages native C++ DLL plugins that extend POEFixer's functionality. Plugins can render overlays, access game data, and integrate seamlessly with the existing UI.

Plugin Management

• Plugin List: Shows all discovered plugins from the Plugins/ directory.
• Enable/Disable: Toggle individual plugins on or off. State is saved between sessions.
• Per-Plugin Settings: Each enabled plugin can render its own settings section directly in the Plugins tab.
• SDK Version Check: The host validates plugin SDK version compatibility on load. Current SDK version: 5.

Available Plugins

All plugin source code is available on GitHub:

• ExamplePlugin — SDK reference implementation with examples
• KillCount — Kill/chest/death tracking overlay
• NinjaPricer — item price overlay (prices from the core price service)

Each repository is self-contained with SDK headers, ImGui, and a Visual Studio solution — clone, open, and build.

Kill Counter

A comprehensive kill/chest/death tracking overlay with persistent statistics.

• Monster Kill Tracking: Counts killed monsters by rarity (Normal, Magic, Rare, Unique, Unknown) using disappearance-based detection — monitors entities within InnerCircle (~60 units) and OuterCircle (~120 units) zones.
• Chest Tracking: Counts opened chests by type (Magic, Rare, Expedition, Breach, Strongbox) by detecting state transitions (closed -> opened).
• Death Counter: Tracks player deaths by monitoring HP transitions.
• Per-Map Counters: Automatic reset when entering a new area. Old counters remain visible until first kill in new area.
• Lifetime Totals: Persistent statistics stored in a SQLite3 database (Plugins/KillCount/data/killcount.db). Tracks session history per area (name, hash, level, timestamps, all counters).
• Overlay:
  • Draggable when the program menu is active ("Drag to reposition" hint appears).
  • Non-interactive and title-bar-free when menu is hidden.
  • Configurable opacity (0-100%).
  • Tab bar for switching between Map and Total views (both can be enabled simultaneously).
  • Color-coded sections: orange headers (Monsters), light blue (Chests), red (Deaths).
• Icon Atlas: Displays entity type icons from the shared Resources/radar/icons.png sprite sheet with fallback icons for all categories.
• Settings: Configure which counters to display (5 monster types + 5 chest types + deaths), opacity, overlay mode, reset buttons for map/lifetime stats.

Ninja Pricer

A real-time item price overlay that displays prices on ground items, inventory, and stash tabs. Prices come from POEFixer's built-in price service — choose your league in Settings → Prices (the plugin no longer fetches prices or leagues itself).

• Coverage: Currency, Fragments, Abyssal Bones, Uncut Gems, Essences, Soul Cores, Idols, Runes, Ritual Omens, Expedition, Delirium, Breach, Lineage Support Gems, Reliquary Keys, Incursion, plus unique items (Accessories, Armour, Flasks, Jewels, Maps, Weapons, Sanctum Research). Item icons are shown next to prices.
• Three Display Locations:
  • Ground Items: Shows prices on dropped items in the game world. Detects stack counts (e.g., "2x Divine Orb" -> doubled price). Position configurable: Top, Bottom, Left, Right of the item label.
  • Inventory: Shows prices on items in the player inventory grid. Adaptive font sizing for small cells. Position configurable: corners of each cell.
  • Stash Tabs: Shows prices on items in the currently open stash tab. Auto-detects stash UI and active tab index.
• Price Display:
  • Three currency modes: Divine (D), Exalted (E), Chaos (C).
  • Color-coded: gold (>= 1 Divine), white (>= 0.1 Divine), gray (< 0.1 Divine).
  • Adjustable text size (0.5x to 2.0x).
• Always up to date: Prices are kept current automatically by POEFixer's core price service — there is no manual refresh and no per-plugin refresh interval to configure. A local cache provides offline fallback.
• Visibility Controls:
  • Hide when game not focused.
  • Hide hotkey (hold to temporarily hide overlay).
  • Per-category toggles (enable/disable individual price categories).
• Settings: Currency mode, text scale, display position per location, category display toggles, and hide hotkey. (League and price data are configured centrally in Settings → Prices.)

Example Plugin

A reference implementation demonstrating all Plugin SDK features:

• Buff Inspector: Lists player buffs with filtering and progress bars.
• Entity Explorer: Entity debug list with watch mechanism, component trees.
• Inventory Inspector: ServerData viewer, inventory selector, slot grid, item mods.
• Memory Viewer: Hex dump viewer, Read<T> demo, pattern scanner.
• UI Explorer: Full UI element tree navigator with search and highlighting.

Creating Plugins

See the Plugin Development Guide for detailed instructions on creating your own plugins, including:

• Project setup and build configuration
• IPlugin interface implementation
• PluginContext API reference (v1-v5)
• Data structures and enums
• Common recipes and patterns
• Draggable overlay pattern
• Troubleshooting guide

---

← Home