# Poe2VisualTool v2.0 Native Fusion — Commercial User Guide (English)

Welcome to **Poe2VisualTool v2.0 Native Fusion** — The premier, high-performance visual quality-of-life (QoL) engine and in-game ergonomic heads-up display (HUD) crafted exclusively for **Path of Exile 2 (PoE 2)**.

---

## 1. Core Philosophy & Security Commitments

1. **100% Pure Visual QoL — Zero Automation**:
   * Enhances visual clarity, camera projection, and information accessibility.
   * **Strictly NO gameplay macros, NO automated botting, and NO input injection**.
2. **OBS Streamer-Safe Guarantee**:
   * Uses Windows Desktop Window Manager (DWM) hardware display affinity (`WDA_EXCLUDEFROMCAPTURE = 0x00000011`).
   * Overlays, tooltips, and radar radars remain **completely invisible** on OBS Studio, Discord Screen Share, Streamlabs, and Twitch broadcasts.
3. **1-Frame Panic Restore SLA (< 8.33ms)**:
   * Pressing emergency key **`F12`** or **`Pause/Break`** atomically reverts all memory modifications back to developer-original state in **< 1.20 ms** (less than a single display frame at 120Hz).

---

## 2. Ergonomic Hotkeys & Controls

| Hotkey | Feature | Action & Behavior |
| :--- | :--- | :--- |
| **`F12`** or **`Pause`** | **1-Frame Panic Restore** | **Instant Emergency Revert**: Resets camera, fog, and shader patches to factory default. |
| **`F11`** | **Toggle Settings Dashboard** | Opens the in-game modern dark-themed configuration HUD. |
| **`F9`** | **OBS Streamer-Safe Mode** | Toggles overlay capture visibility for broadcasting software. |
| **`F10`** or **`Ctrl + O`** | **Game Path Selector** | Manually locate and link your `PathOfExile.exe` client executable. |
| **Mouse Wheel** | **Smooth Camera Zoom** | Scroll mouse wheel in-game to zoom in and out seamlessly. |
| **`Numpad +` / `Numpad -`** | **Step Zoom Adjust** | Adjust zoom ceiling in 0.1x increments without using mouse wheel. |
| **Hover + `Ctrl + C`** | **Item & Waystone Inspect** | Analyzes item affixes and triggers instant lethal brick alerts. |

---

## 3. Key Feature Walkthrough

### 3.1 Unlocked Camera Zoom (Up to 8.0x)
* **Command line**: `Poe2VisualTool.exe --max-zoom 8.0 --wheel`
* Provides expansive field-of-view scaling up to 800% of standard perspective. The engine dynamically calculates and synchronizes the DirectX `zFar` clipping plane with camera distance, completely preventing void horizons and terrain clipping.

### 3.2 Volumetric Fog Elimination
* Enabled by default (override with `--fog`).
* Clears atmospheric haze and light-scattering fog shaders, resulting in an immediate **15% - 20% GPU FPS boost** while illuminating dark corridors and dungeon rooms.

### 3.3 Full Minimap Shader Clarity
* Direct memory patch on minimap pixel shaders (Game Build 6AA2213C). Unveils terrain layouts, paths, and walls with 100% alpha saturation.

### 3.4 Smart Waystone & Item Inspector
* Hovering over any Waystone, Map, or Equipment displays an instant visual breakdown:
  * **BRICK ALERT (Bright Red + Audio Tone)**: Flags build-disabling modifiers (*Reflect Damage*, *Cannot Leech*, *-Max Resistances*, *Monsters steal charges*).
  * **DANGER ALERT (Amber)**: Highlights high-threat affixes (Turbo, Multi-Proj, Critical Strike Multiplier).
  * **BENCHMARK SAFE (Emerald Green)**: Clean maps for speed farming.
  * **Non-Destructive Clipboard**: Your existing copied text on Windows clipboard is automatically preserved and restored!

### 3.5 In-Game Settings Dashboard (`F11`)
* Press **`F11`** at any time while playing to view system status, switch between Vietnamese and English, toggle features, or review remaining license days.

---

## 4. Commercial Licensing & Activation

### 4.1 Retrieve Your Machine Hardware ID (HWID)
Upon running `Poe2VisualTool.exe`, your cryptographic HWID is generated via multi-factor hardware profiling (CPUID, Motherboard UUID, Volume Serial, MachineGuid):
```
[Poe2VisualTool v2.0 Native] HWID: PVT-8B3F-4A1C-9E2D-5F7A
```

### 4.2 Activating Your Product Key
1. Place your licensed key inside `license.key` in the same folder as `Poe2VisualTool.exe`.
2. Format example:
   ```
   PVTK-L1F3T-8B3F4A1C9E2D5F7A-20261231-A1B2C3D4E5F67890
   ```
3. The engine uses Windows CNG BCrypt HMAC-SHA256 to verify cryptographic authenticity with zero side-channel vulnerability.

---

## 5. Troubleshooting & Diagnostics

* **Q: The tool reports "Requires Administrator Privileges"?**
  * *Answer*: Memory inspection (RPM/WPM) requires elevated permissions on Windows 10/11. Click "Yes" when prompted by UAC.
* **Q: The tool cannot find Path of Exile 2?**
  * *Answer*: Press **`F10`** or **`Ctrl + O`** to select `PathOfExile.exe` or `PathOfExileSteam.exe`. The path is permanently remembered.
* **Q: Overlay is not appearing on my OBS or Discord stream?**
  * *Answer*: This is the intended **Streamer-Safe** security feature! If you explicitly wish to display the HUD to your viewers, press **`F9`** to disable streamer protection.