Introduction

Welcome to the official documentation for Citrus Auto. Citrus is a powerful, multi-threaded Roblox manager designed to automate massive account farms, bypass captchas, reduce hardware strain, and execute scripts globally.

Adding Accounts

To begin using Citrus Auto, you need to import your accounts using their .ROBLOSECURITY cookies.

• Open the Manager tab in the application.
• Click the Add Account button.
• Paste your valid .ROBLOSECURITY token.
• Citrus will securely validate the session, fetch the account's username and avatar, and display it in your account grid.

If you don't know how to get your cookie, you can watch this quick tutorial below:

Account Management

Citrus features automated maintenance tools to keep your database of accounts clean and updated over time.

Auto ReCheck Cookies

Over time, Roblox may naturally expire or invalidate sessions. By enabling Auto ReCheck Cookies in your Settings tab, Citrus will silently validate all stored cookies in the background based on your configured interval (e.g., Every 30 Minutes, 1 Hour, or 1 Day).

• If an account is found to be expired, it will be flagged with a red dot in your manager.
• If Discord Webhooks are enabled, you can optionally receive an instant alert when a cookie dies by turning on Notify Account Expiration.

Game Launching

Citrus allows you to launch dozens of accounts into a specific game, private server, or follow a specific player seamlessly.

• Game ID: Enter the numerical Place ID of the game. You can find this ID directly in the game's URL (e.g., https://www.roblox.com/games/GAMEID). Click Confirm Game to load the game's icon and name.
• Join a Player instead: Toggle this mode to input a target User ID instead of a Game ID. Citrus will track the target user and follow them into whichever game they are actively playing.
• PS Link / Job ID: If you are joining a private server, paste the full private server link or the specific Job ID into the secondary input box. Citrus will automatically resolve the share code and connect your instances.
• Join Cooldown: In the Settings tab, you can adjust the launch delay. Fast (2s) is recommended for powerful PCs, while Ratelimit Mode (2m) is safer to prevent connection blocks when launching massive fleets of accounts.

Auto Captcha Solver

When mass-logging or joining games, Roblox may trigger a FunCaptcha challenge. Citrus Auto handles this completely in the background using a secure, integrated process.

How to setup YesCaptcha

To use the automated solver, you must buy Citrus Auto Ultra or buy a key separately at citrusauto.cc/plans to get a YesCaptcha key.

1. Go to the Settings tab and scroll down to FunCaptcha Settings.
2. Enter your YesCaptcha Client Key into the input field and click Confirm.
3. Check the Auto Captcha Solver box.

If an account receives a captcha challenge during launch, Citrus will securely intercept the challenge, solve the puzzle, and automatically retry the game join without any manual input required.

Ignore Captcha Account

If you prefer not to use an automated solver, you can enable Ignore Captcha Account. If a captcha is detected, Citrus will immediately cancel the launch, temporarily ignore the account, and seamlessly move on to the next account to prevent your farm from stalling.

CPU & RAM Reduct

Running multiple Roblox instances is highly resource-intensive. Citrus utilizes advanced system optimizations to drastically lower your hardware footprint.

CPU Reduct

This setting safely limits processor usage to prevent your PC from slowing down while running multiple accounts.

• Strong: Maximizes account capacity by strictly limiting instance CPU usage. Best for large-scale farms.
• Normal: Distributes instances evenly across your system for a balanced approach.
• Soft: Recommended if your accounts are actively doing complex, movement-heavy in-game tasks.

RAM Reduct

This setting periodically clears cached, inactive memory from Roblox instances to prevent RAM limits and crashes.

• Strong (5m): Optimizes memory every 5 minutes.
• Normal (15m): Optimizes memory every 15 minutes.
• Soft (30m): Optimizes memory every 30 minutes.

Passive Rejoin

Passive Rejoin is a powerful interval-based mass reconnection tool.

When enabled, Citrus tracks the time since your farm was launched. Once the configured Rejoin Time (e.g., 5 minutes, 1 hour, 1 day) is reached, Citrus will safely cycle all active accounts and relaunch them. This is highly effective for keeping sessions fresh, bypassing long-term server disconnects, and ensuring maximum uptime.

Auto Recovery & Crash Watchdog

Crash Watchdog

Independently of the mass-rejoin interval, Citrus also acts as a crash watchdog. It continuously monitors the connection of all launched accounts. If a specific instance freezes, crashes, or drops connection, Citrus will isolate that instance, safely close it, and place only that account into a recovery queue to be rejoined.

Method 1: Auto Recovery (Executor/Websocket)

This method requires Exploit Mode to be enabled in Settings. It ensures your scripts run immediately when an account reconnects, preventing your farm from idling.

