Skip to content

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.

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 interrupted”, “The account service is temporarily unavailable”, or Reconnecting: Citron cannot reach its account service.

  1. 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.
  2. 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.
  3. If that fails too, try another DNS server (1.1.1.1 or 8.8.8.8) or a VPN, and send launcher.log and game.log in 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.

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.

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.

  1. Citron must be running in Minecraft (the power button on Enabled). Modules do nothing in the launcher alone.
  2. The module must be on (it shows in the Array List). An Activation Key module also needs its key.
  3. Check its conditions: many have Only While Clicking, Only Weapon, Players Only, a range or FOV cone, or Hold on their bind.
  4. Check who it targets: Teams, Friend List and Target List decide. With Target List on, only listed players count.
  5. Another module may use the same key, or do the same job (two aim modules, two clickers).
  6. Most modules pause in menus, chat and the Click GUI.
  7. Some servers undo movement or reject hits from settings that go too far: lower the values, or use the module’s more legit options.
  • 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.

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.

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”.

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.