1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68

# Path of Exile Utilities

A collection of quality-of-life automation shortcuts for Path of Exile, featuring fast inventory management, safe chat macros, combat helpers, and a guided 4-step grid calibration wizard that adapts to any screen resolution or UI scale.

---

## Features

- **Guided Calibration (`F10`)**: Calibrate your inventory and trade windows in seconds without guessing pixel coordinates. Persisted locally to `coords.json`.
- **Fast Stash Transfer (`Ctrl + Left Click`)**: Hold Ctrl and Left Click to continuously transfer items until released.
- **Full Inventory Dump (`Left Arrow`)**: Automatically `Ctrl + Click` every slot across all 60 inventory cells.
- **Trade Window Inspector (`Up Arrow`)**: Sweeps your cursor over all 60 trade window cells to reveal item stats.
- **Instant Portal Scroll (`Grave / ~`)**: Opens inventory (`B`), right-clicks your bottom-right portal scroll slot, closes inventory, and restores your cursor position.
- **Chat Shortcuts**: One-tap hotkeys for `/hideout`, `/leave`, `/destroy`, and quick whispered replies (`ty`).
- **Combat Loop Helper (`Right Click`)**: Optional toggleable loop that cycles right-click attacks with secondary abilities (`Q` and `E`).
- **Modifier Remap**: Maps `Left Windows` to `Right Shift` to avoid accidental taskbar interruptions.

---

## First-Time Calibration

Before using the inventory dumping, right-clicking, or trade inspection features, calibrate your grid coordinates for your display resolution:

1. In Path of Exile, open your character inventory (`B`).
2. Press **`F10`** (or your configured calibration key). An in-game notification will appear for **Step 1/4**.
3. Hover your cursor over the **center of the top-left inventory slot** (row 1, col 1) and press **`F10`**.
4. Hover your cursor over the **center of the bottom-right inventory slot** (row 5, col 12) and press **`F10`**.
5. Open a trade window with an NPC or player. Hover your cursor over the **center of the top-left trade slot** and press **`F10`**.
6. Hover your cursor over the **center of the bottom-right trade slot** and press **`F10`**.

A success notification will appear. Grid positions are calculated via linear interpolation and saved to `coords.json` next to your script. You only need to repeat this if you change game resolution or UI scaling.

---

## Default Controls

Every keybind can be customized in the script's **Options** tab.

### Inventory & Management
| Action | Default Key | Description |
|---|---|---|
| **Calibrate Grid** | `F10` | Starts / advances the 4-step setup wizard |
| **Rapid Transfer** | `Ctrl + Mouse1` (Hold) | Rapidly left-clicks while Ctrl is held |
| **Dump Inventory** | `Left Arrow` | Iterates all 60 slots with `Ctrl + Click` |
| **Right-Click All** | `Right Arrow` | Iterates all 60 slots with `Right Click` |
| **Inspect Trade** | `Up Arrow` | Hovers every item in the trade window |
| **Instant Portal** | `` ` `` (Grave) | Triggers portal scroll in slot (12, 5) |

### Chat Shortcuts
| Action | Default Key | Command Sent |
|---|---|---|
| **Hideout** | `F1` | `/hideout` |
| **Quick 'ty'** | `F2` | `Ctrl + Enter` -> `ty` -> `Enter` |
| **Leave Party** | `F3` | `/leave` |
| **Destroy Item** | `F11` | `/destroy` |

### Diagnostics
| Action | Key | Description |
|---|---|---|
| **Cursor Position** | `F12` | Logs current screen `X, Y` to notifications and console |

---

## Configuration

In the Rebind **Options** tab for this script, you can:
- Toggle the **Right-Click Combat Loop** (`enable_right_click`).
- Reassign any hotkey or chat command trigger.