Troubleshooting

Check the log file first — it contains the exact error message for most issues.

%LOCALAPPDATA%\VioletWing\logs\violetwing.log

The Logs tab inside the application shows the same output.

---

"Failed to fetch offsets" on startup

VioletWing couldn't reach the offset source on startup.

• Check your internet connection
• If you use a firewall or VPN, allow outbound HTTPS to github.com and raw.githubusercontent.com
• If offsets were previously cached, VioletWing will use them — features may still work if the game hasn't been updated recently

---

Features stop working after a CS2 update

Valve pushed a patch and the memory offsets have changed. All existing offsets are invalid until cs2-dumper updates.

• Wait for cs2-dumper to publish new offsets — usually within a few hours of a patch
• Restart VioletWing to fetch and cache the updated offsets
• To force a fresh fetch, delete %LOCALAPPDATA%\Requests\ItsJesewe\Offsets\

---

"Could not open cs2.exe" / process attach fails

VioletWing doesn't have permission to attach to CS2.

• Right-click VioletWing.exe → Run as administrator
• Make sure CS2 is already running before launching VioletWing

---

Overlay not visible

The ESP overlay doesn't support exclusive fullscreen, or pyMeow couldn't attach to the CS2 window.

• Switch CS2 to Windowed or Borderless Windowed (Video settings → Display Mode)
• Confirm the Overlay toggle is on in General Settings
• If running from source, verify pyMeow installed correctly — see Build from Source
• Restart both CS2 and VioletWing

---

ESP overlay shows a black rectangle

NVIDIA driver bug with transparent OpenGL windows.

• Open NVIDIA Control Panel → Manage 3D Settings → set OpenGL GDI compatibility to Prefer compatible
• Restart VioletWing

Intel and AMD GPUs are not affected.

---

Bunnyhop is inconsistent or not working

• CS2 must be the active foreground window — clicking away breaks it
• Adjust JumpDelay in the Additional tab: increase slightly (e.g. 0.012) if jumps fire too fast, decrease (e.g. 0.008) for tighter timing
• Confirm the jump key matches your CS2 jump bind — default is space

---

TriggerBot fires on teammates

Attack on Teammates is enabled. Disable it in the Trigger settings tab.

---

TriggerBot not firing at all

• Confirm TriggerBot is enabled in General Settings
• Check you're holding the correct trigger key (or that toggle mode is on and active)
• Verify offsets are current — stale offsets cause fire logic reads to fail
• Check the log for errors tagged trigger_bot

---

NoFlash not working

• Confirm NoFlash is enabled in General Settings
• Restart VioletWing to refresh offsets
• Verify FlashSuppressionStrength is 0.0 for full suppression

---

Still stuck?

Open a GitHub issue and attach the relevant lines from your log file.