Troubleshooting

Find the message Citron shows you, or the problem you are seeing, and follow the fix. If nothing here helps, open a ticket in the Discord.

Signing in

Message	What to do
Wrong username/email or password	Check both. Usernames are case sensitive. You can reset your password on the website.
Can’t reach the server, check your connection	Check your internet connection. A VPN, firewall or DNS filter can also block Citron.
Account is suspended	Your account has been suspended. If you think it is a mistake, open a ticket in the Discord.
No active license. Redeem a key to activate.	Your account has no active licence. Buy a plan or redeem a key on your account page.
Session expired, log in again.	Sign in again.
Sign in again on this device to continue.	Sign in again.
This PC’s device signature changed since sign-in. Restart Citron.	Close Citron and open it again.
Licence expired, or this PC’s clock is wrong. Check the date and time.	Check that your licence is still active on your account page. If it is, fix your PC clock (see below).
A Citron update is required.	Download the latest Citron from your account page.
License signature check failed. / Licence response could not be read. Try again.	Try again in a minute. If it keeps happening, something on your network is changing the connection; try without a VPN or proxy.

Signing in with Discord opens your browser. If it times out, was cancelled, or says Discord sign-in isn’t set up, use your username and password instead. A Discord account still needs a licence.

Your PC clock is wrong

Citron checks your licence with signed, time-limited answers from the licence server, so a PC clock that is noticeably wrong breaks sign-in and injection. If Citron says “Your PC clock is about N minutes slow” or “fast”:

1. Open Windows Settings > Time & language > Date & time.
2. Turn on Set time automatically, then click Sync now.
3. Restart Citron.

Device messages

Message	What to do
Device limit reached. Remove a device in your account.	Your licence is already bound to another PC. Move it to this PC with Change HWID.
This device was removed from your license.	This PC was removed from your licence on the account page. Use Change HWID to bind it again.

A licence can change PCs about once a week. If you are locked out of your old PC, open a ticket.

Signed in, but offline

Citron keeps a signed copy of your licence for 24 hours. When it cannot reach the licence server but that copy is still valid, it opens anyway, in an offline mode:

• modules do not run and cannot be switched on,
• Citron Internal cannot be injected,
• the Citron Internal row in Settings says “Signed in, but offline”.

Citron reconnects on its own within a minute of your connection coming back. If it stays offline:

1. Check your internet connection.
2. Turn off any VPN, proxy or DNS filter, and check that your firewall or antivirus is not blocking Citron.exe.
3. Check your PC clock.
4. Restart Citron.

If it is still offline, open a ticket and attach authdiag.txt from %LOCALAPPDATA%\Citron if it exists.

Other messages in that row mean the same kind of problem: “Could not reach the licence server”, “This session could not be renewed. Log out and back in.” and “The licence server refused this session”. For the last two, use Log out at the bottom of Settings and sign in again.

Injection problems

These show in the Citron Internal row under Settings > Injection. See Injecting for how injection normally works.

Unsupported Minecraft version

“Unsupported Minecraft version X - Citron supports Y” means your Minecraft version is not one Citron works with. Check the supported versions. When Minecraft updates, Citron needs an update of its own before it works on the new version.

Antivirus blocked the internal client

“Antivirus removed the internal client before it could load” or “The internal client was blocked from loading” means your antivirus deleted or blocked Citron Internal. Add the exclusions in Antivirus, then click Inject again.

“Minecraft or security software blocked injection” usually has the same cause. Add the exclusions, then restart Minecraft and Citron.

Access denied

“Minecraft access was denied - click Inject to restart Citron as administrator” means Windows blocked Citron from reaching Minecraft. Click Inject again and accept the Windows prompt. Citron restarts as administrator and can inject.

Still loaded from an earlier session

“Citron Internal is still loaded in Minecraft from an earlier session and would not shut down” happens when a previous Citron session did not unload cleanly. Close Minecraft completely, start it again, then inject.

The runtime never started

“Loaded into Minecraft but the runtime never started” means Citron Internal loaded but did not start. Close Minecraft, start it again and inject once the title screen is up.

Injection is stuck

“Injection is still pending” or “Injection state could not be confirmed” mean Citron lost track of an injection in progress. Close Citron and start it again. If Minecraft is misbehaving, restart it too.

“Minecraft is still finishing the previous injection attempt” and “Minecraft is still loading the internal client” usually clear on their own after a few seconds.

Runtime could not be downloaded

Citron downloads Citron Internal from the licence server each time it injects. “Runtime package could not be downloaded”, “Runtime server is unavailable” or “Runtime authorization was denied” mean that download failed. Check your connection and your PC clock, then try again. “A newer Citron version is required” means you need to update Citron.

Modules are locked

Modules marked INTERNAL stay locked until Citron Internal is fully running. Check the Citron Internal row in Settings:

• It says “Ready to inject”: click Inject, or turn on Auto Inject.
• It says “Minecraft not found”: start Minecraft.
• It shows an error: find it on this page.
• It says “Signed in, but offline”: see Signed in, but offline.

Modules that work without injecting also need a supported Minecraft version. On an unsupported version they do nothing, even when switched on.

The Click GUI does not open

• Citron Internal must be running. Check for the in-game notification or the green dot in Settings.
• You must be in a world with no game screen open. The menu does not open over chat, your inventory or the pause menu.
• The default key is Right Shift, not the left one.
• If you bound the Click GUI to another key, use that key.

Keybinds do nothing

Binds only fire while Minecraft is focused, no game screen is open and the Click GUI is closed. For some modules the key is an action rather than a toggle, and the module has to be switched on first. See Keybinds.

Updates

Citron checks for updates every time it starts, installs them and restarts itself. If an update could not be installed, the version line at the bottom of Settings says why:

Message	What to do
could not be downloaded.	Check your connection, or download the latest Citron from your account page.
could not be verified. / was refused.	Download the latest Citron from your account page.
failed its checksum check.	The update server may still be serving an older build. Try again a little later.
could not be saved.	Check that the folder with Citron.exe is writable and that your antivirus did not remove the download. Moving Citron out of a protected folder helps.
could not replace the running client.	Close any other copy of Citron and try again.
is installed.	Close Citron and open it again to finish.

Stream Hide does not turn on

Stream Hide needs Windows 10 version 2004 or newer. On older versions of Windows, Citron shows a notification and turns Stream Hide back off. Update Windows to use it.

Antivirus and Windows Defender

Clients like Citron are often flagged by antivirus software even when nothing is wrong, because of what they do: read and change another program’s memory. If your antivirus removes Citron or blocks injection, add exclusions for:

• the folder that holds Citron.exe,
• %LOCALAPPDATA%\Citron.

To add an exclusion in Windows Defender:

1. Open Windows Security > Virus & threat protection.
2. Under Virus & threat protection settings, click Manage settings.
3. Scroll to Exclusions and click Add or remove exclusions.
4. Click Add an exclusion > Folder, and pick the folder.

If Defender already removed Citron, restore it from Protection history or download it again from your account page.

Caution

Only download Citron from your account page on citron.lol. Never exclude a copy you got anywhere else.

Crashes

If Minecraft or Citron crashes, open a ticket and attach these files from %LOCALAPPDATA%\Citron, whichever exist:

• crash.txt
• citron-crash.txt
• citron-trace.bin and citron-trace.previous.bin

Say what you were doing when it crashed, which modules were on, and your Minecraft version.