MercuryChat

MercuryChat is a JVM-based overlay utility for Path of Exile, designed for efficient trade management and real-time gameplay monitoring. This community-maintained fork focuses on stability, performance, and advanced filtering capabilities.

Performance Optimized | Highly Customizable | Community Driven

Resources

Latest Release | Java 8+ | Wiki

---

Support FOSS Development

Maintaining and evolving open-source software relies on community support. If MercuryChat improves your experience, consider supporting the project.

Table of Contents

• Quick Start
• New Features
• Feature Overviews
• System Requirements
• Installation
• Usage Guide
• Developer & Build Guide
• Changelog

Quick Start

1. Prerequisites: Ensure Java 8+ is installed.
2. Download: Get the Latest Release.
3. Launch: Execute MercuryChat.jar or MercuryChat.exe.
4. Configuration: Set Path of Exile to Windowed or Borderless mode.

Important

Path of Exile must be in Windowed or Borderless mode for the overlay to function correctly.

New Features

Chat Scanner: "+text" Response Support

Automatically detects and processes modern Path of Exile chat patterns.

• Smart Detection: Identifies patterns like "Free elder +elder".
• One-Click Response: Integration for global and trade chat responses.
• Hotkey Support: Full keyboard shortcut integration for rapid replies.

Advanced Filtering: Start Operator (^)

Enhanced filtering logic for cleaner scanner results.

• Prefix Filtering: Use the ^ operator to exclude messages that start with specific character strings.
• Combined Logic: Support for multiple filter combinations (e.g., ^+, ^-).

Feature Overviews

Overseer: Monitoring & Overlays

Customizable timers and screen-capture overlays for real-time tracking.

• Flask & Buff Tracking: Monitor flask durations and Vaal skill uptimes.
• Cooldown Monitoring: Track internal skill cooldowns.
• Screen Duplication: Duplicate specific screen regions for better visibility (e.g., mini-map or health bar).

Notification Management

Streamlined trade and scanner notifications with actionable shortcuts.

• Quick Responses: Contextual buttons for "Sold," "Wait 5m," etc.
• Smart Grouping: Stacked notifications for multiple trade requests.
• Notification History: Persistent storage for all trade metadata.

Stash Overlay & Highlighting

Precision highlighting for stash tab item retrieval.

• Cell Highlighting: Visual overlays for exact stash locations.
• Coordinate Alignment: Customizable grid settings for different resolutions.

Focus Mode (DND)

Silent background processing for high-intensity gameplay sessions.

• Toggleable State: Instantly pause visual alerts while maintaining history.
• One-Click Resume: Restore queued notifications after content is cleared.

System Requirements

• Runtime: Java 8 or higher (JDK 8 recommended)
• OS: Windows 10/11, Linux (Ubuntu 18.04+)
• Memory: 512MB RAM minimum (1GB recommended)
• PoE Settings: Windowed or Borderless mode required

Installation

Option 1: JAR (Universal)

1. Install Java 8+.
2. Download MercuryChat.jar.
3. Launch via double-click or java -jar MercuryChat.jar.

Option 2: Windows Executable

1. Download MercuryChat.exe.
2. Run as Administrator to ensure full overlay functionality.

Tip

The .exe is a wrapper around the .jar. If Windows flags it as "unrecognized," click "More info" > "Run anyway."

Usage Guide

1. Launch MercuryChat prior to starting Path of Exile.
2. Configure Game Path in the settings to allow log monitoring.
3. Customize Hotkeys for trade responses and scanner navigation.
4. Test the notification system via the "Test" button in settings.

🛠️ Developer & Build Guide

Prerequisites

• Java 8+
• Maven 3.6+
• Git
• Launch4j (optional, for Windows EXE generation)

🚀 Automated Release Process

The project uses GitHub Actions for automated builds and releases.

Creating a New Release

1. Git Tag (Recommended):

   git tag v1.8.1
   git push origin v1.8.1

2. Manual Trigger:
   • Go to Actions tab → Build and Release → Run workflow.

Build Artifacts

Each release automatically generates:

• MercuryChat-{version}-exe.zip (Windows executable)
• MercuryChat-{version}-jar.zip (Universal JAR)
• MercuryChat-{version}-lang.zip (Language files)

🔧 Local Development

Using Build Scripts

The repository includes scripts to simplify the build process:

• Windows: build_mercury.bat (Full) or build_mercury_simple.bat (Fast)
• Linux/macOS: ./build_mercury.sh (Full) or ./build_mercury_simple.sh (Fast)

Using Maven Directly

# Standard Maven Build
mvn clean package

# Build without running tests
mvn clean package -DskipTests

🐛 Troubleshooting

Issue	Resolution
Launch4j EXE fails	Ensure Launch4j is in your PATH. This is non-critical for JAR creation.
Missing Dependencies	Run mvn dependency:purge-local-repository to clear the cache.
Java Version Mismatch	Verify java -version is 8 or higher. JDK 8 is recommended for maximum compatibility.
UI Rendering Issues	Ensure all UI actions are wrapped in SwingUtilities.invokeLater().

---

Changelog

For a detailed history of changes, see CHANGELOG.md.

Recent Highlights

v1.8.1 - Stability Improvements

• Bug fixes, UI polish, and reliability improvements

v1.7.0 - Security & Build Improvements

• Comprehensive CodeQL security analysis integration

• Java 8 compatibility enhancements

• Maven multi-module build fixes

• GitHub Actions CI/CD improvements

• Deep refactoring of entire project for stability and performance

• v1.5.0: Community-requested feature enhancements for channel management.

---

MercuryChat
Path of Exile Chat Monitoring Utility

Download • Issues • Discussions • Wiki

Star History