# Getting Started

## 🔒 Secure Architecture

Our bot operates on a separate machine from your game, creating a completely isolated environment that makes detection impossible. Here's how it works

### Machine 1: Gaming Environment

* Runs only Black Desert Online
* No bot software installed
* Clean system with only game files
* Anticheat finds zero suspicious programs

### Machine 2: Bot Control

* Runs Pixel Bot software
* Processes game visuals
* Sends commands through streaming platform
* Completely separate from game environment

## 🌐 How the pieces fit together

{% @mermaid/diagram content="graph TD
subgraph Physical\_PC\["Your PC"]

```
    subgraph Host_PC["Host"]
        MoonlightHost["Streaming viewer\n(Moonlight / Parsec)"]
        Bot["Pixel Bot"]
    end

    subgraph VM["Virtual Machine"]
        BDO["Black Desert Online"]
        AntiCheat["Anti-Cheat"]
    end
end

MoonlightHost <-->|"Video stream"| VM
BDO -->|Monitored by| AntiCheat

Bot -->|Watches the game| VM
Bot -->|Sends input| VM

classDef physicalColor fill:#f0f0f0,stroke:#000000,stroke-width:2px;
classDef hostColor fill:#e6f7ff,stroke:#1890ff,stroke-width:2px;
classDef vmColor fill:#e0ffe0,stroke:#008000,stroke-width:2px;
classDef streamColor fill:#cce5ff,stroke:#3399ff,stroke-width:2px;
classDef botColor fill:#fff0f5,stroke:#ff69b4,stroke-width:2px;
classDef gameColor fill:#d5f5e3,stroke:#28a745,stroke-width:2px;
classDef antiCheatColor fill:#fffacd,stroke:#ffd700,stroke-width:2px;

class Physical_PC physicalColor;
class Host_PC hostColor;
class VM vmColor;
class MoonlightHost streamColor;
class Bot botColor;
class BDO gameColor;
class AntiCheat antiCheatColor;
```

" %}

The game lives inside a Virtual Machine. You watch it through Moonlight (or Parsec) like a remote desktop. The bot stays completely outside — it only sees the picture and sends commands.

## 🛡️ Security by Design

The bot never interacts directly with the game - it only processes the video stream and sends standard input commands. This means:

* No memory reading or writing
* No game file modifications
* No detectable software on gaming machine
* Pure visual analysis and standard inputs

## 💫 Setup

> A guided setup. No technical knowledge needed.

* Guided VM creation with GPU sharing
* Choose your streaming tool: Sunshine + Moonlight, or Parsec
* Full anticheat isolation out of the box

## 📋 Available Features

| Feature                | Description                                                   |
| ---------------------- | ------------------------------------------------------------- |
| ⚔️ Combat Automation   | Intelligent skill rotations with cooldown detection and flows |
| 🌍 AFK Farming         | Unlimited range position tracking - never get lost            |
| 📦 Storage Management  | Automatic junk storage via maid or horse                      |
| 🔧 Repair Gear         | Auto repair at your campsite                                  |
| 🧪 Consumables         | Potions, food, elixirs, draughts - all automated              |
| 🐾 Pet Feed            | Automatic pet feeding on customizable intervals               |
| 🔄 Stuck Recovery      | Smart detection and escape when character gets stuck          |
| 🛠️ Detection Services | Comprehensive detection modules for diagnostics               |
| 🔥 Rage Mode           | Automatic Normal/Rage combat mode switching                   |
| 🌐 Community           | Share and download rotations and spots with Discord auth      |
| 📱 Telegram Control    | Remote monitoring, control buttons, death/event notifications |

## 🎭 Supported Classes

| Class    | Status         |
| -------- | -------------- |
| Dosa     | ✅ Full Support |
| Guardian | ✅ Full Support |
| Wizzard  | ✅ Full Support |
| Seraph   | ✅ Full Support |
| Mystic   | ✅ Full Support |
| Sage     | Awakening      |
| Lahn     | Awakening      |

## 🎯 Best Grinding Spots

Works best at tower-style spots:

* Dekhia spots
* Hoglim Base
* Tungrad Ruins
* Similar pack-based locations and tower spots

## 🔔 Important Notes

Works on both official and private servers — the same VM setup provides full isolation against any anticheat. Keep your bot updated for optimal performance.


---

# 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:

```
GET https://pixelbot-docs.gitbook.io/pixelbot/readme.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
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.