Troubleshooting

Download failures can happen due to network interruptions or server issues. Here's what to try:

1. Try downloading again: Often, a simple retry will work. Click the download button again to start a fresh download.
2. Check your internet connection: Ensure you have a stable internet connection.
3. Try a different browser: Sometimes browser extensions or settings can interfere with downloads.
4. Still having issues? Contact our support team on Discord and we'll help you resolve the problem.

If the app protocol handler isn't working, try these solutions:

1. Reinstall the BeamLeaks app: The installer should automatically register the beamleaks:// protocol. Download and run the installer again.
2. Allow the protocol in your browser: Your browser may have blocked the protocol. Look for a notification asking for permission and click "Allow" or "Open."
3. Restart your browser: After reinstalling the app, restart your browser completely.
4. Still not working? Reach out to our support team on Discord for further assistance.

Slow downloads can be frustrating. Here's how to troubleshoot:

1. Test your internet speed: Use a speed test website to check if your connection is performing normally. If your speeds are lower than expected, the issue may be with your ISP.
2. Try downloading at a different time: Server load can affect download speeds during peak hours.
3. Check our status page: Visit status.beamleaks.com to see if there are any known service issues.
4. Still experiencing slow speeds? Contact our support team on Discord and we'll investigate.

If a mod isn't appearing in BeamNG.drive, the most common cause is an incorrect installation path. Here's how to verify:

1. Check your mods folder location: Make sure you placed the mod .zip file in the correct location. The default path is:
   C:\Users\YOUR_USERNAME\AppData\Local\BeamNG.drive\current\mods
2. Don't extract the zip: BeamNG.drive reads mods directly from .zip files. Do not extract/unzip them.
3. Restart BeamNG.drive: After adding mods, restart the game completely.
4. Clear cache: In BeamNG.drive, go to Settings and clear your cache, then restart.

Mod conflicts or compatibility issues can cause crashes. Here's how to resolve them:

1. Identify the problematic mod: Remove the most recently installed mod and see if the crash stops.
2. Check for mod conflicts: Some mods don't work well together. Uninstall conflicting mods one at a time to identify which combination causes issues.
3. Ensure mods are up-to-date: Outdated mods may not work with newer versions of BeamNG.drive.
4. Report the issue: If you identify a specific mod causing crashes, please report it through the mod's page or contact us on Discord.

Uninstalling mods is simple and can be done in two ways:

Method 1: Using the BeamLeaks App (Easiest)

1. Open the BeamLeaks app
2. The app will show your BeamNG mods folder
3. Find and delete the .zip file of the mod you want to remove

Method 2: Manual Deletion

1. Navigate to your BeamNG.drive mods folder:
   C:\Users\YOUR_USERNAME\AppData\Local\BeamNG.drive\current\mods
2. Find the .zip file of the mod you want to remove
3. Delete the .zip file
4. Restart BeamNG.drive for changes to take effect

If the app doesn't automatically detect your mods folder, you can manually set it:

1. When prompted, manually enter your mods folder path
2. The typical location is:
   C:\Users\YOUR_USERNAME\AppData\Local\BeamNG.drive\current\mods
3. Replace YOUR_USERNAME with your Windows username
4. If you have a custom BeamNG installation, navigate to where you installed it and find the mods folder

App crashes can usually be resolved with these steps:

1. Reinstall the app: Download the latest version from our website and run the installer again. This fixes most issues.
2. Run as administrator: Right-click the app and select "Run as administrator."
3. Check Windows Defender/Antivirus: Some antivirus software may block the app. Add an exception for BeamLeaks.
4. Still having issues? Contact our support team on Discord with details about the crash.

Currently, the BeamLeaks app is available for:

• ✅ Windows: Fully supported and available for download now
• 🚧 Linux: Coming soon! We're actively working on Linux support

Stay tuned to our Discord for announcements about Linux availability and other platform updates.

Login issues can be frustrating. Try these troubleshooting steps:

1. Wait and try again: Temporary server issues can prevent login. Wait a few minutes and try again.
2. Check the service status: Visit status.beamleaks.com to see if there are any ongoing service disruptions.
3. Clear your browser cache: Sometimes cached data can cause login problems. Clear your browser cache and cookies, then try again.
4. Forgot your password? Contact support on Discord to reset your password.
5. Still can't access your account? Reach out to our support team for assistance.

If images aren't displaying properly, try these solutions:

1. Check your internet connection: Ensure you have a stable connection and can access other websites normally.
2. Refresh the page: Press Ctrl + F5 (or Cmd + Shift + R on Mac) to force reload the page.
3. Check service status: Visit status.beamleaks.com to see if there are any known issues with our CDN or image servers.
4. Disable browser extensions: Ad blockers or privacy extensions may block images. Try disabling them temporarily.
5. Try a different browser: Test if the issue persists in another browser.

BeamLeaks is designed to work with all modern browsers, including:

• Google Chrome
• Microsoft Edge
• Mozilla Firefox
• Safari
• Opera
• Brave

We take mod quality seriously and handle these situations as follows:

• Broken mods: Once we're made aware that a mod is broken or contains malicious content, it will be removed from the site immediately to protect users.
• Outdated mods: Mods that are simply outdated but still functional may remain on the site until we obtain an updated version. We'll update them as soon as a newer version becomes available.

If you encounter a broken mod, please report it so we can take action quickly!

Found a mod that's broken, malicious, or violates our terms? Here's how to report it:

1. Contact our moderation team directly on Discord

Our team will review your report and take appropriate action. Thank you for helping keep BeamLeaks safe and high-quality!