> For the complete documentation index, see [llms.txt](https://xgine.gitbook.io/xgine-docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://xgine.gitbook.io/xgine-docs/advanced-features/antibot-solver.md).

# Anti-Bot Solver

Stay online without interruptions! The Anti-Bot Solver automatically detects and handles captcha challenges from various private servers.

***

## 🎯 Overview

Many private servers implement anti-bot systems to verify players. Ragnabot can automatically detect and solve these challenges, keeping your gameplay uninterrupted.

{% hint style="info" %}
The Anti-Bot Solver supports multiple captcha formats commonly used by private servers.
{% endhint %}

***

## 🧩 Supported Captcha Types

| Type                | Description                          |
| ------------------- | ------------------------------------ |
| **Text Captcha**    | Enter the displayed text/numbers     |
| **Card Matching**   | Select the correct card from options |
| **Multiple Choice** | Choose the correct answer            |

***

## ⚙️ TrueCaptcha Integration

For text-based captchas, Ragnabot integrates with [TrueCaptcha](https://truecaptcha.org/) for accurate OCR recognition.

### Setup Steps

<details>

<summary><strong>Step 1: Create TrueCaptcha Account</strong></summary>

1. Visit [TrueCaptcha](https://truecaptcha.org/)
2. Register for a free account
3. Verify your email

</details>

<details>

<summary><strong>Step 2: Get Your Credentials</strong></summary>

1. Log into your TrueCaptcha dashboard
2. Find your **User ID** and **API Key**
3. Copy these values

</details>

<details>

<summary><strong>Step 3: Configure in Ragnabot</strong></summary>

1. Open Ragnabot settings
2. Navigate to Anti-Bot section
3. Enter your User ID and API Key
4. Save settings

</details>

### Configuration

| Setting     | Description                 |
| ----------- | --------------------------- |
| **User ID** | Your TrueCaptcha account ID |
| **API Key** | Your TrueCaptcha API key    |

{% hint style="warning" %}
**Important:** Keep your API credentials secure and never share them publicly.
{% endhint %}

***

## 🔔 Alert System

Get notified when captcha solving needs attention:

| Alert Type               | When It Triggers               |
| ------------------------ | ------------------------------ |
| **🔊 Sound Alarm**       | Play audio alert on failure    |
| **📱 Push Notification** | Send alert to your device      |
| **⏸️ Pause Bot**         | Stop automation until resolved |

{% hint style="success" %}
**Recommended:** Enable push notifications so you can respond quickly even when away from your computer.
{% endhint %}

***

## 🔄 Retry Settings

Configure how the system handles failed attempts:

| Setting          | Description                     |
| ---------------- | ------------------------------- |
| **Max Attempts** | Number of tries before alerting |
| **Retry Delay**  | Wait time between attempts      |

***

## 💡 Best Practices

1. **Maintain API Credits** — Ensure your TrueCaptcha account has sufficient balance
2. **Test Before AFK** — Verify captcha solving works on your server
3. **Enable Notifications** — Get alerted to failures immediately
4. **Check Regularly** — Some captchas may require manual intervention


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://xgine.gitbook.io/xgine-docs/advanced-features/antibot-solver.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.