GameTools Health Monitor

Path of Exile Sid 輔助工具

A Windows automation research toolkit built on image recognition and input simulation
_{External automation research toolkit for Path of Exile}

---

📹 Demo

---

✨ Features

🩸 Health / Mana Monitor Real-time percent detection · Multi-threshold triggers · Cooldown protection	⚡ Skill Combos Custom sequences · Adjustable delays · Multiple profiles
🎒 Inventory Automation One-click clear · Fixed-point pickup · UI color recognition	🖱️ Auto Click Toggle with Ctrl + Left Click
⏱️ Skill Timers Millisecond precision · Supports key combinations	⏸️ Global Control F9 Pause · F12 Exit

---

🖼️ Screenshots

Health Monitor

Inventory Automation · Skill Combos

Status · Help · Version

About · Settings

---

⌨️ Hotkeys

Key	Action
F3	Clear Inventory
F5	Return to Hideout
F6	Pickup Sequence
F9	Pause / Resume
F10	Health Monitor Toggle
F12	Exit
Ctrl + Click	Auto Click

---

📦 Download

_{⚠️ Users on v1.2.1 or earlier must reinstall manually: auto-update will fail during download. Please download Sid.GameToolsHealthMonitor-win-Setup.exe and install over the old version (settings are preserved) · Windows 10 / 11
New users: download Setup.exe (recommended)}

---

🚀 Quick Start

⚠️ Game window setup: Set Path of Exile to Windowed Fullscreen or Windowed mode so background capture and overlay notices work correctly.

Secure self-build (read first)

With AI-driven attacks and lookalike download sites on the rise, only trust this official entry point: https://github.com/Sid-1996/PathofExile-Sid-GameTools_HealthMonitor/releases. Full guide for the three paths (source / self-built EXE / official package) is in docs/安全自建.md —— pick any one of them; this section only shows commands.

Path A — Run from source

git clone https://github.com/Sid-1996/PathofExile-Sid-GameTools_HealthMonitor.git
cd PathofExile-Sid-GameTools_HealthMonitor
uv sync --locked
Run.bat

(The legacy scripts\install_dependencies.bat still works, falling back to a global install.)

Path B — Build your own EXE

uv sync --locked
scripts\build_exe.bat
Run.bat

Path C — Official package

Go to Releases above and download Setup.exe (see Download section).

Data & Reset

• Config file: %LOCALAPPDATA%\GameTools_HealthMonitor\health_monitor_config.json (*.backup auto-backup, screenshots\ captures)
• In-app Settings > Data & Reset can Open Folder / Copy Path / Reset to Default (screenshots are kept unless you also check the delete option)

Uninstall

• Setup.exe install: Windows Settings > Apps > Installed Apps > Sid.GameToolsHealthMonitor > Uninstall, then manually delete %LOCALAPPDATA%\GameTools_HealthMonitor if you want to clear screenshots/settings
• ZIP portable: delete the extracted folder + the data folder above

---

📂 Project Structure

View full structure

src/
  app.py                     # Qt (PySide6) entry point
  qt/                        # Qt GUI layer (main_window + 7 tabs)
  monitor_analyzer.py        # Health/mana HSV analysis + triggers
  capture_utils.py           # Screenshot + mss singleton
  image_utils.py             # Image drawing/resize/preview
  inventory_utils.py         # Inventory slot analysis
  config_manager.py          # Config load/save + backup
  language_system.py         # Translation system (zh-tw / zh-cn / en)
  utils.py                   # Runtime utilities + get_user_data_dir + F12 emergency close
  auto_click_manager.py      # Auto-click (AHK) manager
  usage_tracker.py           # Usage time tracking
  window_key_sender.py       # Window-focus key sending
  auto_update.py             # Velopack GithubSource update engine (main, >= v1.2.4-test)
  updater_core.py            # Legacy update engine (transitional, removed in v1.4+)
  language_packs.json        # UI strings
scripts/                     # One-click workflows
tools/build.py               # Build pipeline (PyInstaller onedir + sidecar resources)
docs/                        # User/developer docs
updater_main.py              # Standalone updater (Legacy, transitional)
release.ps1                  # One-click publish (stable / -Preview / -TestRepo)

---

🧠 Tech Stack

---

🙏 Acknowledgements

Thanks to the open source projects that let this small toolkit focus on the task itself.

• Velopack — install & update
• PySide6 / qfluentwidgets — UI
• OpenCV — image recognition
• Windows.Graphics.Capture — window capture
• AutoHotkey / PyInstaller — auto-click & packaging

Please let me know if anyone is missing.

---

🤝 Community

---

☕ Support

If my tools help you, feel free to support me in your own way.

---

⚠️ Disclaimer

Click to view full disclaimer

This software is provided for educational research, automation study, and image recognition experimentation.

This software does NOT modify game files, inject code, or access game memory.

Usage may violate the Terms of Service of Grinding Gear Games. Use at your own risk.

---

_{License: AGPL-3.0 · Built with ❤️ by Sid-1996}