Skip to content

onyxdigital-dev/WWM-Monitor

Repository files navigation

WWM Monitor

Real-time network monitor for Where Winds Meet
Live ping, jitter, packet loss, spike detection, server tracking & geo mapping — all in one overlay app.
Extremely lightweight — runs quietly in the background with near-zero CPU and memory impact on your game.

Latest Release Platform License


Download & Install

  1. Go to Releases
  2. Download WWM-Monitor-Setup-x.x.x.exe
  3. Run the installer — done. No Python or Node.js required.

Windows SmartScreen may warn you on first launch. Click "More info" → "Run anyway" — the app is safe.


Features

Live Tab

Feature Details
Live Ping Real-time ms display, color-coded green / yellow / red
Ping & Jitter Graph Last 50 pings visualized with spike markers
Packet Loss Sent / Received / Lost / Loss % counters
Router & DNS Ping Side-by-side ICMP latency for quick local diagnostics
Server Map Interactive world map showing your current game server location
Spike Alerts Desktop notification when ping exceeds your threshold

Dashboard Tab

Feature Details
Session Quality Score A–F grade derived from ping, jitter, and packet loss
Hourly Charts 24-hour ping and jitter trend over the day
Session History All past sessions with quality grade, avg/min/max ping, loss, spikes, and duration
Session Detail Click any session card to open a detail modal with ping and jitter graphs — hover over either graph to see the exact timestamp and ms value at that point
Server Switch Log Every time WWM moves you to a new server, logged with timestamps
CSV Export Download your full ping history as a spreadsheet

Overlay

Feature Details
In-Game Overlay Minimal always-on-top window showing live ping while you play
Configurable Hotkey Toggle overlay visibility with a custom keyboard shortcut
Customizable Columns Choose which metrics appear (ping, jitter, loss, sparkline)

How It Works

WWM Monitor detects the active Where Winds Meet process, reads the live game server IP from your TCP connections, and pings it every 2 seconds using ICMP — the same method as the Windows ping command — so the latency you see matches what the game actually experiences.

Launch WWM Monitor → Start Where Winds Meet → Done

The app sits in your system tray and keeps running in the background. It reconnects automatically when you start a new session or switch servers.


Data Persistence

All session history (ping data, jitter, events) is stored in a SQLite database at:

%APPDATA%\WWM Monitor\wwm_ping.db

This location is never touched by the installer, so your data is preserved across app updates.


Requirements


Settings

App Behavior

  • Start with Windows — launch automatically on boot
  • Start Minimized to Tray — launch silently to tray without showing the window
  • Minimize to Tray — keep running in the background when the window is closed

Monitoring

  • Ping Interval — how often to ping (1–5 seconds, default 2s)
  • Spike Threshold — ping (ms) at which a spike alert fires
  • Packet Loss Warning — loss % threshold for alerts
  • Warn / Critical Thresholds — customize graph color bands

Overlay

  • Overlay Hotkey — keyboard shortcut to show/hide the overlay
  • Show Jitter / Loss / Sparkline — toggle individual overlay columns

Changelog

v1.3.2

  • Session history database now stored in %APPDATA%\WWM Monitor\ — data is no longer wiped on app updates

v1.3.1

  • Switched game server ping from TCP connect to ICMP for more accurate latency readings (closer to actual in-game experience)
  • Session detail modal graphs now show hover tooltips with timestamp and ms value

v1.3.0

  • Session detail modal with ping and jitter graphs
  • Session notes
  • Hourly trend charts on Dashboard

Built With


Building from Source

git clone https://github.com/onyxdigital-dev/WWM-Monitor.git
cd WWM-Monitor
npm install
npm run build-all   # builds Python EXE + Electron NSIS installer

Requires Python 3.x and Node.js 18+ on the build machine.


Made with love by Onyx Digital

About

Real-time network monitor for Where Winds Meet

Resources

Stars

0 stars

Watchers

0 watching

Forks

Packages

 
 
 

Contributors