Troubleshooting
Find the message you see below. If yours is not here, or the fix does not help, ask in the Discord and send the logs.
Signing in
Section titled “Signing in”| Message | What to do |
|---|---|
| “Incorrect username, email or password” | Check the name and password. Forgot password? on citron.lol sends a reset link to an account with an email; without one, open a ticket. Signing in with Discord needs that Discord account linked to your Citron account. |
| “No active licence” | Renew or redeem a key on your dashboard, or redeem it in the launcher (Settings > Account). |
| “Your play days are used up” | Check your dashboard. |
| “All device slots are in use” | Your licence is on another PC. Change HWID on your dashboard moves it to this one. See Moving to a new PC. |
| “This device was removed from your licence”, “This device is not registered”, “This session belongs to a different device” | Sign in again. If it stays, open a ticket. |
| “This account is suspended”, “Access is blocked” | Only staff can help: open a ticket. |
| “Update Citron to continue”, “This build is no longer supported” | Close and reopen the launcher so it installs the update. If it cannot, download it again from your dashboard. |
Connection
Section titled “Connection”“Connection interrupted”, “The account service is temporarily unavailable”, or Reconnecting: Citron cannot reach its account service.
- Check your internet connection. When Citron releases an update, the service can be gone for a minute or two: keep the launcher open, it reconnects by itself.
- If it stays that way while other sites work, your network or antivirus may be blocking citron.lol (some security vendors list the young domain, and an internet provider’s filter has blocked it). Citron then tries a second address by itself.
- If that fails too, try another DNS server (1.1.1.1 or 8.8.8.8) or a VPN, and send
launcher.logandgame.login a ticket.
“Something on this PC is inspecting Citron’s secure connection”: an antivirus web shield (HTTPS scanning), a proxy or a VPN is reading Citron’s connection. Turn HTTPS scanning off for Citron, or pause the VPN or proxy, then try again.
Starting Citron
Section titled “Starting Citron”| Message | What to do |
|---|---|
| “This Minecraft is not a build Citron V2 runs on” | Minecraft is another version. If Minecraft just updated, close Citron and start it again so it updates too; otherwise update to a supported version. |
| Stuck on Starting, or “Minecraft showed Citron no frame to draw on” | Minecraft must be open, in front and not minimised while Citron starts. Bring it to the front, then start again. |
| “Citron could not draw on Minecraft on this PC” | Update your graphics driver, then start again. |
| “Another mod or overlay has already changed the part of Minecraft Citron works through” | Close other clients, mods and injectors, restart Minecraft, then start Citron. |
| “Citron did not start in Minecraft” | Close Minecraft completely, start it again, then Citron. |
| “Citron stopped in Minecraft” | Check your licence on the dashboard and that Minecraft is a supported version, then start again. |
| “Citron stopped answering inside Minecraft” | Close Minecraft completely, then start Minecraft and Citron again. |
Antivirus
Section titled “Antivirus”If Windows Security or another antivirus removed or blocked CitronV2.exe, restore it from the antivirus’s protection history and allow that one file. Only allow the file from your dashboard, and never turn protection off entirely. See Installation.
A module does nothing
Section titled “A module does nothing”- Citron must be running in Minecraft (the power button on Enabled). Modules do nothing in the launcher alone.
- The module must be on (it shows in the Array List). An Activation Key module also needs its key.
- Check its conditions: many have Only While Clicking, Only Weapon, Players Only, a range or FOV cone, or Hold on their bind.
- Check who it targets: Teams, Friend List and Target List decide. With Target List on, only listed players count.
- Another module may use the same key, or do the same job (two aim modules, two clickers).
- Most modules pause in menus, chat and the Click GUI.
- Some servers undo movement or reject hits from settings that go too far: lower the values, or use the module’s more legit options.
Visuals look wrong or missing
Section titled “Visuals look wrong or missing”- Check the module’s Screenshare choice and Stream Hide.
- Check its range and colours.
- HUD modules are placed in the HUD editor. Reset layout brings back anything that went off screen.
Lag or low FPS
Section titled “Lag or low FPS”Visual modules with large ranges cost the most: block and ore ESPs, Xray, Custom Sky, the maps, Breadcrumbs and Trails. Lower their range, or turn them off one at a time to find the one.
Minecraft crashes or freezes
Section titled “Minecraft crashes or freezes”Note what you did just before, then try again with the module or setting you suspect turned off. Report it in #client-bugs with the logs and the time it happened. Windows also records Minecraft’s crashes: Event Viewer > Windows Logs > Application, “Application Error”.
Files and logs
Section titled “Files and logs”Everything is in %APPDATA%\CitronV2 (type it into the File Explorer address bar):
| File | What it is |
|---|---|
configs\*.cfg |
Your configs. |
scripts\*.lua |
Your scripts; their saved data is in scripts\data. |
emotes\*.json |
Your own emotes. |
clickgui.ini |
The GUI’s preferences, friends and targets, and auto-load rules. |
waypoints.txt |
Your waypoints. |
game.log |
What Citron did inside Minecraft. |
launcher.log |
What the launcher did. |
status.txt |
What Citron in Minecraft is doing now, refreshed while it runs. |
The logs hold no passwords. Paths in them may show your Windows user name.