1. In Settings, enable Exploit Mode.
2. Paste the absolute folder path to your executor's autoexec folder.
3. Click Confirm. Citrus will securely install the recovery protocol into that directory.
4. Enable Auto Recovery.

Whenever an account crashes and is relaunched, your executor will automatically execute the necessary scripts to resume farming seamlessly.

Method 2: Presence Auto Recovery

If you don't use an executor, you can enable Presence Recovery. Instead of relying on script injection, Citrus will utilize Roblox's web APIs to periodically check if the account's presence has dropped out of the game. If it detects a disconnect, it will autonomously restart the Roblox client.

Script Manager

Citrus features a robust built-in script executor that communicates directly with your game clients.

You can type any Luau code into the editor, select specific accounts from your Manager tab, and click Execute. Citrus securely executes your script instructions within the selected clients for immediate execution.

Discord Webhooks

Track your farm remotely by linking Citrus Auto to a Discord channel.

• Notify Account Expiration: Sends an alert if an account cookie becomes invalid.
• Notify Captcha: Sends an alert when an account encounters a FunCaptcha.
• Show Stats: (Requires Exploit Mode) Citrus safely tracks live in-game statistics (e.g., Coins, Level, Gems) and compiles them into a clean, easy-to-read embed format in your server.

Tutorial: How to get a Webhook

Follow these exact steps to create a Discord Webhook URL to paste into Citrus Auto, or you can watch the video tutorial below:

1. Open Discord and navigate to the server where you want to receive notifications. (You must have Manage Webhooks permissions).
2. Click the Server Name at the top left, and select Server Settings.
3. On the left sidebar, click on Integrations.
4. Click on Webhooks, then click the New Webhook button.
5. Customize the webhook (name it "Citrus Auto" and select the text channel you want it to post in).
6. Click the Copy Webhook URL button.
7. Go back to Citrus Auto, navigate to the Webhook tab, and paste the URL into the input box. Check the "Enable Webhook" box to start receiving updates!

Roblox Launchers

Citrus natively supports launching accounts through a variety of modern Roblox bootstrappers and custom clients.

Supported Bootstrappers

Under the Settings tab, you can change your Roblox Launcher to natively support the following:

• Protocol (Default): Standard roblox-player:// method.
• Bloxstrap, Fishstrap, Froststrap, Voidstrap: Automatically maps the launch directly through your installed third-party bootstrapper.
• Roblox Client: Directly boots the executable file, bypassing standard web protocols.

Custom Launchers (RDD)

If you use custom Roblox bootstrappers like RDD (Roblox Deployment Downloader) you can configure Citrus to utilize them manually. You can download your specified RDD version at https://rdd.weao.gg/.

1. Set your Roblox Launcher to Custom (RDD).
2. Click the Folder Icon button that appears.
3. Navigate to the folder containing your custom client executable and select it. (Please extract your ZIP file before selecting).
4. Citrus will now correctly route launches through your selected custom folder.

Network & DNS

Under Network Settings, you can enable the DNS Resolver. This automatically optimizes your system's DNS routing to Cloudflare (1.1.1.1).

This is highly recommended if you are experiencing connection drops, ping issues, or if you are using specific custom clients. This is also specifically made for Potassium Executor to bypass ratelimit errors.

UI & Personalization

Citrus Auto provides a suite of tools to personalize your workspace and keep everything organized.

• Themes: In Settings, you can swap your UI accent color between Red, Orange, Yellow, Green, Blue, Indigo, Violet, or an animated Rainbow theme.
• Top Most: Keeps the Citrus Auto window persistently pinned on top of all other windows, ensuring you can manage your farm without losing track of your UI.
• Auto Roblox Tile: If enabled alongside Top Most, Citrus will automatically and neatly tile all open Roblox windows across your monitor into a grid for easy mass viewing.

Troubleshooting / FAQ

Accounts are failing to join?

You must verify if a game is confirmed, if the cookie is valid, or if you have selected Ratelimit Mode which causes a 2-minute delay before each join.

Webhooks aren't sending?

Verify that you pasted the entire URL (it should start with https://discord.com/api/webhooks/...). Ensure the Discord channel hasn't been deleted and that your webhook cooldown isn't set too high in your settings. Stat tracking requires Exploit Mode.

Why is the Script Manager not executing code?

You must enable Exploit Mode in Settings, have a client connected/in-game, and the account must be selected in the Manager tab.

Why is the auto captcha solver not working?

You must have a valid YesCaptcha key, which you can purchase by getting Citrus Auto Ultra or buying it separately from citrusauto.cc/plans.