From 9fca6778db102be54bd82315518c867898a08b7e Mon Sep 17 00:00:00 2001 From: quasistatic-setup <76494705+quasistatic-setup@users.noreply.github.com> Date: Tue, 27 Oct 2026 11:55:14 +0100 Subject: [PATCH 01/54] feat(probe): isolate visible, hidden and warp cursor behaviors --- tools/probe/MouseLookProbe.cpp | 137 +++++++++++++++++++++++++++------ 1 file changed, 112 insertions(+), 25 deletions(-) diff --git a/tools/probe/MouseLookProbe.cpp b/tools/probe/MouseLookProbe.cpp index 9b71af1..6624064 100644 --- a/tools/probe/MouseLookProbe.cpp +++ b/tools/probe/MouseLookProbe.cpp @@ -32,6 +32,31 @@ constexpr UINT_PTR kTimerQuit = 2; constexpr UINT kLookPeriodMs = 10; // clamped to the ~15.6 ms timer tick, about a game frame constexpr long kJumpPx = 40; +// Each mode isolates a part of the input path. The original warp mode remains +// the default, including for existing scripted regression tests. +enum class ProbeMode { Visible, Hidden, Warp }; +constexpr int kModeVisibleId = 1001; +constexpr int kModeHiddenId = 1002; +constexpr int kModeWarpId = 1003; + +const wchar_t* ModeName(ProbeMode mode) { + switch (mode) { + case ProbeMode::Visible: return L"A: visible / no warp"; + case ProbeMode::Hidden: return L"B: hidden / no warp"; + case ProbeMode::Warp: return L"C: hidden + warp (WoW-like)"; + } + return L"unknown"; +} + +const char* ModeKey(ProbeMode mode) { + switch (mode) { + case ProbeMode::Visible: return "visible"; + case ProbeMode::Hidden: return "hidden"; + case ProbeMode::Warp: return "warp"; + } + return "unknown"; +} + struct Phase { int number = 0; wchar_t button = L'?'; @@ -45,6 +70,9 @@ struct Phase { }; HWND g_window = nullptr; +HWND g_modeButtons[3] {nullptr, nullptr, nullptr}; +ProbeMode g_mode = ProbeMode::Warp; +POINT g_previousPoint {0, 0}; FILE* g_log = nullptr; bool g_looking = false; int g_buttons = 0; @@ -94,9 +122,10 @@ void Sample() { return; } const long long readMs = QpcMs(); - const POINT anchor = AnchorScreen(); - const long dx = cursor.x - anchor.x; - const long dy = cursor.y - anchor.y; + const POINT reference = g_mode == ProbeMode::Warp ? AnchorScreen() : g_previousPoint; + const long dx = cursor.x - reference.x; + const long dy = cursor.y - reference.y; + if (g_mode != ProbeMode::Warp) g_previousPoint = cursor; ++g_phase.ticks; if (dx == 0 && dy == 0) { // Idle ticks are traced too: when a pointer update goes missing, the question is @@ -116,7 +145,7 @@ void Sample() { // Warp back immediately after reading, as a game loop does. Anything slow between the // read and the warp (logging, file flushes) would widen the window in which a pointer // update is overwritten, and make the probe report losses a real game would not have. - SetCursorPos(anchor.x, anchor.y); + if (g_mode == ProbeMode::Warp) SetCursorPos(reference.x, reference.y); g_yaw += dx; g_pitch += dy; LogF("%10.3f tick d=(%+ld,%+ld) cur=(%ld,%ld) qpc_ms=%lld%s\n", Elapsed(), dx, dy, @@ -125,12 +154,16 @@ void Sample() { void StartLook(wchar_t button) { GetCursorPos(&g_restore); - while (ShowCursor(FALSE) >= 0) { + g_previousPoint = g_restore; + if (g_mode != ProbeMode::Visible) { + while (ShowCursor(FALSE) >= 0) { + } } SetCapture(g_window); const POINT anchor = AnchorScreen(); - SetCursorPos(anchor.x, anchor.y); + if (g_mode == ProbeMode::Warp) SetCursorPos(anchor.x, anchor.y); + for (HWND buttonControl : g_modeButtons) EnableWindow(buttonControl, FALSE); g_looking = true; g_phase = Phase{}; @@ -139,8 +172,9 @@ void StartLook(wchar_t button) { g_phase.startTick = GetTickCount64(); SetTimer(g_window, kTimerLook, kLookPeriodMs, nullptr); - LogF("%10.3f LOOK-START #%d button=%lc restore=(%ld,%ld) anchor=(%ld,%ld)\n", - Elapsed(), g_phase.number, button, g_restore.x, g_restore.y, anchor.x, anchor.y); + LogF("%10.3f LOOK-START #%d button=%lc mode=%s restore=(%ld,%ld) anchor=(%ld,%ld)\n", + Elapsed(), g_phase.number, button, ModeKey(g_mode), g_restore.x, g_restore.y, + anchor.x, anchor.y); } void EndLook() { @@ -151,20 +185,26 @@ void EndLook() { g_looking = false; KillTimer(g_window, kTimerLook); - SetCursorPos(g_restore.x, g_restore.y); - while (ShowCursor(TRUE) < 0) { + // In mode A the visible cursor must continue normally after the drag. + if (g_mode != ProbeMode::Visible) { + SetCursorPos(g_restore.x, g_restore.y); + while (ShowCursor(TRUE) < 0) { + } } ReleaseCapture(); + for (HWND buttonControl : g_modeButtons) EnableWindow(buttonControl, TRUE); const ULONGLONG duration = GetTickCount64() - g_phase.startTick; - LogF("%10.3f PHASE #%d button=%lc ticks=%u motion_ticks=%u sum=(%+ld,%+ld) max_tick=%ld jumps40=%u duration_ms=%llu\n", - Elapsed(), g_phase.number, g_phase.button, g_phase.ticks, g_phase.motionTicks, + LogF("%10.3f PHASE #%d button=%lc mode=%s ticks=%u motion_ticks=%u sum=(%+ld,%+ld) max_tick=%ld jumps40=%u duration_ms=%llu\n", + Elapsed(), g_phase.number, g_phase.button, ModeKey(g_mode), + g_phase.ticks, g_phase.motionTicks, g_phase.sumX, g_phase.sumY, g_phase.maxTick, g_phase.jumps, static_cast(duration)); wchar_t buffer[256]; - swprintf(buffer, 256, L"#%d %lc: sum=(%+ld,%+ld) max_tick=%ld jumps=%u", - g_phase.number, g_phase.button, g_phase.sumX, g_phase.sumY, g_phase.maxTick, g_phase.jumps); + swprintf(buffer, 256, L"#%d %lc %ls: sum=(%+ld,%+ld) max_tick=%ld jumps=%u", + g_phase.number, g_phase.button, ModeName(g_mode), g_phase.sumX, + g_phase.sumY, g_phase.maxTick, g_phase.jumps); g_lastSummary = buffer; InvalidateRect(g_window, nullptr, TRUE); } @@ -192,25 +232,40 @@ void Paint(HWND hwnd) { wchar_t text[512]; swprintf(text, 512, - L"MouseLookProbe - stand-in for a game mouse-look loop\n\n" - L"Hold the left or right mouse button in this window to turn the camera.\n" + L"MouseLookProbe - TeamViewer input comparison\n\n" + L"Selected: %ls\n" + L"Hold left/right mouse button in the empty area to drag.\n" + L"Complete a short drag, release, then select another mode.\n" + L"Modes A/B have no cursor recentering; stop before screen edges.\n\n" L"yaw=%ld pitch=%ld phases=%d\n" L"last phase: %ls\n\n" L"Esc closes.", - g_yaw, g_pitch, g_phaseCount, g_lastSummary.c_str()); - RECT textRect {20, 20, client.right - 20, client.bottom - 20}; + ModeName(g_mode), g_yaw, g_pitch, g_phaseCount, g_lastSummary.c_str()); + RECT textRect {20, 150, client.right - 20, client.bottom - 20}; DrawTextW(dc, text, -1, &textRect, DT_LEFT | DT_TOP); - // Mark the anchor so a human tester can see where the warp goes. - MoveToEx(dc, kAnchorOffset.x - 10, kAnchorOffset.y, nullptr); - LineTo(dc, kAnchorOffset.x + 11, kAnchorOffset.y); - MoveToEx(dc, kAnchorOffset.x, kAnchorOffset.y - 10, nullptr); - LineTo(dc, kAnchorOffset.x, kAnchorOffset.y + 11); + // The cross is meaningful only in the legacy warp test mode. + if (g_mode == ProbeMode::Warp) { + MoveToEx(dc, kAnchorOffset.x - 10, kAnchorOffset.y, nullptr); + LineTo(dc, kAnchorOffset.x + 11, kAnchorOffset.y); + MoveToEx(dc, kAnchorOffset.x, kAnchorOffset.y - 10, nullptr); + LineTo(dc, kAnchorOffset.x, kAnchorOffset.y + 11); + } EndPaint(hwnd, &ps); } LRESULT CALLBACK WindowProc(HWND hwnd, UINT message, WPARAM wParam, LPARAM lParam) { switch (message) { + case WM_COMMAND: + if (HIWORD(wParam) == BN_CLICKED && !g_looking) { + if (LOWORD(wParam) == kModeVisibleId) g_mode = ProbeMode::Visible; + else if (LOWORD(wParam) == kModeHiddenId) g_mode = ProbeMode::Hidden; + else if (LOWORD(wParam) == kModeWarpId) g_mode = ProbeMode::Warp; + else break; + LogF("%10.3f MODE %s\n", Elapsed(), ModeKey(g_mode)); + InvalidateRect(hwnd, nullptr, TRUE); + } + return 0; case WM_LBUTTONDOWN: OnButtonDown(1, L'L'); return 0; case WM_RBUTTONDOWN: OnButtonDown(2, L'R'); return 0; case WM_LBUTTONUP: OnButtonUp(1); return 0; @@ -266,6 +321,17 @@ int WINAPI WinMain(HINSTANCE instance, HINSTANCE, LPSTR, int showCommand) { quitSeconds = static_cast(std::max(0L, std::wcstol(argv[++i], nullptr, 10))); } else if (arg == L"--log") { logPath = argv[++i]; + } else if (arg == L"--mode") { + const std::wstring value = argv[++i]; + if (value == L"visible") g_mode = ProbeMode::Visible; + else if (value == L"hidden") g_mode = ProbeMode::Hidden; + else if (value == L"warp") g_mode = ProbeMode::Warp; + else { + LocalFree(argv); + MessageBoxW(nullptr, L"Use --mode visible, hidden or warp.", + L"MouseLookProbe", MB_ICONERROR | MB_OK); + return 2; + } } } LocalFree(argv); @@ -280,8 +346,9 @@ int WINAPI WinMain(HINSTANCE instance, HINSTANCE, LPSTR, int showCommand) { #else g_log = _wfopen(logPath.c_str(), L"w"); #endif - LogF("# MouseLookProbe client=%dx%d anchor_offset=(%ld,%ld) jump=%ld look_period_ms=%u\n", - kClientWidth, kClientHeight, kAnchorOffset.x, kAnchorOffset.y, kJumpPx, kLookPeriodMs); + LogF("# MouseLookProbe client=%dx%d anchor_offset=(%ld,%ld) jump=%ld look_period_ms=%u initial_mode=%s\n", + kClientWidth, kClientHeight, kAnchorOffset.x, kAnchorOffset.y, kJumpPx, + kLookPeriodMs, ModeKey(g_mode)); WNDCLASSW windowClass {}; windowClass.lpfnWndProc = WindowProc; @@ -300,6 +367,26 @@ int WINAPI WinMain(HINSTANCE instance, HINSTANCE, LPSTR, int showCommand) { if (!g_window) { return 1; } + // Native radio buttons make the three experiments selectable without additional + // keyboard hooks, new dependencies, or edits to the WoW client. + const wchar_t* labels[] = { + L"A Visible cursor - no warp (character-select baseline)", + L"B Hidden cursor - no warp", + L"C Hidden cursor + warp (WoW-like, original probe mode)" + }; + const int ids[] = {kModeVisibleId, kModeHiddenId, kModeWarpId}; + const int selected = g_mode == ProbeMode::Visible ? 0 : + g_mode == ProbeMode::Hidden ? 1 : 2; + for (int i = 0; i < 3; ++i) { + g_modeButtons[i] = CreateWindowW(L"BUTTON", labels[i], + WS_CHILD | WS_VISIBLE | BS_AUTORADIOBUTTON | (i == 0 ? WS_GROUP : 0), + 20, 18 + i * 33, 620, 30, g_window, + reinterpret_cast(static_cast(ids[i])), instance, nullptr); + SendMessageW(g_modeButtons[i], WM_SETFONT, + reinterpret_cast(GetStockObject(DEFAULT_GUI_FONT)), TRUE); + SendMessageW(g_modeButtons[i], BM_SETCHECK, + i == selected ? BST_CHECKED : BST_UNCHECKED, 0); + } ShowWindow(g_window, showCommand); UpdateWindow(g_window); From 71c4a642fa79e41377499168e819af9817e09e53 Mon Sep 17 00:00:00 2001 From: quasistatic-setup <76494705+quasistatic-setup@users.noreply.github.com> Date: Tue, 27 Oct 2026 11:56:14 +0100 Subject: [PATCH 02/54] feat(ui): support explicit A/B test panel and live marker count --- include/rmf/Config.h | 1 + 1 file changed, 1 insertion(+) diff --git a/include/rmf/Config.h b/include/rmf/Config.h index 8d24c8a..bc7c71a 100644 --- a/include/rmf/Config.h +++ b/include/rmf/Config.h @@ -17,6 +17,7 @@ struct Config { // false: correction modes become available; the tool still starts with correction_mode. bool diagnosticMode = true; bool logMouseMoves = true; // false logs buttons/wheel/state only + bool showAbTestUi = false; // only affects the status panel; no input changes // --- correction (only effective with diagnostic_mode = false) --- CorrectionMode correctionMode = CorrectionMode::Off; // mode at startup From 60e925849bb43173e7ea16e267f2d852c06308ce Mon Sep 17 00:00:00 2001 From: quasistatic-setup <76494705+quasistatic-setup@users.noreply.github.com> Date: Tue, 27 Oct 2026 11:56:17 +0100 Subject: [PATCH 03/54] feat(ui): support explicit A/B test panel and live marker count --- src/Config.cpp | 3 +++ 1 file changed, 3 insertions(+) diff --git a/src/Config.cpp b/src/Config.cpp index cc76042..f2dc3f2 100644 --- a/src/Config.cpp +++ b/src/Config.cpp @@ -254,6 +254,9 @@ bool LoadConfig(const std::wstring& path, Config& cfg) { } else if (key == L"log_mouse_moves") { if (ParseBool(value, b)) cfg.logMouseMoves = b; else cfg.warnings.push_back(L"log_mouse_moves is not a boolean: " + value); + } else if (key == L"show_ab_test_ui") { + if (ParseBool(value, b)) cfg.showAbTestUi = b; + else cfg.warnings.push_back(L"show_ab_test_ui is not a boolean: " + value); } else if (key == L"log_directory") { cfg.logDirectory = value; } else if (key == L"log_file_prefix") { From bd0437916844bc49eb6ee6bf01bd3c1538f42c48 Mon Sep 17 00:00:00 2001 From: quasistatic-setup <76494705+quasistatic-setup@users.noreply.github.com> Date: Tue, 27 Oct 2026 11:56:20 +0100 Subject: [PATCH 04/54] feat(ui): support explicit A/B test panel and live marker count --- config/config-ab-test.json | 3 +++ 1 file changed, 3 insertions(+) diff --git a/config/config-ab-test.json b/config/config-ab-test.json index f621a80..e95d60a 100644 --- a/config/config-ab-test.json +++ b/config/config-ab-test.json @@ -10,6 +10,9 @@ "_log_mouse_moves": "false records buttons, wheel and state transitions only, which keeps logs small.", "log_mouse_moves": true, + "_show_ab_test_ui": "Show marker number and complete hotkeys in the A/B status panel.", + "show_ab_test_ui": true, + "_correction_mode": "Starts in absolute. Switch while running: Ctrl+Alt+1 absolute, Ctrl+Alt+2 relative, Ctrl+Alt+C off.", "correction_mode": "absolute", From 21c05020563fc2c8c84dfae0bd4c5b22c6a33e92 Mon Sep 17 00:00:00 2001 From: quasistatic-setup <76494705+quasistatic-setup@users.noreply.github.com> Date: Tue, 27 Oct 2026 11:56:22 +0100 Subject: [PATCH 05/54] feat(ui): support explicit A/B test panel and live marker count --- include/rmf/StatusView.h | 2 ++ 1 file changed, 2 insertions(+) diff --git a/include/rmf/StatusView.h b/include/rmf/StatusView.h index ca6a0dd..903b617 100644 --- a/include/rmf/StatusView.h +++ b/include/rmf/StatusView.h @@ -41,6 +41,8 @@ struct StatusSnapshot { GameState game = GameState::NotRunning; bool loggingPaused = false; bool correctionAllowed = false; + bool abTestUi = false; + unsigned markers = 0; CorrectionMode mode = CorrectionMode::Off; // Plain-language reason why no correction can run at all this session, e.g. the From fabcbdcd68593b39a6fe1d89196fa68aceaa3212 Mon Sep 17 00:00:00 2001 From: quasistatic-setup <76494705+quasistatic-setup@users.noreply.github.com> Date: Tue, 27 Oct 2026 11:56:25 +0100 Subject: [PATCH 06/54] feat(ui): surface A/B marker count and complete test hotkeys --- src/StatusView.cpp | 18 +++++++++++++----- 1 file changed, 13 insertions(+), 5 deletions(-) diff --git a/src/StatusView.cpp b/src/StatusView.cpp index c4e2fa0..a232ad5 100644 --- a/src/StatusView.cpp +++ b/src/StatusView.cpp @@ -228,6 +228,11 @@ std::vector StatusView::Render() const { } lines.push_back({snapshot_.problems > 0 ? yellow : grey, work}); + if (snapshot_.abTestUi) { + lines.push_back({grey, L" MARK #" + std::to_wstring(snapshot_.markers) + + L" Ctrl+Alt+M = mark the start of a test section in the log"}); + } + // ---- the one line that says what to do next ------------------------------------- std::wstring hint; const wchar_t* hintColour = grey; @@ -249,11 +254,14 @@ std::vector StatusView::Render() const { } lines.push_back({hintColour, L" NEXT > " + hint}); - lines.push_back({grey, snapshot_.correctionAllowed - ? L" KEYS Ctrl+Alt+1 fix on | Ctrl+Alt+C fix off | " - L"Ctrl+Alt+P pause log | Ctrl+Alt+Q quit" - : L" KEYS Ctrl+Alt+M mark the log | Ctrl+Alt+P pause log | " - L"Ctrl+Alt+Q quit"}); + if (snapshot_.abTestUi) { + lines.push_back({grey, L" MODES Ctrl+Alt+1 absolute | Ctrl+Alt+2 relative | Ctrl+Alt+C OFF"}); + lines.push_back({grey, L" KEYS Ctrl+Alt+M MARK | Ctrl+Alt+P pause log | Ctrl+Alt+Q quit"}); + } else { + lines.push_back({grey, snapshot_.correctionAllowed + ? L" KEYS Ctrl+Alt+1 fix on | Ctrl+Alt+2 relative | Ctrl+Alt+C fix off" + : L" KEYS Ctrl+Alt+M mark log | Ctrl+Alt+P pause log | Ctrl+Alt+Q quit"}); + } return lines; } From 468b89cfa86b10e3e5952b2db0a1b36a8ac76261 Mon Sep 17 00:00:00 2001 From: quasistatic-setup <76494705+quasistatic-setup@users.noreply.github.com> Date: Tue, 27 Oct 2026 11:56:28 +0100 Subject: [PATCH 07/54] feat(ui): support explicit A/B test panel and live marker count --- src/main.cpp | 12 ++++++++---- 1 file changed, 8 insertions(+), 4 deletions(-) diff --git a/src/main.cpp b/src/main.cpp index 0143191..56b9eaf 100644 --- a/src/main.cpp +++ b/src/main.cpp @@ -346,6 +346,7 @@ int main() { header.push_back(L"# config file : " + (cfg.loadedFrom.empty() ? L"" : cfg.loadedFrom)); header.push_back(L"# target process : " + cfg.targetProcess); header.push_back(L"# log mouse moves: " + std::wstring(cfg.logMouseMoves ? L"yes" : L"no")); + header.push_back(L"# A/B panel : " + std::wstring(cfg.showAbTestUi ? L"on" : L"off")); header.push_back(L"# diagnostic mode: " + std::wstring(cfg.diagnosticMode ? L"yes" : L"no")); header.push_back(L"# correction : " + (correction.allowed @@ -418,6 +419,7 @@ int main() { rmf::StatusSnapshot initial; initial.targetProcess = cfg.targetProcess; initial.correctionAllowed = correction.allowed; + initial.abTestUi = cfg.showAbTestUi; initial.lockReason = lockHint; initial.game = rmf::IsProcessRunning(cfg.targetProcess) ? rmf::GameState::Background @@ -620,6 +622,7 @@ int main() { std::atomic anchorCount {0}; std::atomic jumpCount {0}; std::atomic injectedCount {0}; + std::atomic markerCount {0}; std::thread writer([&] { rmf::ProcessNameCache names(cfg.targetProcess); @@ -733,6 +736,8 @@ int main() { snap.targetProcess = cfg.targetProcess; snap.loggingPaused = filter.paused.load(); snap.correctionAllowed = correction.allowed; + snap.abTestUi = cfg.showAbTestUi; + snap.markers = markerCount.load(std::memory_order_relaxed); snap.mode = correction.Mode(); snap.lockReason = lockHint; { @@ -817,7 +822,6 @@ int main() { // ---- message loop -------------------------------------------------------------------- // WH_MOUSE_LL callbacks are delivered on this thread, so this loop drives the hook and // must stay responsive. It also executes the correction output posted by the hook. - unsigned markerCounter = 0; long long smoothPendingX = 0; long long smoothPendingY = 0; @@ -957,16 +961,16 @@ int main() { if (msg.message == WM_HOTKEY) { switch (static_cast(msg.wParam)) { case kHotkeyMarker: { - ++markerCounter; + const unsigned markerNumber = markerCount.fetch_add(1, std::memory_order_relaxed) + 1; const rmf::StateSampler::Snapshot snap = sampler.Current(); LogLine(Format(L"## MARKER #%u at cursor=(%ld,%ld) cursor_visible=%ls clip=%ls correction=%ls", - markerCounter, snap.cursorPos.x, snap.cursorPos.y, + markerNumber, snap.cursorPos.x, snap.cursorPos.y, snap.cursorVisible ? L"yes" : L"no", snap.clipIsFullScreen ? L"released" : L"CONFINED", modeLabel())); FlushLog(); panel.Notice(rmf::NoticeLevel::Info, - Format(L"marker #%u written to the log", markerCounter)); + Format(L"marker #%u written to the log", markerNumber)); break; } case kHotkeyPause: { From ade88ba087fd799e767638afe25becceb0c7224e Mon Sep 17 00:00:00 2001 From: quasistatic-setup <76494705+quasistatic-setup@users.noreply.github.com> Date: Tue, 27 Oct 2026 11:57:59 +0100 Subject: [PATCH 08/54] fix(probe): handle unknown control notifications safely --- tools/probe/MouseLookProbe.cpp | 12 ++++++------ 1 file changed, 6 insertions(+), 6 deletions(-) diff --git a/tools/probe/MouseLookProbe.cpp b/tools/probe/MouseLookProbe.cpp index 6624064..a3fdeba 100644 --- a/tools/probe/MouseLookProbe.cpp +++ b/tools/probe/MouseLookProbe.cpp @@ -1,10 +1,9 @@ // MouseLookProbe - stand-in for a game's mouse-look loop, used to test RemoteMouseFix // without the game. // -// It reproduces the mechanism measured in WoW 3.3.5a (docs/findings-2026-09-12.md): on a -// button press it hides the cursor and warps it to a fixed, deliberately off-centre -// anchor; on a timer it reads the distance from that anchor as camera movement and warps -// back; on release it restores the cursor. Every phase is summarised in a log file. +// The original mode reproduces the WoW 3.3.5a cursor-warp mechanism +// (docs/findings-2026-09-12.md). Two additional modes isolate cursor visibility +// from cursor warping to compare TeamViewer behavior. All phases are logged. // // It reads the pointer through GetCursorPos. A game reading Raw Input would behave // differently, so a pass here proves the correction logic, not compatibility with a @@ -109,7 +108,8 @@ POINT AnchorScreen() { return anchor; } -// One "frame" of mouse-look: read the offset from the anchor, consume it, warp back. +// One sample: modes A/B read ordinary pointer deltas; mode C reads from its +// anchor and warps back as the game's camera loop does. long long QpcMs() { LARGE_INTEGER now {}; QueryPerformanceCounter(&now); @@ -261,7 +261,7 @@ LRESULT CALLBACK WindowProc(HWND hwnd, UINT message, WPARAM wParam, LPARAM lPara if (LOWORD(wParam) == kModeVisibleId) g_mode = ProbeMode::Visible; else if (LOWORD(wParam) == kModeHiddenId) g_mode = ProbeMode::Hidden; else if (LOWORD(wParam) == kModeWarpId) g_mode = ProbeMode::Warp; - else break; + else return 0; LogF("%10.3f MODE %s\n", Elapsed(), ModeKey(g_mode)); InvalidateRect(hwnd, nullptr, TRUE); } From febea0ef110aa505799850146954f7e4d1d7f9ee Mon Sep 17 00:00:00 2001 From: quasistatic-setup <76494705+quasistatic-setup@users.noreply.github.com> Date: Tue, 27 Oct 2026 11:59:00 +0100 Subject: [PATCH 09/54] ci: bundle MouseLookProbe with Windows diagnostic artifacts --- .github/workflows/build.yml | 3 +++ 1 file changed, 3 insertions(+) diff --git a/.github/workflows/build.yml b/.github/workflows/build.yml index 18ba7bb..d6433bb 100644 --- a/.github/workflows/build.yml +++ b/.github/workflows/build.yml @@ -24,6 +24,9 @@ jobs: - name: Stage the release layout run: cmake --install build --config Release --prefix stage/RemoteMouseFix-win-x64 + - name: Include MouseLookProbe in diagnostic artifact + run: Copy-Item build/bin/Release/MouseLookProbe.exe stage/RemoteMouseFix-win-x64/MouseLookProbe.exe + - name: Upload the build output uses: actions/upload-artifact@v4 with: From d784cde6d91d4464d8e3dd1070cf4ab1ad56afbc Mon Sep 17 00:00:00 2001 From: quasistatic-setup <76494705+quasistatic-setup@users.noreply.github.com> Date: Tue, 27 Oct 2026 12:00:22 +0100 Subject: [PATCH 10/54] docs: describe A/B marker panel and three probe modes --- README.md | 34 ++++++++++++++++++++++++++++++---- 1 file changed, 30 insertions(+), 4 deletions(-) diff --git a/README.md b/README.md index c0a3062..9550fac 100644 --- a/README.md +++ b/README.md @@ -82,8 +82,10 @@ the fix stopped itself. GAME * Wow.exe is in front FIX * on (absolute) - correcting the pointer WORK 20 jumps seen, 51 corrections applied + MARK #2 Ctrl+Alt+M = mark the start of a test section in the log NEXT > Everything is working. Ctrl+Alt+C switches the fix off at any time. - KEYS Ctrl+Alt+1 fix on | Ctrl+Alt+C fix off | Ctrl+Alt+P pause log | Ctrl+Alt+Q quit + MODES Ctrl+Alt+1 absolute | Ctrl+Alt+2 relative | Ctrl+Alt+C OFF + KEYS Ctrl+Alt+M MARK | Ctrl+Alt+P pause log | Ctrl+Alt+Q quit ``` `GAME` is yellow while the game is not running or while another window is in front: the @@ -95,11 +97,18 @@ names the one thing to do next. Set `NO_COLOR=1` for a monochrome panel. When the output is redirected to a file, the panel is printed once per change instead of being repainted. +The A/B profile additionally shows the number of markers written so far and all +test hotkeys. Each press of `Ctrl+Alt+M` creates the next numbered `## MARKER #N` +entry. Keep a short note of what each marker represents; a marker identifies a +section boundary, not its meaning. An immediate notice confirms each marker. + ### Controls | Hotkey | Effect | | --- | --- | | `Ctrl+Alt+C` | switch the correction off immediately | +| `Ctrl+Alt+M` | add a numbered marker to the log | +| `Ctrl+Alt+P` | pause/resume logging (correction continues) | | `Ctrl+Alt+1` | enable the recommended `absolute` correction | | `Ctrl+Alt+2` | enable the alternative `relative` correction | | `Ctrl+Alt+Q` | quit RemoteMouseFix cleanly | @@ -306,9 +315,26 @@ kind of input this check sends, so its filter, not the system, would decide the ## Developer test with MouseLookProbe -`MouseLookProbe.exe` reproduces the measured mouse-look mechanism without the game. It -hides the cursor on a button press, warps it to an off-centre anchor and records the summed -movement of each phase in `mouselook-probe.log`. +`MouseLookProbe.exe` has three selectable experiment modes to isolate why +TeamViewer pauses during mouse-look. The original hidden-cursor + warp behavior +remains the default, including for the automated script. + +| Probe mode | Cursor | Repeated `SetCursorPos` | Purpose | +| --- | --- | --- | --- | +| A – visible / no warp | visible | no | character-selection-like baseline | +| B – hidden / no warp | hidden | no | isolate cursor hiding | +| C – hidden + warp | hidden | yes | original WoW-like mouse-look simulation | + +Choose a radio button in the probe window before dragging. Hold the left or right +mouse button in the empty area, then release before switching modes. Modes A/B use +ordinary `GetCursorPos` deltas, so keep drags short to avoid the screen edge. +Each phase records its selected mode in `mouselook-probe.log`. The optional +`--mode visible|hidden|warp` selects the initial mode; `warp` is the default. + +Test A, B and C via TeamViewer first **without RemoteMouseFix targeting the probe**. +Pauses only in C suggest repeated cursor repositioning; pauses in B and C suggest +that hiding the cursor contributes. These are indicators rather than proof of +WoW behavior: the probe is only an approximation of the game's input loop. [tools/probe/emulate-remote.ps1](tools/probe/emulate-remote.ps1) starts both programs, injects a TeamViewer-shaped absolute stream and runs a click without motion, a steady drag From bf2efd9755c16c4786ca8ca82fe43daf7e72d134 Mon Sep 17 00:00:00 2001 From: quasistatic-setup <76494705+quasistatic-setup@users.noreply.github.com> Date: Tue, 27 Oct 2026 12:00:43 +0100 Subject: [PATCH 11/54] docs: record marker UI and three-mode probe verification --- CHANGELOG.md | 10 ++++++++++ 1 file changed, 10 insertions(+) diff --git a/CHANGELOG.md b/CHANGELOG.md index 9fd2fd8..9523f81 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -7,6 +7,16 @@ correction is still experimental. ## [Unreleased] +### Added + +- MouseLookProbe now provides visible/no-warp, hidden/no-warp and hidden/warp + modes to distinguish cursor hiding from cursor repositioning. The original + hidden/warp mode remains the default for automated regression testing. +- The A/B console displays Ctrl+Alt+M, the number of markers written and all + correction/diagnostic hotkeys. +- The CI diagnostic artifact includes MouseLookProbe.exe for direct tests. + + ## [0.7.0] - 2026-09-21 ### Added From 53b18b740d41ea9657af14c3629bb0fd6b124228 Mon Sep 17 00:00:00 2001 From: quasistatic-setup <76494705+quasistatic-setup@users.noreply.github.com> Date: Tue, 27 Oct 2026 12:00:46 +0100 Subject: [PATCH 12/54] docs: record marker UI and three-mode probe verification --- docs/diagnostics.md | 19 +++++++++++++++++++ 1 file changed, 19 insertions(+) diff --git a/docs/diagnostics.md b/docs/diagnostics.md index 6e4cd7a..a97e242 100644 --- a/docs/diagnostics.md +++ b/docs/diagnostics.md @@ -210,3 +210,22 @@ delta. `own seen` should track `applied` closely in both correction modes. mode the `OWN` position must equal `target`. In `relative` mode the `OWN` move's offset from the anchor (`anc=`) shows what pointer speed and acceleration made of `rd`; comparing the two measures the acceleration distortion directly. + +## MouseLookProbe three-mode comparison + +Select a radio button in `MouseLookProbe.exe` before holding the mouse button: +A = visible cursor with no `SetCursorPos`, B = hidden cursor without +`SetCursorPos`, C = hidden cursor with repeated `SetCursorPos` to an +off-centre anchor. C remains the old/default behavior. + +Perform comparable short drags over TeamViewer and release between modes. +In A/B the pointer can reach the screen edge. The probe records the +`mode=visible|hidden|warp` in each `LOOK-START` and `PHASE` line, plus a +`MODE` line on every selection change. Idle samples alone do not prove that +the operator continued moving their mouse. + +First run the probe without RemoteMouseFix correcting it. If later capturing +low-level input timing with RemoteMouseFix, configure a separate copy of the +A/B profile with `target_process=MouseLookProbe.exe` and an isolated log +folder. This test compares cursor behavior; it does not establish that the +probe matches every detail of WoW's mouse input. From 2225fead1de238f07f6915b68b9d2d941b7cdd80 Mon Sep 17 00:00:00 2001 From: quasistatic-setup <76494705+quasistatic-setup@users.noreply.github.com> Date: Tue, 27 Oct 2026 12:37:06 +0100 Subject: [PATCH 13/54] feat(ab): allow interactive or CLI target executable override per session --- src/main.cpp | 58 ++++++++++++++++++++++++++++++++++++++++++++++++++-- 1 file changed, 56 insertions(+), 2 deletions(-) diff --git a/src/main.cpp b/src/main.cpp index 56b9eaf..fba3f0b 100644 --- a/src/main.cpp +++ b/src/main.cpp @@ -210,6 +210,8 @@ int main() { // ---- command line -------------------------------------------------------------- std::wstring configPath; + std::wstring targetOverride; + bool chooseTarget = false; unsigned runSeconds = 0; // 0 = run until the operator stops the tool { int argc = 0; @@ -218,8 +220,11 @@ int main() { const std::wstring arg = argv[i]; if (arg == L"--help" || arg == L"-h" || arg == L"/?") { ConsoleOut(L"RemoteMouseFix %ls - diagnostics with optional correction\n\n" - L"Usage: RemoteMouseFix.exe [path\\to\\config.json] [--seconds N]\n\n" - L" --seconds N stop automatically after N seconds (0 = run until stopped)\n\n" + L"Usage: RemoteMouseFix.exe [path\\to\\config.json] [--seconds N]\n" + L" [--target-process Name.exe] [--choose-target]\n\n" + L" --seconds N stop automatically after N seconds\n" + L" --target-process EXE override the configured process name for this run\n" + L" --choose-target prompt for a process name at startup\n\n" L"Hotkeys while running:\n" L" Ctrl+Alt+M write a marker line into the log\n" L" Ctrl+Alt+P pause / resume logging (correction keeps running)\n" @@ -236,6 +241,19 @@ int main() { runSeconds = static_cast(std::max(0L, std::wcstol(argv[++i], nullptr, 10))); continue; } + if (arg == L"--target-process") { + if (i + 1 >= argc) { + ConsoleOut(L"ERROR: --target-process requires a filename such as MouseLookProbe.exe\n"); + LocalFree(argv); + return 2; + } + targetOverride = argv[++i]; + continue; + } + if (arg == L"--choose-target") { + chooseTarget = true; + continue; + } if (configPath.empty() && !arg.empty() && arg[0] != L'-') { configPath = arg; } @@ -261,6 +279,42 @@ int main() { rmf::Config cfg; rmf::LoadConfig(configPath, cfg); + // Select by executable BASENAME only: the existing foreground PID/process-name + // checks remain responsible for restricting capture and correction to that process. + // Never launch an executable or accept an arbitrary path as the target. + auto validTarget = [](const std::wstring& name) { + return name.size() >= 5 && + name.find_first_of(L"<>:\"/\\|?*") == std::wstring::npos && + name.front() != L' ' && name.back() != L' ' && + CompareStringOrdinal(name.c_str() + name.size() - 4, 4, + L".exe", 4, TRUE) == CSTR_EQUAL; + }; + if (chooseTarget && targetOverride.empty()) { + ConsoleOut(L"\n A/B TEST: target executable\n" + L" Enter the executable filename, not a path.\n" + L" Examples: Wow.exe or MouseLookProbe.exe\n" + L" Press Enter to keep [%ls]: ", cfg.targetProcess.c_str()); + wchar_t input[260] {}; + DWORD charsRead = 0; + if (!ReadConsoleW(GetStdHandle(STD_INPUT_HANDLE), input, 259, &charsRead, nullptr)) { + ConsoleOut(L"\nERROR: target selection needs an interactive console.\n"); + return 2; + } + std::wstring selected(input, static_cast(charsRead)); + const auto end = selected.find_first_of(L"\r\n"); + if (end != std::wstring::npos) selected.erase(end); + if (!selected.empty()) targetOverride = selected; + } + if (!targetOverride.empty()) { + if (!validTarget(targetOverride)) { + ConsoleOut(L"ERROR: invalid executable name '%ls'. Use a filename ending in .exe, " + L"without a directory path.\n", targetOverride.c_str()); + return 2; + } + cfg.targetProcess = targetOverride; // session override, never writes the JSON profile + } + ConsoleOut(L" Target for this session: %ls\n", cfg.targetProcess.c_str()); + SetConsoleTitleW(cfg.diagnosticMode ? L"RemoteMouseFix " RMF_VERSION_W L" - DIAGNOSTIC ONLY" : L"RemoteMouseFix " RMF_VERSION_W L" - A/B CORRECTION TEST"); From d7be1df3fa23ef4ad240dfb9e7beb53c39384bf3 Mon Sep 17 00:00:00 2001 From: quasistatic-setup <76494705+quasistatic-setup@users.noreply.github.com> Date: Tue, 27 Oct 2026 12:37:25 +0100 Subject: [PATCH 14/54] feat(ab): prompt for target executable when launcher is double-clicked --- config/Start-AB-Test.cmd | 13 ++++++++++++- 1 file changed, 12 insertions(+), 1 deletion(-) diff --git a/config/Start-AB-Test.cmd b/config/Start-AB-Test.cmd index 0298090..77e778a 100644 --- a/config/Start-AB-Test.cmd +++ b/config/Start-AB-Test.cmd @@ -1,4 +1,15 @@ @echo off setlocal title RemoteMouseFix A/B correction test -"%~dp0RemoteMouseFix.exe" "%~dp0config\config-ab-test.json" %* + +rem Interactive target selection on a double-click; explicit CLI flags bypass the prompt. +if "%~1"=="" ( + "%~dp0RemoteMouseFix.exe" "%~dp0config\config-ab-test.json" --choose-target +) else ( + "%~dp0RemoteMouseFix.exe" "%~dp0config\config-ab-test.json" %* +) +if errorlevel 1 ( + echo. + echo RemoteMouseFix could not start. Review the error above. + pause +) From cea8ecb73ec890eb87b855315551223016c0cb71 Mon Sep 17 00:00:00 2001 From: quasistatic-setup <76494705+quasistatic-setup@users.noreply.github.com> Date: Tue, 27 Oct 2026 12:37:54 +0100 Subject: [PATCH 15/54] ui(ab): name selected executable as TARGET in status panel --- src/StatusView.cpp | 13 ++++++++----- 1 file changed, 8 insertions(+), 5 deletions(-) diff --git a/src/StatusView.cpp b/src/StatusView.cpp index a232ad5..a915190 100644 --- a/src/StatusView.cpp +++ b/src/StatusView.cpp @@ -187,16 +187,17 @@ std::vector StatusView::Render() const { std::vector lines; - // ---- the game window ---------------------------------------------------------- + // ---- selected application ----------------------------------------------------- + const wchar_t* targetLabel = snapshot_.abTestUi ? L"TARGET" : L"GAME "; switch (snapshot_.game) { case GameState::NotRunning: - lines.push_back({yellow, L" GAME o " + game + L" is not running yet"}); + lines.push_back({yellow, std::wstring(L" ") + targetLabel + L" o " + game + L" is not running yet"}); break; case GameState::Background: lines.push_back({yellow, L" GAME o " + game + L" is running, but another window is in front"}); break; case GameState::Foreground: - lines.push_back({green, L" GAME * " + game + L" is in front"}); + lines.push_back({green, std::wstring(L" ") + targetLabel + L" * " + game + L" is in front"}); break; } @@ -242,9 +243,11 @@ std::vector StatusView::Render() const { } else if (locked) { hint = L"Nothing is being changed. Start-AB-Test.cmd is the profile that corrects."; } else if (snapshot_.game == GameState::NotRunning) { - hint = L"Start the game now. This panel follows along."; + hint = snapshot_.abTestUi ? L"Start the selected application now." + : L"Start the game now. This panel follows along."; } else if (!inFront) { - hint = L"Click into the game window; the top line turns green."; + hint = snapshot_.abTestUi ? L"Click into the target window; the top line turns green." + : L"Click into the game window; the top line turns green."; } else if (!correcting) { hint = L"Press Ctrl+Alt+1 to switch the fix on."; } else if (snapshot_.corrections == 0) { From eb727a25e4be403e7ea818ff04b0985effec856e Mon Sep 17 00:00:00 2001 From: quasistatic-setup <76494705+quasistatic-setup@users.noreply.github.com> Date: Tue, 27 Oct 2026 12:38:13 +0100 Subject: [PATCH 16/54] docs: explain runtime target EXE selection for A/B tests --- README.md | 19 ++++++++++++++++--- 1 file changed, 16 insertions(+), 3 deletions(-) diff --git a/README.md b/README.md index 9550fac..f3d76d0 100644 --- a/README.md +++ b/README.md @@ -79,7 +79,7 @@ colour repeats the answer: green means working, yellow means waiting for you, re the fix stopped itself. ```text - GAME * Wow.exe is in front + TARGET * Wow.exe is in front FIX * on (absolute) - correcting the pointer WORK 20 jumps seen, 51 corrections applied MARK #2 Ctrl+Alt+M = mark the start of a test section in the log @@ -97,6 +97,19 @@ names the one thing to do next. Set `NO_COLOR=1` for a monochrome panel. When the output is redirected to a file, the panel is printed once per change instead of being repainted. +The A/B launcher prompts for the executable name when double-clicked. +Press Enter to keep `Wow.exe` from the configured profile or type a different +filename such as `MouseLookProbe.exe` (no path). This choice lasts only for +that run and never changes the JSON file. The selected target is shown as +`TARGET` in the A/B panel; the fix operates only while that executable is +foreground, under the original cursor and safety gates. The executable may be +started after RemoteMouseFix. + +For scripted or unattended runs, supply `--target-process MouseLookProbe.exe` +to `Start-AB-Test.cmd` to bypass the interactive question. When launching the +EXE directly, the optional `--choose-target` flag enables the same prompt. +Without either flag, the configured `target_process` remains in effect. + The A/B profile additionally shows the number of markers written so far and all test hotkeys. Each press of `Ctrl+Alt+M` creates the next numbered `## MARKER #N` entry. Keep a short note of what each marker represents; a marker identifies a @@ -241,7 +254,7 @@ The release EXE is statically linked and depends only on Windows system librarie the first command-line argument: ```text -RemoteMouseFix.exe [path\to\config.json] [--seconds N] +RemoteMouseFix.exe [path\to\config.json] [--seconds N] [--target-process Name.exe] [--choose-target] ``` A relative name that is not found beside the EXE is looked up in `config\` as well, so a @@ -251,7 +264,7 @@ Keys beginning with `_` in the supplied configuration files are explanatory comm | Key | Built-in default | Meaning | | --- | --- | --- | -| `target_process` | `Wow.exe` | executable to observe, matched case-insensitively | +| `target_process` | `Wow.exe` | target executable name, case-insensitive; A/B startup selection overrides it only for that run | | `diagnostic_mode` | `true` | `true` prevents all correction; `false` permits correction modes | | `correction_mode` | `off` | startup mode: `off`, `absolute` or `relative` | | `watchdog_max_hidden_ms` | `180000` | hidden cursor duration before correction is disabled; `0` disables this check | From 9688046df3877bc8ee88d490f325544d795eb40b Mon Sep 17 00:00:00 2001 From: quasistatic-setup <76494705+quasistatic-setup@users.noreply.github.com> Date: Tue, 27 Oct 2026 12:38:41 +0100 Subject: [PATCH 17/54] ui(ab): consistently label non-WoW target status --- src/StatusView.cpp | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/src/StatusView.cpp b/src/StatusView.cpp index a915190..f2a49a7 100644 --- a/src/StatusView.cpp +++ b/src/StatusView.cpp @@ -194,7 +194,7 @@ std::vector StatusView::Render() const { lines.push_back({yellow, std::wstring(L" ") + targetLabel + L" o " + game + L" is not running yet"}); break; case GameState::Background: - lines.push_back({yellow, L" GAME o " + game + L" is running, but another window is in front"}); + lines.push_back({yellow, std::wstring(L" ") + targetLabel + L" o " + game + L" is running, but another window is in front"}); break; case GameState::Foreground: lines.push_back({green, std::wstring(L" ") + targetLabel + L" * " + game + L" is in front"}); From 5a24f082d66a6b767449c435ede555008aa8eb1b Mon Sep 17 00:00:00 2001 From: quasistatic-setup <76494705+quasistatic-setup@users.noreply.github.com> Date: Tue, 27 Oct 2026 12:39:01 +0100 Subject: [PATCH 18/54] docs: record generic executable selection --- CHANGELOG.md | 3 +++ 1 file changed, 3 insertions(+) diff --git a/CHANGELOG.md b/CHANGELOG.md index 9523f81..630bb4d 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -12,6 +12,9 @@ correction is still experimental. - MouseLookProbe now provides visible/no-warp, hidden/no-warp and hidden/warp modes to distinguish cursor hiding from cursor repositioning. The original hidden/warp mode remains the default for automated regression testing. +- The A/B launcher asks for the target executable basename (default Wow.exe), + with an optional --target-process override for scripts. The target is shown + in the status panel and only applies to the current session. - The A/B console displays Ctrl+Alt+M, the number of markers written and all correction/diagnostic hotkeys. - The CI diagnostic artifact includes MouseLookProbe.exe for direct tests. From 581256f127a1fc13451d2c1d88b65cab9b6a0564 Mon Sep 17 00:00:00 2001 From: quasistatic-setup <76494705+quasistatic-setup@users.noreply.github.com> Date: Tue, 27 Oct 2026 12:39:05 +0100 Subject: [PATCH 19/54] docs: record generic executable selection --- docs/diagnostics.md | 10 ++++++++++ 1 file changed, 10 insertions(+) diff --git a/docs/diagnostics.md b/docs/diagnostics.md index a97e242..e712bc6 100644 --- a/docs/diagnostics.md +++ b/docs/diagnostics.md @@ -229,3 +229,13 @@ low-level input timing with RemoteMouseFix, configure a separate copy of the A/B profile with `target_process=MouseLookProbe.exe` and an isolated log folder. This test compares cursor behavior; it does not establish that the probe matches every detail of WoW's mouse input. + +### Capturing another target application + +Double-click `Start-AB-Test.cmd` and enter the executable filename (e.g. +`MouseLookProbe.exe`) at the startup prompt, or press Enter for `Wow.exe`. +This overrides the configured target for this session; no executable is started +automatically and no JSON file is rewritten. To bypass the prompt in scripts, +invoke `Start-AB-Test.cmd --target-process MouseLookProbe.exe`. +The A/B panel shows the selected `TARGET`. The original foreground, hidden-cursor, +injected-move-only and emergency-hotkey safety conditions still apply. From 9a79639c7d0d6541e942935ca39ddb712030e221 Mon Sep 17 00:00:00 2001 From: quasistatic-setup <76494705+quasistatic-setup@users.noreply.github.com> Date: Tue, 27 Oct 2026 12:40:32 +0100 Subject: [PATCH 20/54] docs: clarify TARGET label for A/B executable selection --- README.md | 7 ++++--- 1 file changed, 4 insertions(+), 3 deletions(-) diff --git a/README.md b/README.md index f3d76d0..592a5d6 100644 --- a/README.md +++ b/README.md @@ -88,9 +88,10 @@ the fix stopped itself. KEYS Ctrl+Alt+M MARK | Ctrl+Alt+P pause log | Ctrl+Alt+Q quit ``` -`GAME` is yellow while the game is not running or while another window is in front: the -fix only works on the window you are actually playing in, so clicking into the game is -what turns this line green. `FIX` turns red when a watchdog switched the correction off, +`TARGET` in A/B mode (or `GAME` in the normal profile) is yellow while the +selected executable is not running or another window is in front. The fix only +works while that target window is in the foreground, so switching to it turns +the line green. `FIX` turns red when a watchdog switched the correction off, and then says why; that state stays on screen instead of scrolling away. `NEXT` always names the one thing to do next. From 835af6d1c74b5a0275173e73b8de1dfd840a8f55 Mon Sep 17 00:00:00 2001 From: quasistatic-setup <76494705+quasistatic-setup@users.noreply.github.com> Date: Tue, 27 Oct 2026 12:46:16 +0100 Subject: [PATCH 21/54] feat(ab): load target EXE from AB-Test.ini instead of prompting --- src/main.cpp | 76 ++++++++++++++++++---------------------------------- 1 file changed, 26 insertions(+), 50 deletions(-) diff --git a/src/main.cpp b/src/main.cpp index fba3f0b..0d05f28 100644 --- a/src/main.cpp +++ b/src/main.cpp @@ -210,8 +210,6 @@ int main() { // ---- command line -------------------------------------------------------------- std::wstring configPath; - std::wstring targetOverride; - bool chooseTarget = false; unsigned runSeconds = 0; // 0 = run until the operator stops the tool { int argc = 0; @@ -220,11 +218,9 @@ int main() { const std::wstring arg = argv[i]; if (arg == L"--help" || arg == L"-h" || arg == L"/?") { ConsoleOut(L"RemoteMouseFix %ls - diagnostics with optional correction\n\n" - L"Usage: RemoteMouseFix.exe [path\\to\\config.json] [--seconds N]\n" - L" [--target-process Name.exe] [--choose-target]\n\n" - L" --seconds N stop automatically after N seconds\n" - L" --target-process EXE override the configured process name for this run\n" - L" --choose-target prompt for a process name at startup\n\n" + L"Usage: RemoteMouseFix.exe [path\\to\\config.json] [--seconds N]\n\n" + L" --seconds N stop automatically after N seconds (0 = run until stopped)\n" + L" A/B target is read from AB-Test.ini beside the executable.\n\n" L"Hotkeys while running:\n" L" Ctrl+Alt+M write a marker line into the log\n" L" Ctrl+Alt+P pause / resume logging (correction keeps running)\n" @@ -241,19 +237,6 @@ int main() { runSeconds = static_cast(std::max(0L, std::wcstol(argv[++i], nullptr, 10))); continue; } - if (arg == L"--target-process") { - if (i + 1 >= argc) { - ConsoleOut(L"ERROR: --target-process requires a filename such as MouseLookProbe.exe\n"); - LocalFree(argv); - return 2; - } - targetOverride = argv[++i]; - continue; - } - if (arg == L"--choose-target") { - chooseTarget = true; - continue; - } if (configPath.empty() && !arg.empty() && arg[0] != L'-') { configPath = arg; } @@ -279,41 +262,34 @@ int main() { rmf::Config cfg; rmf::LoadConfig(configPath, cfg); - // Select by executable BASENAME only: the existing foreground PID/process-name - // checks remain responsible for restricting capture and correction to that process. - // Never launch an executable or accept an arbitrary path as the target. - auto validTarget = [](const std::wstring& name) { - return name.size() >= 5 && - name.find_first_of(L"<>:\"/\\|?*") == std::wstring::npos && - name.front() != L' ' && name.back() != L' ' && - CompareStringOrdinal(name.c_str() + name.size() - 4, 4, - L".exe", 4, TRUE) == CSTR_EQUAL; - }; - if (chooseTarget && targetOverride.empty()) { - ConsoleOut(L"\n A/B TEST: target executable\n" - L" Enter the executable filename, not a path.\n" - L" Examples: Wow.exe or MouseLookProbe.exe\n" - L" Press Enter to keep [%ls]: ", cfg.targetProcess.c_str()); - wchar_t input[260] {}; - DWORD charsRead = 0; - if (!ReadConsoleW(GetStdHandle(STD_INPUT_HANDLE), input, 259, &charsRead, nullptr)) { - ConsoleOut(L"\nERROR: target selection needs an interactive console.\n"); + // The A/B profile alone may select a different target through a simple INI file. + // Keep the executable basename validation: all original foreground, hidden-cursor + // and injected-input safety gates remain unchanged. Nothing starts the target EXE. + if (cfg.showAbTestUi) { + const std::wstring iniPath = rmf::ResolveAgainstExeDir(L"AB-Test.ini"); + if (!FileExists(iniPath)) { + ConsoleOut(L"ERROR: AB-Test.ini is missing beside RemoteMouseFix.exe.\n" + L" Restore it from the test package; no correction started.\n"); return 2; } - std::wstring selected(input, static_cast(charsRead)); - const auto end = selected.find_first_of(L"\r\n"); - if (end != std::wstring::npos) selected.erase(end); - if (!selected.empty()) targetOverride = selected; - } - if (!targetOverride.empty()) { - if (!validTarget(targetOverride)) { - ConsoleOut(L"ERROR: invalid executable name '%ls'. Use a filename ending in .exe, " - L"without a directory path.\n", targetOverride.c_str()); + + wchar_t selected[260] {}; + const DWORD len = GetPrivateProfileStringW( + L"Target", L"Executable", L"", selected, 260, iniPath.c_str()); + const std::wstring target(selected, static_cast(len)); + const bool valid = target.size() >= 5 && target.size() <= 255 && + target.find_first_of(L"<>:\\"/\\\\|?*\\r\\n\\t") == std::wstring::npos && + target.front() != L' ' && target.back() != L' ' && + CompareStringOrdinal(target.c_str() + target.size() - 4, 4, + L".exe", 4, TRUE) == CSTR_EQUAL; + if (!valid) { + ConsoleOut(L"ERROR: invalid [Target] Executable in AB-Test.ini.\n" + L" Enter a filename like Wow.exe or MouseLookProbe.exe (no path).\n"); return 2; } - cfg.targetProcess = targetOverride; // session override, never writes the JSON profile + cfg.targetProcess = target; + ConsoleOut(L" A/B target (AB-Test.ini): %ls\n", cfg.targetProcess.c_str()); } - ConsoleOut(L" Target for this session: %ls\n", cfg.targetProcess.c_str()); SetConsoleTitleW(cfg.diagnosticMode ? L"RemoteMouseFix " RMF_VERSION_W L" - DIAGNOSTIC ONLY" From 85a69c6d4bbc529c3e9047d0e47371bd7783d03c Mon Sep 17 00:00:00 2001 From: quasistatic-setup <76494705+quasistatic-setup@users.noreply.github.com> Date: Tue, 27 Oct 2026 12:46:43 +0100 Subject: [PATCH 22/54] fix(ab): validate INI executable basename safely --- src/main.cpp | 7 ++++++- 1 file changed, 6 insertions(+), 1 deletion(-) diff --git a/src/main.cpp b/src/main.cpp index 0d05f28..77033ad 100644 --- a/src/main.cpp +++ b/src/main.cpp @@ -277,8 +277,13 @@ int main() { const DWORD len = GetPrivateProfileStringW( L"Target", L"Executable", L"", selected, 260, iniPath.c_str()); const std::wstring target(selected, static_cast(len)); + const bool invalidCharacters = std::any_of(target.begin(), target.end(), [](wchar_t ch) { + return ch < 32 || ch == L'<' || ch == L'>' || ch == L':' || + ch == L'"' || ch == L'/' || ch == L'\\' || ch == L'|' || + ch == L'?' || ch == L'*'; + }); const bool valid = target.size() >= 5 && target.size() <= 255 && - target.find_first_of(L"<>:\\"/\\\\|?*\\r\\n\\t") == std::wstring::npos && + !invalidCharacters && target.front() != L' ' && target.back() != L' ' && CompareStringOrdinal(target.c_str() + target.size() - 4, 4, L".exe", 4, TRUE) == CSTR_EQUAL; From 113dc7f498a131c6eb924fa45be87bd307893909 Mon Sep 17 00:00:00 2001 From: quasistatic-setup <76494705+quasistatic-setup@users.noreply.github.com> Date: Tue, 27 Oct 2026 12:46:57 +0100 Subject: [PATCH 23/54] feat(ab): provide editable INI target selection for test profile --- config/AB-Test.ini | 7 +++++++ 1 file changed, 7 insertions(+) create mode 100644 config/AB-Test.ini diff --git a/config/AB-Test.ini b/config/AB-Test.ini new file mode 100644 index 0000000..9ec01cd --- /dev/null +++ b/config/AB-Test.ini @@ -0,0 +1,7 @@ +; RemoteMouseFix A/B test - executable to observe/correct. +; Change only the filename. Do not add a path or quotes. +; Examples: Wow.exe, MouseLookProbe.exe +; Edit this file while RemoteMouseFix is stopped; the change applies on next start. + +[Target] +Executable=Wow.exe From b544815d23321459fc63eb20ac24fdb52a2272c3 Mon Sep 17 00:00:00 2001 From: quasistatic-setup <76494705+quasistatic-setup@users.noreply.github.com> Date: Tue, 27 Oct 2026 12:47:12 +0100 Subject: [PATCH 24/54] chore(ab): start directly using INI target instead of prompting --- config/Start-AB-Test.cmd | 8 +------- 1 file changed, 1 insertion(+), 7 deletions(-) diff --git a/config/Start-AB-Test.cmd b/config/Start-AB-Test.cmd index 77e778a..25058c3 100644 --- a/config/Start-AB-Test.cmd +++ b/config/Start-AB-Test.cmd @@ -1,13 +1,7 @@ @echo off setlocal title RemoteMouseFix A/B correction test - -rem Interactive target selection on a double-click; explicit CLI flags bypass the prompt. -if "%~1"=="" ( - "%~dp0RemoteMouseFix.exe" "%~dp0config\config-ab-test.json" --choose-target -) else ( - "%~dp0RemoteMouseFix.exe" "%~dp0config\config-ab-test.json" %* -) +"%~dp0RemoteMouseFix.exe" "%~dp0config\config-ab-test.json" %* if errorlevel 1 ( echo. echo RemoteMouseFix could not start. Review the error above. From 9b42bc048fa0530aef2eb8fafd7141b23d657c3b Mon Sep 17 00:00:00 2001 From: quasistatic-setup <76494705+quasistatic-setup@users.noreply.github.com> Date: Tue, 27 Oct 2026 12:47:14 +0100 Subject: [PATCH 25/54] build: package AB-Test.ini beside executable --- CMakeLists.txt | 2 ++ 1 file changed, 2 insertions(+) diff --git a/CMakeLists.txt b/CMakeLists.txt index d4e08e7..afbcfbf 100644 --- a/CMakeLists.txt +++ b/CMakeLists.txt @@ -84,6 +84,7 @@ add_custom_command(TARGET RemoteMouseFix POST_BUILD COMMAND ${CMAKE_COMMAND} -E copy_if_different "${CMAKE_SOURCE_DIR}/config/Start-AB-Test.cmd" "${CMAKE_SOURCE_DIR}/config/Start-Playing.cmd" + "${CMAKE_SOURCE_DIR}/config/AB-Test.ini" "$" COMMENT "Staging the shipped layout next to RemoteMouseFix.exe") @@ -108,6 +109,7 @@ install(TARGETS RemoteMouseFix InputEchoCheck RUNTIME DESTINATION .) install(FILES config/Start-AB-Test.cmd config/Start-Playing.cmd + config/AB-Test.ini README.md LICENSE DESTINATION .) install(FILES From 1ab1ddb62c8eb747a6bebc78a1420463d7c07440 Mon Sep 17 00:00:00 2001 From: quasistatic-setup <76494705+quasistatic-setup@users.noreply.github.com> Date: Tue, 27 Oct 2026 12:48:04 +0100 Subject: [PATCH 26/54] docs(ab): explain persistent target selection in AB-Test.ini --- README.md | 40 ++++++++++++++++++++++++---------------- 1 file changed, 24 insertions(+), 16 deletions(-) diff --git a/README.md b/README.md index 592a5d6..d6bd414 100644 --- a/README.md +++ b/README.md @@ -98,18 +98,25 @@ names the one thing to do next. Set `NO_COLOR=1` for a monochrome panel. When the output is redirected to a file, the panel is printed once per change instead of being repainted. -The A/B launcher prompts for the executable name when double-clicked. -Press Enter to keep `Wow.exe` from the configured profile or type a different -filename such as `MouseLookProbe.exe` (no path). This choice lasts only for -that run and never changes the JSON file. The selected target is shown as -`TARGET` in the A/B panel; the fix operates only while that executable is -foreground, under the original cursor and safety gates. The executable may be -started after RemoteMouseFix. - -For scripted or unattended runs, supply `--target-process MouseLookProbe.exe` -to `Start-AB-Test.cmd` to bypass the interactive question. When launching the -EXE directly, the optional `--choose-target` flag enables the same prompt. -Without either flag, the configured `target_process` remains in effect. +For the A/B test, edit `AB-Test.ini` beside `RemoteMouseFix.exe` before +starting `Start-AB-Test.cmd`: + +```ini +[Target] +Executable=Wow.exe +``` + +To test another application, replace only `Wow.exe` with its filename, e.g. +`MouseLookProbe.exe`, save the file, then run the launcher normally. No +startup question is shown. The value persists between runs; there is no need +to edit the JSON profile. Only an executable **filename** ending in `.exe` +is accepted, never a path. If the INI is missing or invalid, the A/B launcher +stops with a clear error before starting correction. + +This INI affects the A/B profile only. The normal playing and diagnostic +profiles continue using their JSON `target_process`. The selected executable +is displayed as `TARGET` in A/B mode and the existing foreground and +hidden-cursor safety rules still apply. The A/B profile additionally shows the number of markers written so far and all test hotkeys. Each press of `Ctrl+Alt+M` creates the next numbered `## MARKER #N` @@ -154,8 +161,9 @@ input or text, and it has no upload or network feature. You decide whether to sh 1. Start the game and move to a quiet, safe location. 2. Double-click `Start-AB-Test.cmd` from the RemoteMouseFix folder. -3. Confirm that the console names `config-ab-test.json` and that the panel shows - `FIX` on with `absolute`, and `GAME` turning green when you click into the game. +3. Confirm that the console names `config-ab-test.json`, that `TARGET` shows + the executable from `AB-Test.ini`, and that `FIX` is on with `absolute`. + `TARGET` turns green when you click into the chosen application. 4. Test the same actions in each mode: `absolute`, `off`, then `relative`. Use `Ctrl+Alt+1`, `Ctrl+Alt+C` and `Ctrl+Alt+2` to select the modes. 5. Before every action, press `Ctrl+Alt+M` to add a marker to the log: @@ -255,7 +263,7 @@ The release EXE is statically linked and depends only on Windows system librarie the first command-line argument: ```text -RemoteMouseFix.exe [path\to\config.json] [--seconds N] [--target-process Name.exe] [--choose-target] +RemoteMouseFix.exe [path\to\config.json] [--seconds N] ``` A relative name that is not found beside the EXE is looked up in `config\` as well, so a @@ -265,7 +273,7 @@ Keys beginning with `_` in the supplied configuration files are explanatory comm | Key | Built-in default | Meaning | | --- | --- | --- | -| `target_process` | `Wow.exe` | target executable name, case-insensitive; A/B startup selection overrides it only for that run | +| `target_process` | `Wow.exe` | target executable name; the A/B profile takes its target from `AB-Test.ini` instead | | `diagnostic_mode` | `true` | `true` prevents all correction; `false` permits correction modes | | `correction_mode` | `off` | startup mode: `off`, `absolute` or `relative` | | `watchdog_max_hidden_ms` | `180000` | hidden cursor duration before correction is disabled; `0` disables this check | From e4f0655e3fef7e9e4cf3844ad46452b7822f2f4b Mon Sep 17 00:00:00 2001 From: quasistatic-setup <76494705+quasistatic-setup@users.noreply.github.com> Date: Tue, 27 Oct 2026 12:48:08 +0100 Subject: [PATCH 27/54] docs(ab): explain persistent target selection in AB-Test.ini --- docs/diagnostics.md | 27 +++++++++++++++++---------- 1 file changed, 17 insertions(+), 10 deletions(-) diff --git a/docs/diagnostics.md b/docs/diagnostics.md index e712bc6..78f2101 100644 --- a/docs/diagnostics.md +++ b/docs/diagnostics.md @@ -225,17 +225,24 @@ In A/B the pointer can reach the screen edge. The probe records the the operator continued moving their mouse. First run the probe without RemoteMouseFix correcting it. If later capturing -low-level input timing with RemoteMouseFix, configure a separate copy of the -A/B profile with `target_process=MouseLookProbe.exe` and an isolated log -folder. This test compares cursor behavior; it does not establish that the +low-level input timing with RemoteMouseFix, set `Executable=MouseLookProbe.exe` in `AB-Test.ini` +and use an isolated log folder when preserving historical traces. This test compares cursor behavior; it does not establish that the probe matches every detail of WoW's mouse input. ### Capturing another target application -Double-click `Start-AB-Test.cmd` and enter the executable filename (e.g. -`MouseLookProbe.exe`) at the startup prompt, or press Enter for `Wow.exe`. -This overrides the configured target for this session; no executable is started -automatically and no JSON file is rewritten. To bypass the prompt in scripts, -invoke `Start-AB-Test.cmd --target-process MouseLookProbe.exe`. -The A/B panel shows the selected `TARGET`. The original foreground, hidden-cursor, -injected-move-only and emergency-hotkey safety conditions still apply. +Edit `AB-Test.ini` next to `RemoteMouseFix.exe` before starting +`Start-AB-Test.cmd`: + +```ini +[Target] +Executable=MouseLookProbe.exe +``` + +The shipped value is `Wow.exe`. The file is read at each A/B startup; there +is no interactive selection or JSON edit. A missing INI or invalid filename +is a clear error and prevents the tool from starting correction. Only a +filename ending in `.exe` is accepted, not a path. The A/B panel shows +the selected `TARGET`. The regular gameplay and diagnostic profiles still +use their existing JSON target. Foreground, hidden-cursor, injected-move-only +and emergency-hotkey safety conditions are unchanged. From e92972efdf1012d9e22784e5d7a43e151565cfe9 Mon Sep 17 00:00:00 2001 From: quasistatic-setup <76494705+quasistatic-setup@users.noreply.github.com> Date: Tue, 27 Oct 2026 12:48:11 +0100 Subject: [PATCH 28/54] docs(ab): explain persistent target selection in AB-Test.ini --- CHANGELOG.md | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/CHANGELOG.md b/CHANGELOG.md index 630bb4d..95345e5 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -12,9 +12,9 @@ correction is still experimental. - MouseLookProbe now provides visible/no-warp, hidden/no-warp and hidden/warp modes to distinguish cursor hiding from cursor repositioning. The original hidden/warp mode remains the default for automated regression testing. -- The A/B launcher asks for the target executable basename (default Wow.exe), - with an optional --target-process override for scripts. The target is shown - in the status panel and only applies to the current session. +- The A/B launcher reads the target executable filename from editable + `AB-Test.ini` beside the EXE (default `Wow.exe`), without prompting at + startup or modifying other profiles. Invalid INI values fail safely. - The A/B console displays Ctrl+Alt+M, the number of markers written and all correction/diagnostic hotkeys. - The CI diagnostic artifact includes MouseLookProbe.exe for direct tests. From cdd97754900a19873fa463072c81ce39da0f1813 Mon Sep 17 00:00:00 2001 From: quasistatic-setup <76494705+quasistatic-setup@users.noreply.github.com> Date: Tue, 27 Oct 2026 12:48:16 +0100 Subject: [PATCH 29/54] docs(ab): explain persistent target selection in AB-Test.ini --- config/config-ab-test.json | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/config/config-ab-test.json b/config/config-ab-test.json index e95d60a..8dba700 100644 --- a/config/config-ab-test.json +++ b/config/config-ab-test.json @@ -1,7 +1,7 @@ { "_about": "RemoteMouseFix A/B test configuration: absolute correction starts immediately and can be switched by hotkey. Keys starting with _ are comments.", - "_target_process": "Executable to observe, matched case-insensitively on the file name.", + "_target_process": "For A/B tests, edit AB-Test.ini beside RemoteMouseFix.exe instead. Other JSON profiles still use target_process.", "target_process": "Wow.exe", "_diagnostic_mode": "true: input is never modified and no correction mode can be enabled. false: correction modes become available (see config-ab-test.json).", From 4eca037debbad3a3a9c314b50063fbf27c4dc944 Mon Sep 17 00:00:00 2001 From: quasistatic-setup <76494705+quasistatic-setup@users.noreply.github.com> Date: Tue, 27 Oct 2026 13:01:46 +0100 Subject: [PATCH 30/54] feat(target): prepare shared INI and optional full-image-path target matching --- include/rmf/Config.h | 2 ++ 1 file changed, 2 insertions(+) diff --git a/include/rmf/Config.h b/include/rmf/Config.h index bc7c71a..286a7c2 100644 --- a/include/rmf/Config.h +++ b/include/rmf/Config.h @@ -18,6 +18,8 @@ struct Config { bool diagnosticMode = true; bool logMouseMoves = true; // false logs buttons/wheel/state only bool showAbTestUi = false; // only affects the status panel; no input changes + std::wstring targetIniSection; // AB-Test or Playing; empty = use JSON target + std::wstring targetPath; // optional exact image path (not just basename) // --- correction (only effective with diagnostic_mode = false) --- CorrectionMode correctionMode = CorrectionMode::Off; // mode at startup From 79ece05b54a4bf5c5f26f55f153e1c5c38cecbb7 Mon Sep 17 00:00:00 2001 From: quasistatic-setup <76494705+quasistatic-setup@users.noreply.github.com> Date: Tue, 27 Oct 2026 13:01:49 +0100 Subject: [PATCH 31/54] feat(target): prepare shared INI and optional full-image-path target matching --- src/Config.cpp | 5 ++++- 1 file changed, 4 insertions(+), 1 deletion(-) diff --git a/src/Config.cpp b/src/Config.cpp index f2dc3f2..a133028 100644 --- a/src/Config.cpp +++ b/src/Config.cpp @@ -242,7 +242,10 @@ bool LoadConfig(const std::wstring& path, Config& cfg) { std::uint64_t u = 0; int i = 0; - if (key == L"target_process") { + if (key == L"target_ini_section") { + if (value == L"AB-Test" || value == L"Playing") cfg.targetIniSection = value; + else cfg.warnings.push_back(L"invalid target_ini_section (expected AB-Test or Playing): " + value); + } else if (key == L"target_process") { if (value.empty()) { cfg.warnings.push_back(L"target_process is empty, keeping " + cfg.targetProcess); } else { From 2cfdf7782f42a2cd31aa6ba2c94e7dac403194d5 Mon Sep 17 00:00:00 2001 From: quasistatic-setup <76494705+quasistatic-setup@users.noreply.github.com> Date: Tue, 27 Oct 2026 13:01:53 +0100 Subject: [PATCH 32/54] feat(target): prepare shared INI and optional full-image-path target matching --- include/rmf/ProcessInfo.h | 5 +++-- 1 file changed, 3 insertions(+), 2 deletions(-) diff --git a/include/rmf/ProcessInfo.h b/include/rmf/ProcessInfo.h index 53e16a0..70d9692 100644 --- a/include/rmf/ProcessInfo.h +++ b/include/rmf/ProcessInfo.h @@ -12,7 +12,7 @@ namespace rmf { // foreground state alone cannot make, and the one users read wrong most often. // // Walks the process list, so it belongs on a slow timer, never in the hook callback. -bool IsProcessRunning(const std::wstring& imageFileName); +bool IsProcessRunning(const std::wstring& imageFileName, const std::wstring& fullImagePath = {}); // Caches PID -> image file name so the writer thread never pays for a process query // twice, and so the hook thread can take a fast "is this even the target" decision. @@ -22,7 +22,7 @@ bool IsProcessRunning(const std::wstring& imageFileName); // no longer matches. class ProcessNameCache { public: - explicit ProcessNameCache(std::wstring targetProcessName); + explicit ProcessNameCache(std::wstring targetProcessName, std::wstring fullImagePath = {}); // File name only (e.g. "Wow.exe"), or an empty string when it cannot be determined. const std::wstring& NameForPid(DWORD pid); @@ -47,6 +47,7 @@ class ProcessNameCache { Entry& Resolve(DWORD pid); std::wstring target_; + std::wstring targetPath_; std::unordered_map cache_; std::wstring empty_; bool sawAccessDenied_ = false; From 93a3731eac066f71c686bac096eb7ff546510046 Mon Sep 17 00:00:00 2001 From: quasistatic-setup <76494705+quasistatic-setup@users.noreply.github.com> Date: Tue, 27 Oct 2026 13:01:56 +0100 Subject: [PATCH 33/54] feat(target): prepare shared INI and optional full-image-path target matching --- src/ProcessInfo.cpp | 22 ++++++++++++++++------ 1 file changed, 16 insertions(+), 6 deletions(-) diff --git a/src/ProcessInfo.cpp b/src/ProcessInfo.cpp index ebad9a0..c198e95 100644 --- a/src/ProcessInfo.cpp +++ b/src/ProcessInfo.cpp @@ -34,7 +34,7 @@ bool GetProcessCreateTime(DWORD pid, FILETIME& out) { } // namespace -bool IsProcessRunning(const std::wstring& imageFileName) { +bool IsProcessRunning(const std::wstring& imageFileName, const std::wstring& fullImagePath) { if (imageFileName.empty()) { return false; } @@ -48,8 +48,17 @@ bool IsProcessRunning(const std::wstring& imageFileName) { if (Process32FirstW(snapshot, &entry)) { do { if (EqualsIgnoreCase(entry.szExeFile, imageFileName)) { - found = true; - break; + if (fullImagePath.empty()) { + found = true; + break; + } + std::wstring imagePath; + bool accessDenied = false; + if (QueryProcessImagePath(entry.th32ProcessID, imagePath, accessDenied) && + EqualsIgnoreCase(imagePath, fullImagePath)) { + found = true; + break; + } } } while (Process32NextW(snapshot, &entry)); } @@ -57,8 +66,8 @@ bool IsProcessRunning(const std::wstring& imageFileName) { return found; } -ProcessNameCache::ProcessNameCache(std::wstring targetProcessName) - : target_(std::move(targetProcessName)) {} +ProcessNameCache::ProcessNameCache(std::wstring targetProcessName, std::wstring fullImagePath) + : target_(std::move(targetProcessName)), targetPath_(std::move(fullImagePath)) {} ProcessNameCache::Entry& ProcessNameCache::Resolve(DWORD pid) { auto it = cache_.find(pid); @@ -87,7 +96,8 @@ ProcessNameCache::Entry& ProcessNameCache::Resolve(DWORD pid) { bool accessDenied = false; if (QueryProcessImagePath(pid, path, accessDenied)) { entry.name = FileNameOf(path); - entry.isTarget = EqualsIgnoreCase(entry.name, target_); + entry.isTarget = EqualsIgnoreCase(entry.name, target_) && + (targetPath_.empty() || EqualsIgnoreCase(path, targetPath_)); entry.haveCreateTime = GetProcessCreateTime(pid, entry.createTime); } else if (accessDenied) { sawAccessDenied_ = true; From 1f303f4eb74169309cad781d918b41b57d741ec5 Mon Sep 17 00:00:00 2001 From: quasistatic-setup <76494705+quasistatic-setup@users.noreply.github.com> Date: Tue, 27 Oct 2026 13:02:34 +0100 Subject: [PATCH 34/54] feat(config): read A/B and playing targets as name or path from shared INI --- src/main.cpp | 93 ++++++++++++++++++++++++++++++++++++---------------- 1 file changed, 64 insertions(+), 29 deletions(-) diff --git a/src/main.cpp b/src/main.cpp index 77033ad..1f229bc 100644 --- a/src/main.cpp +++ b/src/main.cpp @@ -220,7 +220,7 @@ int main() { ConsoleOut(L"RemoteMouseFix %ls - diagnostics with optional correction\n\n" L"Usage: RemoteMouseFix.exe [path\\to\\config.json] [--seconds N]\n\n" L" --seconds N stop automatically after N seconds (0 = run until stopped)\n" - L" A/B target is read from AB-Test.ini beside the executable.\n\n" + L" A/B and Playing targets are read from RemoteMouseFix.ini.\n\n" L"Hotkeys while running:\n" L" Ctrl+Alt+M write a marker line into the log\n" L" Ctrl+Alt+P pause / resume logging (correction keeps running)\n" @@ -262,38 +262,71 @@ int main() { rmf::Config cfg; rmf::LoadConfig(configPath, cfg); - // The A/B profile alone may select a different target through a simple INI file. - // Keep the executable basename validation: all original foreground, hidden-cursor - // and injected-input safety gates remain unchanged. Nothing starts the target EXE. - if (cfg.showAbTestUi) { - const std::wstring iniPath = rmf::ResolveAgainstExeDir(L"AB-Test.ini"); + // Each gameplay profile opts into its own section of the common INI. A full + // path is matched against the running process image, not used to launch it. + // Missing/invalid INI fails closed before installing a mouse hook. + if (!cfg.targetIniSection.empty()) { + const std::wstring iniPath = rmf::ResolveAgainstExeDir(L"RemoteMouseFix.ini"); if (!FileExists(iniPath)) { - ConsoleOut(L"ERROR: AB-Test.ini is missing beside RemoteMouseFix.exe.\n" - L" Restore it from the test package; no correction started.\n"); + ConsoleOut(L"ERROR: RemoteMouseFix.ini is missing beside RemoteMouseFix.exe.\n" + L" Restore it from the package; no correction started.\n"); return 2; } - - wchar_t selected[260] {}; - const DWORD len = GetPrivateProfileStringW( - L"Target", L"Executable", L"", selected, 260, iniPath.c_str()); + wchar_t selected[32768] {}; + const DWORD len = GetPrivateProfileStringW(cfg.targetIniSection.c_str(), + L"Executable", L"", selected, 32768, iniPath.c_str()); const std::wstring target(selected, static_cast(len)); + if (target.empty() || len >= 32767) { + ConsoleOut(L"ERROR: [%ls] Executable in RemoteMouseFix.ini is missing or too long.\n", + cfg.targetIniSection.c_str()); + return 2; + } const bool invalidCharacters = std::any_of(target.begin(), target.end(), [](wchar_t ch) { - return ch < 32 || ch == L'<' || ch == L'>' || ch == L':' || - ch == L'"' || ch == L'/' || ch == L'\\' || ch == L'|' || - ch == L'?' || ch == L'*'; + return ch < 32 || ch == L'<' || ch == L'>' || ch == L'"' || + ch == L'|' || ch == L'?' || ch == L'*'; }); - const bool valid = target.size() >= 5 && target.size() <= 255 && - !invalidCharacters && - target.front() != L' ' && target.back() != L' ' && - CompareStringOrdinal(target.c_str() + target.size() - 4, 4, - L".exe", 4, TRUE) == CSTR_EQUAL; - if (!valid) { - ConsoleOut(L"ERROR: invalid [Target] Executable in AB-Test.ini.\n" - L" Enter a filename like Wow.exe or MouseLookProbe.exe (no path).\n"); + const bool hasPathSeparator = target.find_first_of(L"\\/") != std::wstring::npos; + const bool absoluteDrivePath = + target.size() >= 6 && ((target[0] >= L'A' && target[0] <= L'Z') || + (target[0] >= L'a' && target[0] <= L'z')) && + target[1] == L':' && (target[2] == L'\\' || target[2] == L'/'); + const bool uncPath = target.size() >= 7 && + (target[0] == L'\\' || target[0] == L'/') && + (target[1] == L'\\' || target[1] == L'/'); + const bool hasPath = hasPathSeparator || target.find(L':') != std::wstring::npos; + if (invalidCharacters || target.front() == L' ' || target.back() == L' ' || + (hasPath && !(absoluteDrivePath || uncPath)) || target.back() == L'\\' || + target.back() == L'/') { + ConsoleOut(L"ERROR: invalid [%ls] Executable in RemoteMouseFix.ini.\n" + L" Use Name.exe or a full absolute path such as C:\\Games\\MyGame.exe.\n", + cfg.targetIniSection.c_str()); + return 2; + } + std::wstring filename = target; + if (hasPath) { + // Normalize relative components such as ".." in a configured absolute path. + std::wstring expanded(32768, L'\0'); + const DWORD size = GetFullPathNameW(target.c_str(), + static_cast(expanded.size()), expanded.data(), nullptr); + if (size == 0 || size >= expanded.size()) { + ConsoleOut(L"ERROR: cannot resolve target path in RemoteMouseFix.ini.\n"); + return 2; + } + expanded.resize(size); + std::replace(expanded.begin(), expanded.end(), L'/', L'\\'); + cfg.targetPath = std::move(expanded); + filename = cfg.targetPath.substr(cfg.targetPath.find_last_of(L"\\/") + 1); + } + if (filename.size() < 5 || + CompareStringOrdinal(filename.c_str() + filename.size() - 4, 4, + L".exe", 4, TRUE) != CSTR_EQUAL || + filename.find_first_of(L":\\/") != std::wstring::npos) { + ConsoleOut(L"ERROR: [%ls] target must end with an .exe filename.\n", + cfg.targetIniSection.c_str()); return 2; } - cfg.targetProcess = target; - ConsoleOut(L" A/B target (AB-Test.ini): %ls\n", cfg.targetProcess.c_str()); + cfg.targetProcess = filename; + ConsoleOut(L" target from [%ls]: %ls\n", cfg.targetIniSection.c_str(), target.c_str()); } SetConsoleTitleW(cfg.diagnosticMode @@ -380,6 +413,7 @@ int main() { header.push_back(L"# elevated : " + std::wstring(elevated ? L"yes" : L"no")); header.push_back(L"# config file : " + (cfg.loadedFrom.empty() ? L"" : cfg.loadedFrom)); header.push_back(L"# target process : " + cfg.targetProcess); + if (!cfg.targetPath.empty()) header.push_back(L"# target image : " + cfg.targetPath); header.push_back(L"# log mouse moves: " + std::wstring(cfg.logMouseMoves ? L"yes" : L"no")); header.push_back(L"# A/B panel : " + std::wstring(cfg.showAbTestUi ? L"on" : L"off")); header.push_back(L"# diagnostic mode: " + std::wstring(cfg.diagnosticMode ? L"yes" : L"no")); @@ -433,6 +467,7 @@ int main() { } ConsoleOut(L" target process : %ls\n", cfg.targetProcess.c_str()); + if (!cfg.targetPath.empty()) ConsoleOut(L" target image : %ls\n", cfg.targetPath.c_str()); ConsoleOut(L" config file : %ls\n", cfg.loadedFrom.empty() ? L"" : cfg.loadedFrom.c_str()); ConsoleOut(L" run profile : %ls\n", @@ -456,7 +491,7 @@ int main() { initial.correctionAllowed = correction.allowed; initial.abTestUi = cfg.showAbTestUi; initial.lockReason = lockHint; - initial.game = rmf::IsProcessRunning(cfg.targetProcess) + initial.game = rmf::IsProcessRunning(cfg.targetProcess, cfg.targetPath) ? rmf::GameState::Background : rmf::GameState::NotRunning; panel.Start(cfg.consoleStatusIntervalMs > 0, initial); @@ -489,7 +524,7 @@ int main() { }; // ---- state sampler ----------------------------------------------------------------- - rmf::ProcessNameCache samplerNames(cfg.targetProcess); + rmf::ProcessNameCache samplerNames(cfg.targetProcess, cfg.targetPath); std::atomic targetInForeground {false}; std::atomic cursorHeldByTarget {false}; @@ -660,7 +695,7 @@ int main() { std::atomic markerCount {0}; std::thread writer([&] { - rmf::ProcessNameCache names(cfg.targetProcess); + rmf::ProcessNameCache names(cfg.targetProcess, cfg.targetPath); POINT previousPt {0, 0}; bool havePrevious = false; @@ -787,7 +822,7 @@ int main() { // "has the game been started at all" changes slowly. const ULONGLONG tick = GetTickCount64(); if (lastProcessScan == 0 || tick - lastProcessScan >= 2000) { - gameRunning = rmf::IsProcessRunning(cfg.targetProcess); + gameRunning = rmf::IsProcessRunning(cfg.targetProcess, cfg.targetPath); lastProcessScan = tick; } snap.game = gameRunning ? rmf::GameState::Background : rmf::GameState::NotRunning; From aeb47679bcf1313fcf9584f0236189e18e22ef8c Mon Sep 17 00:00:00 2001 From: quasistatic-setup <76494705+quasistatic-setup@users.noreply.github.com> Date: Tue, 27 Oct 2026 13:02:58 +0100 Subject: [PATCH 35/54] config: use [AB-Test] section of shared INI --- config/config-ab-test.json | 4 +++- 1 file changed, 3 insertions(+), 1 deletion(-) diff --git a/config/config-ab-test.json b/config/config-ab-test.json index 8dba700..c1daa94 100644 --- a/config/config-ab-test.json +++ b/config/config-ab-test.json @@ -1,8 +1,10 @@ { "_about": "RemoteMouseFix A/B test configuration: absolute correction starts immediately and can be switched by hotkey. Keys starting with _ are comments.", - "_target_process": "For A/B tests, edit AB-Test.ini beside RemoteMouseFix.exe instead. Other JSON profiles still use target_process.", + "_target_process": "A/B target is set in [AB-Test] of RemoteMouseFix.ini beside the EXE.", "target_process": "Wow.exe", + "_target_ini_section": "Read the target from [AB-Test] in RemoteMouseFix.ini beside the EXE, supporting a filename or full executable path.", + "target_ini_section": "AB-Test", "_diagnostic_mode": "true: input is never modified and no correction mode can be enabled. false: correction modes become available (see config-ab-test.json).", "diagnostic_mode": false, From 01957a9d8c0c10f2c2da685a4cfdebbb9e351782 Mon Sep 17 00:00:00 2001 From: quasistatic-setup <76494705+quasistatic-setup@users.noreply.github.com> Date: Tue, 27 Oct 2026 13:03:01 +0100 Subject: [PATCH 36/54] config: use [Playing] section of shared INI --- config/config-play.json | 2 ++ 1 file changed, 2 insertions(+) diff --git a/config/config-play.json b/config/config-play.json index 7e15e5c..1506597 100644 --- a/config/config-play.json +++ b/config/config-play.json @@ -2,6 +2,8 @@ "_about": "RemoteMouseFix gameplay configuration: absolute correction starts immediately. Keys starting with _ are comments.", "target_process": "Wow.exe", + "_target_ini_section": "Read the target from [Playing] in RemoteMouseFix.ini beside the EXE, supporting a filename or full executable path.", + "target_ini_section": "Playing", "diagnostic_mode": false, "log_mouse_moves": false, "correction_mode": "absolute", From e6b158be6d7bdbace1efdf870fc7e62ae657eaee Mon Sep 17 00:00:00 2001 From: quasistatic-setup <76494705+quasistatic-setup@users.noreply.github.com> Date: Tue, 27 Oct 2026 13:03:07 +0100 Subject: [PATCH 37/54] feat(config): separate A/B and playing targets in shared INI --- config/RemoteMouseFix.ini | 12 ++++++++++++ 1 file changed, 12 insertions(+) create mode 100644 config/RemoteMouseFix.ini diff --git a/config/RemoteMouseFix.ini b/config/RemoteMouseFix.ini new file mode 100644 index 0000000..c71b40a --- /dev/null +++ b/config/RemoteMouseFix.ini @@ -0,0 +1,12 @@ +; RemoteMouseFix target selection. Save changes before starting a launcher. +; Give the EXE filename OR a complete Windows path to the game EXE. +; A full path limits correction to the matching game installation. +; This tool does NOT launch the executable. +; Example: Executable=C:\Games\World of Warcraft\Wow.exe +; Example: Executable=D:\Games\AnotherGame\Game.exe + +[AB-Test] +Executable=Wow.exe + +[Playing] +Executable=Wow.exe From fedaa8e4eb5a446a70e52a43d930555705f4de67 Mon Sep 17 00:00:00 2001 From: quasistatic-setup <76494705+quasistatic-setup@users.noreply.github.com> Date: Tue, 27 Oct 2026 13:03:11 +0100 Subject: [PATCH 38/54] chore(config): replace single-profile AB-Test.ini with shared INI --- config/AB-Test.ini | 7 ------- 1 file changed, 7 deletions(-) delete mode 100644 config/AB-Test.ini diff --git a/config/AB-Test.ini b/config/AB-Test.ini deleted file mode 100644 index 9ec01cd..0000000 --- a/config/AB-Test.ini +++ /dev/null @@ -1,7 +0,0 @@ -; RemoteMouseFix A/B test - executable to observe/correct. -; Change only the filename. Do not add a path or quotes. -; Examples: Wow.exe, MouseLookProbe.exe -; Edit this file while RemoteMouseFix is stopped; the change applies on next start. - -[Target] -Executable=Wow.exe From d46cd70c2f1339297dd4c5ead41af108abacc16d Mon Sep 17 00:00:00 2001 From: quasistatic-setup <76494705+quasistatic-setup@users.noreply.github.com> Date: Tue, 27 Oct 2026 13:03:29 +0100 Subject: [PATCH 39/54] build: ship shared RemoteMouseFix.ini with both launchers --- CMakeLists.txt | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/CMakeLists.txt b/CMakeLists.txt index afbcfbf..1bfa8c3 100644 --- a/CMakeLists.txt +++ b/CMakeLists.txt @@ -84,7 +84,7 @@ add_custom_command(TARGET RemoteMouseFix POST_BUILD COMMAND ${CMAKE_COMMAND} -E copy_if_different "${CMAKE_SOURCE_DIR}/config/Start-AB-Test.cmd" "${CMAKE_SOURCE_DIR}/config/Start-Playing.cmd" - "${CMAKE_SOURCE_DIR}/config/AB-Test.ini" + "${CMAKE_SOURCE_DIR}/config/RemoteMouseFix.ini" "$" COMMENT "Staging the shipped layout next to RemoteMouseFix.exe") @@ -109,7 +109,7 @@ install(TARGETS RemoteMouseFix InputEchoCheck RUNTIME DESTINATION .) install(FILES config/Start-AB-Test.cmd config/Start-Playing.cmd - config/AB-Test.ini + config/RemoteMouseFix.ini README.md LICENSE DESTINATION .) install(FILES From fd8ab2acb78b842d03f0e91c1787e764389cff51 Mon Sep 17 00:00:00 2001 From: quasistatic-setup <76494705+quasistatic-setup@users.noreply.github.com> Date: Tue, 27 Oct 2026 13:04:27 +0100 Subject: [PATCH 40/54] docs: configure independent A/B and playing targets by filename or path --- README.md | 41 ++++++++++++++++++++++++----------------- 1 file changed, 24 insertions(+), 17 deletions(-) diff --git a/README.md b/README.md index d6bd414..c55c503 100644 --- a/README.md +++ b/README.md @@ -98,25 +98,31 @@ names the one thing to do next. Set `NO_COLOR=1` for a monochrome panel. When the output is redirected to a file, the panel is printed once per change instead of being repainted. -For the A/B test, edit `AB-Test.ini` beside `RemoteMouseFix.exe` before -starting `Start-AB-Test.cmd`: +Both launchers read their own section of `RemoteMouseFix.ini` next to +`RemoteMouseFix.exe`: ```ini -[Target] -Executable=Wow.exe -``` +[AB-Test] +Executable=MouseLookProbe.exe -To test another application, replace only `Wow.exe` with its filename, e.g. -`MouseLookProbe.exe`, save the file, then run the launcher normally. No -startup question is shown. The value persists between runs; there is no need -to edit the JSON profile. Only an executable **filename** ending in `.exe` -is accepted, never a path. If the INI is missing or invalid, the A/B launcher -stops with a clear error before starting correction. +[Playing] +Executable=C:\Games\World of Warcraft\Wow.exe +``` -This INI affects the A/B profile only. The normal playing and diagnostic -profiles continue using their JSON `target_process`. The selected executable -is displayed as `TARGET` in A/B mode and the existing foreground and -hidden-cursor safety rules still apply. +Use `Executable=Wow.exe` to match any running game process with that filename, +**regardless of its installation directory**. Alternatively supply a full +absolute Windows path to match **only that exact executable installation**. +Spaces in the path are supported; do not surround the value with quotes. +Change the INI while the tool is stopped, save, and start the desired +`Start-AB-Test.cmd` or `Start-Playing.cmd` launcher as usual. No startup +question or JSON edit is needed. The shipped file uses `Wow.exe` for both +sections, and the settings persist across sessions. + +RemoteMouseFix **does not launch a game**. The path selects the process to +monitor and correct when the game is already running and in the foreground. +The selected target is shown as `TARGET` in A/B mode (or `GAME` in the +regular playing display). A missing INI or invalid target fails closed +before correction starts. The diagnostic-only profile remains unchanged. The A/B profile additionally shows the number of markers written so far and all test hotkeys. Each press of `Ctrl+Alt+M` creates the next numbered `## MARKER #N` @@ -162,7 +168,7 @@ input or text, and it has no upload or network feature. You decide whether to sh 1. Start the game and move to a quiet, safe location. 2. Double-click `Start-AB-Test.cmd` from the RemoteMouseFix folder. 3. Confirm that the console names `config-ab-test.json`, that `TARGET` shows - the executable from `AB-Test.ini`, and that `FIX` is on with `absolute`. + the executable from `[AB-Test]` in `RemoteMouseFix.ini`, and that `FIX` is on with `absolute`. `TARGET` turns green when you click into the chosen application. 4. Test the same actions in each mode: `absolute`, `off`, then `relative`. Use `Ctrl+Alt+1`, `Ctrl+Alt+C` and `Ctrl+Alt+2` to select the modes. @@ -273,7 +279,8 @@ Keys beginning with `_` in the supplied configuration files are explanatory comm | Key | Built-in default | Meaning | | --- | --- | --- | -| `target_process` | `Wow.exe` | target executable name; the A/B profile takes its target from `AB-Test.ini` instead | +| `target_process` | `Wow.exe` | fallback target name; the A/B and Playing profiles select their executable from `RemoteMouseFix.ini` | +| `target_ini_section` | empty | `AB-Test` or `Playing` enables that named section in `RemoteMouseFix.ini` for a name or full-path match | | `diagnostic_mode` | `true` | `true` prevents all correction; `false` permits correction modes | | `correction_mode` | `off` | startup mode: `off`, `absolute` or `relative` | | `watchdog_max_hidden_ms` | `180000` | hidden cursor duration before correction is disabled; `0` disables this check | From 7b638446df0001037e2c1f643e4ee6399b5db05e Mon Sep 17 00:00:00 2001 From: quasistatic-setup <76494705+quasistatic-setup@users.noreply.github.com> Date: Tue, 27 Oct 2026 13:04:30 +0100 Subject: [PATCH 41/54] docs: configure independent A/B and playing targets by filename or path --- docs/diagnostics.md | 31 +++++++++++++++++++------------ 1 file changed, 19 insertions(+), 12 deletions(-) diff --git a/docs/diagnostics.md b/docs/diagnostics.md index 78f2101..7746694 100644 --- a/docs/diagnostics.md +++ b/docs/diagnostics.md @@ -225,24 +225,31 @@ In A/B the pointer can reach the screen edge. The probe records the the operator continued moving their mouse. First run the probe without RemoteMouseFix correcting it. If later capturing -low-level input timing with RemoteMouseFix, set `Executable=MouseLookProbe.exe` in `AB-Test.ini` +low-level input timing with RemoteMouseFix, set `Executable=MouseLookProbe.exe` under `[AB-Test]` in `RemoteMouseFix.ini` and use an isolated log folder when preserving historical traces. This test compares cursor behavior; it does not establish that the probe matches every detail of WoW's mouse input. -### Capturing another target application +### Selecting a target for A/B or normal playing -Edit `AB-Test.ini` next to `RemoteMouseFix.exe` before starting -`Start-AB-Test.cmd`: +Edit `RemoteMouseFix.ini` beside `RemoteMouseFix.exe`: ```ini -[Target] +[AB-Test] Executable=MouseLookProbe.exe + +[Playing] +Executable=D:\Games\MyGame\Game.exe ``` -The shipped value is `Wow.exe`. The file is read at each A/B startup; there -is no interactive selection or JSON edit. A missing INI or invalid filename -is a clear error and prevents the tool from starting correction. Only a -filename ending in `.exe` is accepted, not a path. The A/B panel shows -the selected `TARGET`. The regular gameplay and diagnostic profiles still -use their existing JSON target. Foreground, hidden-cursor, injected-move-only -and emergency-hotkey safety conditions are unchanged. +Both sections ship with `Wow.exe` by default. `Start-AB-Test.cmd` uses +`[AB-Test]`, and `Start-Playing.cmd` uses `[Playing]`. A bare executable +filename matches the corresponding running process wherever it was installed. +A full absolute Windows image path matches only that specific installation +and prevents accidental cross-matching of similarly named games. The app does +**not launch** the selected EXE. No user prompt or JSON editing is required. +Missing/invalid INI fails safely before the mouse hook starts. +The diagnostic-only profile continues using its JSON target, and existing +foreground, hidden-cursor, injected-move-only and emergency-off checks remain. + +The name/path lookup is done in process enumeration and the PID cache, +not in the low-level hook, which continues to rely on a prevalidated foreground PID. From 55551754ca87c945b50e3ef8021717897cf84cab Mon Sep 17 00:00:00 2001 From: quasistatic-setup <76494705+quasistatic-setup@users.noreply.github.com> Date: Tue, 27 Oct 2026 13:04:33 +0100 Subject: [PATCH 42/54] docs: configure independent A/B and playing targets by filename or path --- CHANGELOG.md | 8 +++++--- 1 file changed, 5 insertions(+), 3 deletions(-) diff --git a/CHANGELOG.md b/CHANGELOG.md index 95345e5..887ec16 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -12,9 +12,11 @@ correction is still experimental. - MouseLookProbe now provides visible/no-warp, hidden/no-warp and hidden/warp modes to distinguish cursor hiding from cursor repositioning. The original hidden/warp mode remains the default for automated regression testing. -- The A/B launcher reads the target executable filename from editable - `AB-Test.ini` beside the EXE (default `Wow.exe`), without prompting at - startup or modifying other profiles. Invalid INI values fail safely. +- Both `Start-AB-Test.cmd` and `Start-Playing.cmd` read independent + targets from `[AB-Test]` and `[Playing]` in `RemoteMouseFix.ini`. + Select by executable filename or a full absolute path (exact process-image + match). Missing or invalid INI settings fail safely before correction. + The tool does not launch the configured game. - The A/B console displays Ctrl+Alt+M, the number of markers written and all correction/diagnostic hotkeys. - The CI diagnostic artifact includes MouseLookProbe.exe for direct tests. From 4757bf326c29b0b60bf03a00f02d67cb5f74b09a Mon Sep 17 00:00:00 2001 From: quasistatic-setup <76494705+quasistatic-setup@users.noreply.github.com> Date: Tue, 27 Oct 2026 13:06:13 +0100 Subject: [PATCH 43/54] fix(playing): keep error message visible for invalid INI target --- config/Start-Playing.cmd | 5 +++++ 1 file changed, 5 insertions(+) diff --git a/config/Start-Playing.cmd b/config/Start-Playing.cmd index 4a35201..1b631bc 100644 --- a/config/Start-Playing.cmd +++ b/config/Start-Playing.cmd @@ -2,3 +2,8 @@ setlocal title RemoteMouseFix gameplay "%~dp0RemoteMouseFix.exe" "%~dp0config\config-play.json" %* +if errorlevel 1 ( + echo. + echo RemoteMouseFix could not start. Review the error above. + pause +) From 6bbb30efcb7f47e91ff7bf0c1c63204a154dba2d Mon Sep 17 00:00:00 2001 From: quasistatic-setup <76494705+quasistatic-setup@users.noreply.github.com> Date: Tue, 27 Oct 2026 13:14:27 +0100 Subject: [PATCH 44/54] docs: accept optional quotes around INI executable paths --- config/RemoteMouseFix.ini | 1 + 1 file changed, 1 insertion(+) diff --git a/config/RemoteMouseFix.ini b/config/RemoteMouseFix.ini index c71b40a..ad9879b 100644 --- a/config/RemoteMouseFix.ini +++ b/config/RemoteMouseFix.ini @@ -1,6 +1,7 @@ ; RemoteMouseFix target selection. Save changes before starting a launcher. ; Give the EXE filename OR a complete Windows path to the game EXE. ; A full path limits correction to the matching game installation. +; Quotation marks around the full value are optional; Windows strips them when reading. ; This tool does NOT launch the executable. ; Example: Executable=C:\Games\World of Warcraft\Wow.exe ; Example: Executable=D:\Games\AnotherGame\Game.exe From 4375bd0812d7d366229bd797b5d864a6fe1599aa Mon Sep 17 00:00:00 2001 From: quasistatic-setup <76494705+quasistatic-setup@users.noreply.github.com> Date: Tue, 27 Oct 2026 13:14:31 +0100 Subject: [PATCH 45/54] docs: accept optional quotes around INI executable paths --- README.md | 3 ++- 1 file changed, 2 insertions(+), 1 deletion(-) diff --git a/README.md b/README.md index c55c503..319cf6c 100644 --- a/README.md +++ b/README.md @@ -112,7 +112,8 @@ Executable=C:\Games\World of Warcraft\Wow.exe Use `Executable=Wow.exe` to match any running game process with that filename, **regardless of its installation directory**. Alternatively supply a full absolute Windows path to match **only that exact executable installation**. -Spaces in the path are supported; do not surround the value with quotes. +Spaces in the path are supported. Enclosing the whole value in double quotes is optional; +Windows removes them when reading the INI. Your runtime test confirmed both forms. Change the INI while the tool is stopped, save, and start the desired `Start-AB-Test.cmd` or `Start-Playing.cmd` launcher as usual. No startup question or JSON edit is needed. The shipped file uses `Wow.exe` for both From f0469e489942e75976e15be223ead675b4c9872e Mon Sep 17 00:00:00 2001 From: quasistatic-setup <76494705+quasistatic-setup@users.noreply.github.com> Date: Tue, 27 Oct 2026 13:14:34 +0100 Subject: [PATCH 46/54] docs: accept optional quotes around INI executable paths --- docs/diagnostics.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/diagnostics.md b/docs/diagnostics.md index 7746694..ac3893c 100644 --- a/docs/diagnostics.md +++ b/docs/diagnostics.md @@ -244,7 +244,7 @@ Executable=D:\Games\MyGame\Game.exe Both sections ship with `Wow.exe` by default. `Start-AB-Test.cmd` uses `[AB-Test]`, and `Start-Playing.cmd` uses `[Playing]`. A bare executable filename matches the corresponding running process wherever it was installed. -A full absolute Windows image path matches only that specific installation +A full absolute Windows image path (with or without enclosing quotes) matches only that specific installation and prevents accidental cross-matching of similarly named games. The app does **not launch** the selected EXE. No user prompt or JSON editing is required. Missing/invalid INI fails safely before the mouse hook starts. From 205d30f9079196f9bd6a7aa3cf4ff8604680b6c4 Mon Sep 17 00:00:00 2001 From: quasistatic-setup <76494705+quasistatic-setup@users.noreply.github.com> Date: Tue, 27 Oct 2026 13:18:46 +0100 Subject: [PATCH 47/54] feat(diagnostics): integrate opt-in 250ms correction timing and anchor gate trace --- src/main.cpp | 98 ++++++++++++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 98 insertions(+) diff --git a/src/main.cpp b/src/main.cpp index 1f229bc..b9b6092 100644 --- a/src/main.cpp +++ b/src/main.cpp @@ -428,6 +428,8 @@ int main() { cfg.jumpThresholdPx, cfg.anchorTolerancePx, cfg.statePollIntervalMs)); header.push_back(Format(L"# smoothing : absolute only, interval=%ums max_step=%ldpx", kSmoothIntervalMs, kSmoothMaxStepPx)); + header.push_back(L"# timing trace : " + + std::wstring(cfg.traceCorrectionTiming ? L"on (250ms windows)" : L"off")); header.push_back(Format(L"# heartbeat : every %u ms (0 = off)", cfg.heartbeatIntervalMs)); header.push_back(Format(L"# rotation : %llu bytes, keep %u files", static_cast(cfg.maxLogBytes), cfg.maxLogFiles)); @@ -895,6 +897,35 @@ int main() { long long smoothPendingX = 0; long long smoothPendingY = 0; + // Opt-in A/B diagnostics. These counters belong to the message-loop thread; the + // mouse hook does no additional work and logging is limited to one summary per 250 ms. + struct TimingWindow { + unsigned timerTicks = 0; + unsigned incoming = 0; + unsigned outputAttempts = 0; + unsigned missingAnchor = 0; + unsigned cursorReadFailed = 0; + unsigned offAnchor = 0; + unsigned emptyPending = 0; + std::uint64_t maxTimerGapMs = 0; + long lastAnchorDx = 0; + long lastAnchorDy = 0; + POINT lastCursor {0, 0}; + POINT lastAnchor {0, 0}; + } timing; + std::uint64_t timingLastTickMs = 0; + std::uint64_t timingLastReportMs = 0; + std::uint64_t timingLastInputMs = 0; + std::uint64_t timingPendingSinceMs = 0; + + auto qpcNowMs = [&]() -> std::uint64_t { + LARGE_INTEGER now {}; + QueryPerformanceCounter(&now); + // Split before multiplying to avoid overflow during long system uptimes. + return static_cast(now.QuadPart / qpcFreq) * 1000 + + static_cast((now.QuadPart % qpcFreq) * 1000 / qpcFreq); + }; + auto applyDelta = [&](rmf::CorrectionMode mode, long dx, long dy) { POINT before {}; GetCursorPos(&before); @@ -964,7 +995,14 @@ int main() { } const long dx = static_cast(static_cast(msg.wParam)); const long dy = static_cast(static_cast(msg.lParam)); + if (cfg.traceCorrectionTiming && mode == rmf::CorrectionMode::Absolute) { + ++timing.incoming; + timingLastInputMs = qpcNowMs(); + } if (mode == rmf::CorrectionMode::Absolute && smoothTimerId != 0) { + if (cfg.traceCorrectionTiming && smoothPendingX == 0 && smoothPendingY == 0) { + timingPendingSinceMs = qpcNowMs(); + } auto retargetAxis = [&](long long& pending, long incoming, wchar_t axis) { constexpr long kRetargetMinPx = 5; const bool reversed = @@ -981,6 +1019,9 @@ int main() { retargetAxis(smoothPendingY, dy, L'y'); smoothPendingX += dx; smoothPendingY += dy; + if (cfg.traceCorrectionTiming && smoothPendingX == 0 && smoothPendingY == 0) { + timingPendingSinceMs = 0; + } } else { applyDelta(mode, dx, dy); } @@ -988,6 +1029,48 @@ int main() { } if (msg.message == WM_TIMER && msg.wParam == smoothTimerId) { + if (cfg.traceCorrectionTiming) { + const bool active = correction.Mode() == rmf::CorrectionMode::Absolute && + cursorHeldByTarget.load(std::memory_order_relaxed); + if (!active) { + timing = TimingWindow{}; + timingLastTickMs = 0; + timingLastReportMs = 0; + timingLastInputMs = 0; + timingPendingSinceMs = 0; + } else { + const std::uint64_t nowMs = qpcNowMs(); + if (timingLastReportMs == 0) timingLastReportMs = nowMs; + if (timingLastTickMs != 0) { + timing.maxTimerGapMs = std::max(timing.maxTimerGapMs, nowMs - timingLastTickMs); + } + timingLastTickMs = nowMs; + ++timing.timerTicks; + if (nowMs - timingLastReportMs >= 250) { + const auto inputAge = timingLastInputMs == 0 ? -1LL : + static_cast(nowMs - timingLastInputMs); + const auto pendingAge = timingPendingSinceMs == 0 ? 0ULL : + static_cast(nowMs - timingPendingSinceMs); + LogLine(Format( + L"## TIMING qpc_ms=%llu window_ms=%llu ticks=%u max_timer_gap_ms=%llu " + L"input=%u apply=%u skip=no_anchor:%u,cursor:%u,off_anchor:%u,empty:%u " + L"pending=(%lld,%lld) pending_age_ms=%llu input_age_ms=%lld " + L"anchor_delta=(%ld,%ld) anchor=(%ld,%ld) cursor=(%ld,%ld)", + static_cast(nowMs), + static_cast(nowMs - timingLastReportMs), + timing.timerTicks, + static_cast(timing.maxTimerGapMs), + timing.incoming, timing.outputAttempts, timing.missingAnchor, + timing.cursorReadFailed, timing.offAnchor, timing.emptyPending, + smoothPendingX, smoothPendingY, pendingAge, inputAge, + timing.lastAnchorDx, timing.lastAnchorDy, + timing.lastAnchor.x, timing.lastAnchor.y, + timing.lastCursor.x, timing.lastCursor.y)); + timing = TimingWindow{}; + timingLastReportMs = nowMs; + } + } + } if (correction.Mode() != rmf::CorrectionMode::Absolute || !cursorHeldByTarget.load(std::memory_order_relaxed)) { smoothPendingX = 0; @@ -999,19 +1082,28 @@ int main() { // camera motion. The learned anchor is the proof that the previous step was // read and the game warped back. if (!filter.anchorValid.load(std::memory_order_relaxed)) { + if (cfg.traceCorrectionTiming && (smoothPendingX || smoothPendingY)) ++timing.missingAnchor; continue; } const rmf::StateSampler::Snapshot snap = sampler.Current(); POINT current {}; if (!GetCursorPos(¤t)) { + if (cfg.traceCorrectionTiming && (smoothPendingX || smoothPendingY)) ++timing.cursorReadFailed; continue; } const long anchorX = snap.clientScreenRect.left + filter.anchorOffsetX.load(std::memory_order_relaxed); const long anchorY = snap.clientScreenRect.top + filter.anchorOffsetY.load(std::memory_order_relaxed); + if (cfg.traceCorrectionTiming) { + timing.lastCursor = current; + timing.lastAnchor = POINT{anchorX, anchorY}; + timing.lastAnchorDx = current.x - anchorX; + timing.lastAnchorDy = current.y - anchorY; + } if (std::abs(current.x - anchorX) > cfg.anchorTolerancePx || std::abs(current.y - anchorY) > cfg.anchorTolerancePx) { + if (cfg.traceCorrectionTiming && (smoothPendingX || smoothPendingY)) ++timing.offAnchor; continue; } const long dx = static_cast(std::clamp( @@ -1023,7 +1115,13 @@ int main() { if (dx != 0 || dy != 0) { smoothPendingX -= dx; smoothPendingY -= dy; + if (cfg.traceCorrectionTiming) { + ++timing.outputAttempts; + if (smoothPendingX == 0 && smoothPendingY == 0) timingPendingSinceMs = 0; + } applyDelta(rmf::CorrectionMode::Absolute, dx, dy); + } else if (cfg.traceCorrectionTiming) { + ++timing.emptyPending; } continue; } From ed77504eff65cba7aef7fa189f2bb59fae137074 Mon Sep 17 00:00:00 2001 From: quasistatic-setup <76494705+quasistatic-setup@users.noreply.github.com> Date: Tue, 27 Oct 2026 13:19:00 +0100 Subject: [PATCH 48/54] feat(diagnostics): enable opt-in timing trace in isolated A/B profile --- include/rmf/Config.h | 1 + 1 file changed, 1 insertion(+) diff --git a/include/rmf/Config.h b/include/rmf/Config.h index 286a7c2..d276ae7 100644 --- a/include/rmf/Config.h +++ b/include/rmf/Config.h @@ -39,6 +39,7 @@ struct Config { int anchorTolerancePx = 3; // real move this close to the learned anchor => ANCHOR unsigned statePollIntervalMs = 10; // cursor visibility / clip / anchor sampling period bool logStateChanges = true; + bool traceCorrectionTiming = false; // opt-in timing trace for A/B tests unsigned consoleStatusIntervalMs = 2000; // 0 disables the live console status line unsigned heartbeatIntervalMs = 10000; // periodic liveness line, 0 disables it From dceeedcabe575b130c25051cadfa4ebea86676c3 Mon Sep 17 00:00:00 2001 From: quasistatic-setup <76494705+quasistatic-setup@users.noreply.github.com> Date: Tue, 27 Oct 2026 13:19:03 +0100 Subject: [PATCH 49/54] feat(diagnostics): enable opt-in timing trace in isolated A/B profile --- src/Config.cpp | 3 +++ 1 file changed, 3 insertions(+) diff --git a/src/Config.cpp b/src/Config.cpp index a133028..5d5d12e 100644 --- a/src/Config.cpp +++ b/src/Config.cpp @@ -301,6 +301,9 @@ bool LoadConfig(const std::wstring& path, Config& cfg) { } else if (key == L"log_state_changes") { if (ParseBool(value, b)) cfg.logStateChanges = b; else cfg.warnings.push_back(L"log_state_changes is not a boolean: " + value); + } else if (key == L"trace_correction_timing") { + if (ParseBool(value, b)) cfg.traceCorrectionTiming = b; + else cfg.warnings.push_back(L"trace_correction_timing is not a boolean: " + value); } else if (key == L"console_status_interval_ms") { if (ParseU64(value, u) && u <= 60000) cfg.consoleStatusIntervalMs = static_cast(u); else cfg.warnings.push_back(L"console_status_interval_ms must be 0..60000: " + value); From cc8c4dfbfe3951f275759203e47754c1764c0da9 Mon Sep 17 00:00:00 2001 From: quasistatic-setup <76494705+quasistatic-setup@users.noreply.github.com> Date: Tue, 27 Oct 2026 13:19:06 +0100 Subject: [PATCH 50/54] feat(diagnostics): enable opt-in timing trace in isolated A/B profile --- config/config-ab-test.json | 6 ++++-- 1 file changed, 4 insertions(+), 2 deletions(-) diff --git a/config/config-ab-test.json b/config/config-ab-test.json index c1daa94..7c0483b 100644 --- a/config/config-ab-test.json +++ b/config/config-ab-test.json @@ -24,12 +24,12 @@ "watchdog_max_output_failures": 5, "_log_directory": "Relative paths resolve next to RemoteMouseFix.exe.", - "log_directory": "logs", + "log_directory": "logs-ab", "log_file_prefix": "remotemousefix", "_rotation": "Roll over past max_log_bytes and keep at most max_log_files files.", "max_log_bytes": 8388608, - "max_log_files": 5, + "max_log_files": 50, "_flush_on_button": "Flush after every button event so a crash still keeps the interesting moment.", "flush_on_button": true, @@ -43,6 +43,8 @@ "_state_poll_interval_ms": "Sampling period for cursor visibility, ClipCursor state and anchor learning.", "state_poll_interval_ms": 10, "log_state_changes": true, + "_trace_correction_timing": "Log 250 ms timing/anchor-gate summaries while absolute correction is active and the target holds the cursor.", + "trace_correction_timing": true, "_console_status_interval_ms": "Live counter refresh in the console. 0 disables it.", "console_status_interval_ms": 2000, From 28f2fc657c0260f2e6962c2625031d6f63006f3a Mon Sep 17 00:00:00 2001 From: quasistatic-setup <76494705+quasistatic-setup@users.noreply.github.com> Date: Tue, 27 Oct 2026 13:20:01 +0100 Subject: [PATCH 51/54] docs(diagnostics): explain timing events and a focused WoW/Probe test plan --- docs/diagnostics.md | 49 +++++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 49 insertions(+) diff --git a/docs/diagnostics.md b/docs/diagnostics.md index ac3893c..01d5b8a 100644 --- a/docs/diagnostics.md +++ b/docs/diagnostics.md @@ -253,3 +253,52 @@ foreground, hidden-cursor, injected-move-only and emergency-off checks remain. The name/path lookup is done in process enumeration and the PID cache, not in the low-level hook, which continues to rely on a prevalidated foreground PID. + +## Opt-in timing trace for intermittent camera stalls + +The `Start-AB-Test.cmd` profile now sets `trace_correction_timing=true` and writes to +`logs-ab/` beside the executable (separate from the ordinary `logs/` gameplay +directory). The normal gameplay and diagnostic-only profiles leave this trace off. +`diagnostic_mode=true` is **not** the way to enable it: that setting locks all correction. + +With absolute correction active and the selected target holding the hidden cursor, the message loop writes +one aggregated `## TIMING` line approximately every 250 ms: + +```text +## TIMING qpc_ms=81234567 window_ms=256 ticks=16 max_timer_gap_ms=19 input=14 apply=13 skip=no_anchor:0,cursor:0,off_anchor:2,empty:1 pending=(10,0) pending_age_ms=87 input_age_ms=12 anchor_delta=(5,0) anchor=(803,554) cursor=(808,554) +``` + +- `qpc_ms` uses the same system clock as `APPLY qpc_ms`; `window_ms` is elapsed + time since the previous summary. These are diagnostics, **not frame times**. +- `ticks` counts received `WM_TIMER` callbacks, and `max_timer_gap_ms` is the + largest gap between consecutive callbacks in that window (including message-loop delays). +- `input` counts remote deltas posted by the hook to the message loop. Cross-reference + `DROP` events and their QPC timestamps in the same trace to distinguish missing + TeamViewer input from delayed processing. +- `apply` counts attempted output steps; successes/failures are in `APPLY` lines. +- `skip` counts timer cycles unable to emit because the anchor was not yet learned, + `GetCursorPos` failed, the cursor was outside the configured anchor tolerance, + or the final check had no movement pending. Anchor-related counts only include cycles with queued movement. +- `pending` is the unsent horizontal/vertical delta. `pending_age_ms` measures how long + movement has stayed continuously queued (an estimate of age, not the oldest pixel's age). + `input_age_ms` is the time since the last processed remote delta, or -1 before the + first observed delta in a held-cursor phase. +- `anchor_delta` is the last observed offset from the learned anchor; `anchor` and + `cursor` are the last measured screen coordinates. These values are from the last + timer check, not necessarily the same instant as the summary. + +No new logging takes place inside the mouse hook. The trace is a sampled aggregate, +not proof that the target consumed each injected move. Do not infer a cause merely from the +counts; compare them around visible stalls against `DROP`, `APPLY` and `OWN`. + +For a practical WoW test: start `Start-AB-Test.cmd`, leave `absolute` correction on, +mark the beginning with `Ctrl+Alt+M`, hold right-click and rotate slowly for 20–30 s +through several pauses, then quit with `Ctrl+Alt+Q`. Optionally mark and record a +short `off` reference with `Ctrl+Alt+C`; expect camera jumps without the fix. +Do not alter the smoothing or anchor tolerance for the measurement. + +**Keep historical evidence outside the rotating directory.** The A/B profile keeps up +to 50 files of 8 MiB in `logs-ab/` and still deletes the oldest matching files. +Before repeating tests, copy important captures into a separate folder that does not +contain the `remotemousefix-*.log` rotation target. Preserve the raw timestamps, and +do not commit session logs to Git. From a0ccac5b05536cf1831274bfe8eec4ddf892357d Mon Sep 17 00:00:00 2001 From: quasistatic-setup <76494705+quasistatic-setup@users.noreply.github.com> Date: Tue, 27 Oct 2026 13:20:04 +0100 Subject: [PATCH 52/54] docs: describe integrated timing trace and separate rotating A/B logs --- README.md | 20 ++++++++++++++------ 1 file changed, 14 insertions(+), 6 deletions(-) diff --git a/README.md b/README.md index 319cf6c..2a81737 100644 --- a/README.md +++ b/README.md @@ -48,7 +48,8 @@ in a folder of its own: README.md LICENSE config/ the three profiles docs/ diagnostic reference - logs/ created on the first start + logs/ created by Start-Playing.cmd + logs-ab/ created by Start-AB-Test.cmd ``` ### Windows warnings on first start @@ -163,8 +164,13 @@ can still add latency. ## Report a problem or test another setup -The A/B profile records detailed mouse movement for comparison. It never records keyboard -input or text, and it has no upload or network feature. You decide whether to share a log. +The A/B profile records detailed mouse movement and opt-in 250 ms timing summaries +(`## TIMING`) to distinguish missing remote input, irregular timers and +unsent movement gated by the cursor anchor. Test logs are written to `logs-ab/` +separately from normal-play `logs/`; up to 50 files are retained, but the +oldest still rotate out. Copy important captures into an archive outside the +rotating folders. The tool never records keyboard input or text, and it has no +upload or network feature. You decide whether to share a log. 1. Start the game and move to a quiet, safe location. 2. Double-click `Start-AB-Test.cmd` from the RemoteMouseFix folder. @@ -179,7 +185,7 @@ input or text, and it has no upload or network feature. You decide whether to sh - hold the left mouse button and drag slowly. 6. Note for each mode whether the camera is smooth, jumps, or moves too fast or too slowly. 7. Press `Ctrl+Alt+C`, then `Ctrl+Alt+Q`. -8. Open the newest file in `logs` and check that its final lines report `queue drops 0` +8. Open the newest file in `logs-ab` and check that its final lines report `queue drops 0` and `watchdog trips 0`. 9. ZIP that log and attach it to a [GitHub issue](https://github.com/quasistatic-setup/RemoteMouseFix/issues/new) together @@ -288,6 +294,7 @@ Keys beginning with `_` in the supplied configuration files are explanatory comm | `watchdog_max_unechoed` | `50` | own events allowed outstanding before the echo watchdog trips | | `watchdog_max_output_failures` | `5` | consecutive failed output calls before the watchdog trips | | `log_mouse_moves` | `true` | `false` records buttons, wheel and state only | +| `trace_correction_timing` | `false` | opt-in 250 ms timer/anchor/pending-delta summaries; enabled in A/B profile | | `log_directory` | `logs` | relative paths resolve beside the EXE | | `log_file_prefix` | `remotemousefix` | log filename prefix | | `max_log_bytes` | `8388608` | rotate after this size | @@ -300,8 +307,9 @@ Keys beginning with `_` in the supplied configuration files are explanatory comm | `console_status_interval_ms` | `2000` | live console interval; `0` disables it | | `heartbeat_interval_ms` | `10000` | log heartbeat interval; `0` disables it | -Log files rotate by prefix. Copy a log you want to retain out of `logs` before taking many -further captures. +Log files rotate by prefix. The A/B profile uses `logs-ab/` (50 files maximum) and +normal playing uses `logs/` (5 files maximum). Copy any log you wish to preserve +into another folder before taking more captures. ## Build from source From b049df847e3a6d8f224b96cac72090231e1acaf6 Mon Sep 17 00:00:00 2001 From: quasistatic-setup <76494705+quasistatic-setup@users.noreply.github.com> Date: Tue, 27 Oct 2026 13:20:07 +0100 Subject: [PATCH 53/54] chore: document timing integration and isolated log rotation --- CHANGELOG.md | 6 ++++++ 1 file changed, 6 insertions(+) diff --git a/CHANGELOG.md b/CHANGELOG.md index 887ec16..573593e 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -9,6 +9,12 @@ correction is still experimental. ### Added +- A/B profile enables the optional 250 ms `## TIMING` summary for incoming deltas, + timer gaps, blocked anchor gates and queued movement. Normal playing remains unchanged. +- A/B diagnostic logs are isolated in `logs-ab/` with up to 50 retained files; + game logs remain in `logs/`. Back up original captures outside rotating folders. + + - MouseLookProbe now provides visible/no-warp, hidden/no-warp and hidden/warp modes to distinguish cursor hiding from cursor repositioning. The original hidden/warp mode remains the default for automated regression testing. From 1f8aa6690818744f1648914924a8bef7f4ed6dc7 Mon Sep 17 00:00:00 2001 From: quasistatic-setup <76494705+quasistatic-setup@users.noreply.github.com> Date: Tue, 27 Oct 2026 14:41:29 +0100 Subject: [PATCH 54/54] ci: upgrade checkout and artifact upload to Node.js 24 actions --- .github/workflows/build.yml | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/.github/workflows/build.yml b/.github/workflows/build.yml index d6433bb..8a0cefa 100644 --- a/.github/workflows/build.yml +++ b/.github/workflows/build.yml @@ -11,7 +11,7 @@ jobs: name: MSVC x64 runs-on: windows-latest steps: - - uses: actions/checkout@v4 + - uses: actions/checkout@v7 - name: Configure # No -G: CMake picks the newest Visual Studio on the runner image. @@ -28,7 +28,7 @@ jobs: run: Copy-Item build/bin/Release/MouseLookProbe.exe stage/RemoteMouseFix-win-x64/MouseLookProbe.exe - name: Upload the build output - uses: actions/upload-artifact@v4 + uses: actions/upload-artifact@v7 with: name: RemoteMouseFix-win-x64 path: stage/RemoteMouseFix-win-x64