Hold up!

You may already be able to attach — try running EcliptV1.exe as administrator first.

Docs

Troubleshooting Guide

Having trouble launching Eclipt? Follow the steps below to resolve the most common errors.

Eclipt uses Microsoft WebView2 to render its interface. If WebView2 is missing or corrupted, the executor will fail to open. Follow these steps to fix it.

WebView2 is a Microsoft component included with most modern Windows installs, but it may be missing on fresh or stripped-down systems.

1
Open your browser and go to the official Microsoft WebView2 download page.
2
Download the Evergreen Bootstrapper installer and run it. This is the recommended version.
Download WebView2 Runtime
3
After the install finishes, restart your PC and launch Eclipt again.
4
If the error persists, open Settings → Apps → Installed Apps, search for WebView2, uninstall it, then re-install using the link above.

Do not use third-party WebView2 installers. Only download from the official Microsoft link above.

SSL errors usually mean Windows Security or your antivirus removed a required file, or Eclipt didn't have enough permissions to write that file in the first place.

Your antivirus may have silently quarantined a critical .exe or .txt file that Eclipt needs.

Step 1 — Check Windows Security quarantine

1
Open Windows Security (search for it in the Start menu).
2
Navigate to Virus & threat protection.
3
Click Protection history and look for any items related to Eclipt — especially any quarantined .exe or .txt files.
4
If found, click the item and choose Restore to put it back where it belongs.
5
Also check your third-party antivirus quarantine section (Malwarebytes, Bitdefender, etc.) and restore any Eclipt files found there.

Step 2 — Run Eclipt as Administrator

If Eclipt does not have write permission it cannot create the files it needs, causing SSL errors. Running as admin fixes this.

1
Locate the Eclipt .exe file on your PC.
2
Right-click the file and select Run as administrator.
3
Allow the UAC prompt. Eclipt will now have the permissions it needs to write files correctly.

You must always run Eclipt as administrator for the attach function to work properly.

This error is caused by Windows Security blocking Eclipt. You need to disable specific protections and redownload Eclipt for it to work properly.

You must have the latest Roblox Player installed unless you are getting the version mismatch error (see below).

Fix — Disable Windows Security protections

Windows Security settings showing Virus & threat protection and Firewall & network protection with red X indicators

These two boxes must show a red X:

  • Virus & threat protection — Turn off all protections inside
  • Firewall & network protection — Turn off for all network types
1
Open Windows Security (search for it in the Start menu).
2
Click Virus & threat protection, then click Manage settings and turn OFF all the toggles (Real-time protection, Cloud-delivered protection, etc.).
3
Go back and click Firewall & network protection. Turn OFF the firewall for Domain, Private, and Public networks.
4
Delete your current Eclipt folder completely and redownload Eclipt fresh from the website.
5
Extract the new download, right-click the Eclipt .exe and select Run as administrator.

After following these steps, Eclipt should launch and attach without issues. You can re-enable protections after if you want, but you may need to repeat this process after updates.

This error means the version of Roblox you have installed doesn't match the version Eclipt was built for. You need to uninstall your current Roblox and install the correct previous version.

Do not update Roblox if prompted. Installing the previous version from the link below will resolve the mismatch.

1
Open Windows Settings (press Win + I).
2
Go to Apps → Installed apps (or Apps & features on Windows 10).
3
Search for Roblox, click it, and select Uninstall. Confirm when prompted.
4
Once uninstalled, go to weao.gg and download the previous supported Roblox version from there.
Open weao.gg
5
Run the installer you downloaded and let Roblox install fully before launching Eclipt.

After installing the previous version, launch Eclipt as administrator and attach as normal.

This error means another process on your PC is already using port 1337, which Eclipt needs. You need to find that process and kill it using Command Prompt.

You must run Command Prompt as administrator, otherwise these commands will not have permission to kill the process.

1
Open Command Prompt as administrator — search for cmd in the Start menu, right-click it, and select Run as administrator.
2
Run the following command to find what is using port 1337. Look for a line that says LISTENING — the number at the end of that line is the PID you need.
netstat -ano | findstr :1337
3
Replace 1234 with the PID number you found above and run this command to confirm the process name.
tasklist /FI "PID eq 1234"

This will output something like: node.exe   1234   Console   ...

4
Now kill the process by running the command below, replacing 1234 with your actual PID. The /F flag forces termination immediately.
taskkill /PID 1234 /F

Once the process is killed, launch Eclipt again and port 1337 will be free.

Still having issues?

Join our Discord server and open a support ticket. Include your error message and the steps you already tried.

Join Discord