SELFDIAGNOSTICS
The launcher, 1.7.10 and 1.8.9 save their logs into the same log file which can be accessed by using the SHOW LOGS button on the ABOUT page in the launcher
(Note: Log saving requires the launcher to stay open or hidden)
(Note: Log saving requires the launcher to stay open or hidden)
Make sure that you have at least 1GB available on your main system drive
If you are unable to login, make sure that:
• Online multiplayer is enabled in your Xbox privacy settings
• Your firewall is not blocking the CheatBreaker launcher
• Your HOSTS is not blocking CheatBreaker - See Self Signed Certificates
• Online multiplayer is enabled in your Xbox privacy settings
• Your firewall is not blocking the CheatBreaker launcher
• Your HOSTS is not blocking CheatBreaker - See Self Signed Certificates
If you're getting a There was an error trying to launch the client message or clicking the launch button doesn't do anything, make sure that:
• You have at least 1GB available on your main system drive
• (Windows only) Your network connection is configured as a Home/Private network and not a Public network
• Your firewall is not blocking the CheatBreaker launcher
• Your HOSTS is not blocking CheatBreaker - See Self Signed Certificates
• You have a stable internet connection
• Your system time and date are configured correctly
• You have at least 1GB available on your main system drive
• (Windows only) Your network connection is configured as a Home/Private network and not a Public network
• Your firewall is not blocking the CheatBreaker launcher
• Your HOSTS is not blocking CheatBreaker - See Self Signed Certificates
• You have a stable internet connection
• Your system time and date are configured correctly
32-bit Java installations on Windows could set your minimum RAM allocation to 512MB while CheatBreaker requires it to be set to 1024MB
Follow this guide to change your minimum Java RAM allocation:
1. From the Desktop, right-click This PC and click on Properties
2. Click on the Advanced System Settings link in the left column
3. In the System Properties window click on the Environment Variables button
4. Find the _JAVA_OPTIONS variable
5. Search for 512 in its field and replace it with 1024
6. Save and start CheatBreaker
Follow this guide to change your minimum Java RAM allocation:
1. From the Desktop, right-click This PC and click on Properties
2. Click on the Advanced System Settings link in the left column
3. In the System Properties window click on the Environment Variables button
4. Find the _JAVA_OPTIONS variable
5. Search for 512 in its field and replace it with 1024
6. Save and start CheatBreaker
Crashes while playing can be caused by a couple of reasons:
• You need to allocate more RAM in the launcher's SETTINGS page
• The server you're playing on has a faulty configuration
• If a solution is shown in the form of a pop up, follow the instructions
• If a Crash ID is included, go to our support server and include the Crash ID
• You need to allocate more RAM in the launcher's SETTINGS page
• The server you're playing on has a faulty configuration
• If a solution is shown in the form of a pop up, follow the instructions
• If a Crash ID is included, go to our support server and include the Crash ID
If your game crashes when trying to toggle the fullscreen mode, try the following fixes:
• Update your graphics drivers
• Use Borderless Fullscreen mode by going to the CheatBreaker Settings (right shift ingame & click on the ⚙️ icon) -> Display Settings and enable the Borderless Fullscreen option
• Update your graphics drivers
• Use Borderless Fullscreen mode by going to the CheatBreaker Settings (right shift ingame & click on the ⚙️ icon) -> Display Settings and enable the Borderless Fullscreen option
If cosmetics and/or CheatBreaker logos are not showing up, make sure that:
• You are not playing on a cracked/non premium Minecraft server
• You have capes enabled under Skin Customization/Multiplayer Settings and under Video Settings -> Details
• You have Capes and Wings enabled in the CheatBreaker settings menu (Right Shift -> Settings -> CheatBreaker Settings -> Cosmetic Settings)
• Your firewall is not blocking CheatBreaker
• Your HOSTS is not blocking CheatBreaker - See Self Signed Certificates
• You are not playing on a cracked/non premium Minecraft server
• You have capes enabled under Skin Customization/Multiplayer Settings and under Video Settings -> Details
• You have Capes and Wings enabled in the CheatBreaker settings menu (Right Shift -> Settings -> CheatBreaker Settings -> Cosmetic Settings)
• Your firewall is not blocking CheatBreaker
• Your HOSTS is not blocking CheatBreaker - See Self Signed Certificates
To be able to use your side mouse buttons on CheatBreaker, you'll need to remap them to keyboard keys using the software that came with your mouse or with another app:
Windows:
• Windows Mouse Manager
• X-Mouse Button Control
macOS:
• Mac Mouse Fix
• USB Overdrive
• Karabiner-Elements
Linux:
• Key Mapper
Windows:
• Windows Mouse Manager
• X-Mouse Button Control
macOS:
• Mac Mouse Fix
• USB Overdrive
• Karabiner-Elements
Linux:
• Key Mapper
Self signed certificates are not allowed, nor trusted due to redirects posing a security risk to you. As a result, CheatBreaker will reject and abruptly close for your safety.
Another application might have made these changes to your computer's HOSTS file, redirecting either Mojang, Microsoft, OptiFine, and/or CheatBreaker domains to a different website.
You need to clear out these entries before using CheatBreaker. To do so:
1. Open a text editor with Administrator or Sudo permissions.
2. If on Windows, open %SystemRoot%\System32\drivers\etc\hosts. If on macOS or Linux, open /etc/hosts
3. Ignore any entries that start with a #. Remove any entries that include cheatbreaker.net, optifine.net, mojang.com, microsoft.com.
Restart CheatBreaker and the game should work now.
Another application might have made these changes to your computer's HOSTS file, redirecting either Mojang, Microsoft, OptiFine, and/or CheatBreaker domains to a different website.
You need to clear out these entries before using CheatBreaker. To do so:
1. Open a text editor with Administrator or Sudo permissions.
2. If on Windows, open %SystemRoot%\System32\drivers\etc\hosts. If on macOS or Linux, open /etc/hosts
3. Ignore any entries that start with a #. Remove any entries that include cheatbreaker.net, optifine.net, mojang.com, microsoft.com.
Restart CheatBreaker and the game should work now.
If you have issues with surround sound not working try these steps:
• Create an alsoft.ini file in %appdata%
• Paste this into it:
[General]
hrtf=false
Restart CheatBreaker and surround sound should work
• Create an alsoft.ini file in %appdata%
• Paste this into it:
[General]
hrtf=false
Restart CheatBreaker and surround sound should work
Every service and connection within CheatBreaker is necessary and required, regardless of your needs. Make sure that:
• You undo your previous change that resulted in CheatBreaker getting blocked
• Your firewall is not blocking CheatBreaker
• Your HOSTS is not blocking CheatBreaker - See Self Signed Certificates
• You undo your previous change that resulted in CheatBreaker getting blocked
• Your firewall is not blocking CheatBreaker
• Your HOSTS is not blocking CheatBreaker - See Self Signed Certificates
Due to opening the launcher too many times, you have been rate limited by either GitHub, Microsoft, or us. Wait 25-60 minutes before trying again.