Moonlight Color Overview
Troubleshooting Moonlight
If you're experiencing issues with Moonlink or Moonlight, follow these steps to diagnose and resolve them:
1️⃣ Check Your Hardware Setup
Ensure your mouse is plugged into the 2nd PC (the one running Moonlink).
Unplug all other mouse receivers from the Main PC.
Confirm that only the Arduino is connected to the Main PC.
2️⃣ Restart Moonlight as Admin.
Moonlight may appear to startup fine but if the aim, flick, trigger, or rcs features aren't working, the first thing you should do is restart Moonlight as admin.
3️⃣ If using Moonlink, Verify Moonlink is Functioning
Check if the mouse moves in capture mode within Moonlink.
Do not enable both Moonlink aim and the regular aimbot at the same time—this can cause conflicts.
Ensure you are pressing the correct mouse bind for activation.
4️⃣ Check Common Settings Issues
Many issues are caused by incorrect settings in the Misc section of the guide. Double-check the following:
✅ Correct color selected in the Misc section.
✅ Right Capture Mode selected in Misc.
✅ Correct HID device selected in Misc.
✅ If you notice a visual glitch in the display window, try adjusting the screen size option in Misc to be one pixel smaller or larger than your OBS window. For example, if OBS is sending a 150x150 window, set the screen size to something like 149.
5️⃣ Use the Visual Debug Window
Click the “Start” button on the sidebar in Moonlight.
This will open the Visual Debug Window, allowing you to see detections when aiming at a target.
6️⃣ Check for Startup Errors
If the Visual Debug Window does not appear, it may indicate a startup error.
A log file should be generated inside the Moonlight folder—open it and check for errors.
One common issue is the log repeatedly displaying "looking for sources."
This suggests a network issue preventing Moonlight from detecting the NDI stream.
Follow the OBS setup guides to ensure NDI is correctly installed and configured.
7️⃣ Check for Windows OS Related Issues
If you try to open the exe and you get a cv2 recursion error, it never opens, force closes, or something else, you may need to follow these steps.
Check for Windows updates
Windows search bar --> settings --> Windows Update --> Check for updates
Sync your clock
Windows search bar --> Time & Language --> Date & Time
Windows 10
Windows 11
Install Visual C++ Redistributable Runtimes All-in-One
8️⃣ If All Else Fails
Click the "Upload Logs" button at the bottom of the sidebar while Moonlight is started.
This will send your current config and log file so we can assist you with troubleshooting.
You can then post that you need assistance in the support channel
Following these steps should help resolve most common issues!
Last updated