# 2. Using Bot
## ๐ Prerequisites
Before starting the bot, you need:
1. Recorded spot
2. Combat combo for your class
3. Proper game settings
## ๐ฏ Part 1: Spot Recording
### ๐ฅ Recording Interface
### Step-by-Step Recording
1. **Start Recording**
* Click "Start Recording"
* Initial minimap image is captured automatically
* โ ๏ธ Make sure minimap is properly positioned
2. **Add Waypoints**
* Move to desired location
* Click "Add Waypoint"
* Configure waypoint properties:
| Property | Description | Notes |
| ------------ | ------------------------------- | --------------------------------- |
| **Type** | Movement, Kill, Repair, Storage | Select based on waypoint purpose |
| **Radius** | Arrival detection radius | Default: 0 - exact position match |
| **Position** | X, Y coordinates | Auto-captured, can be adjusted |
3. **Waypoint Types & Configuration**
* ๐ **Movement**: Navigation waypoint
* `WaitAfterArrivalMs`: Delay after reaching position (milliseconds)
* โ๏ธ **Kill**: Combat waypoint with two completion modes:
| Mode | Description |
| ------------- | ------------------------------------------------------ |
| **NoTargets** | Fight until no HP bars detected after camera rotations |
| **Duration** | Fight for a specific duration in seconds |
Kill settings:
* `CombatRadius`: Combat area radius in pixels
* `StayInRadius`: Stay within combat radius during combat
* `ReturnToCenter`: Return to waypoint center after combat
* `CameraRotations`: Rotations before declaring clear (NoTargets mode)
* `DurationSeconds`: Combat duration (Duration mode)
* ๐ ๏ธ **Repair**: Tent/repair location
* Must place tent exactly at this point
* Bot will interact with tent automatically
* ๐ฆ **Storage**: Storage waypoint
| Storage Type | Description |
| ------------ | ---------------------------- |
| **Maid** | Use storage maid for deposit |
| **Horse** | Use horse for storage access |
4. **Save & Manage Spots**
* Enter unique route name
* Click "Save Spot"
* Files stored in Spots folder
* Can load/edit existing spots
### ๐ก Recording Tips
* Design circular routes for efficiency
* Position tent at exact repair waypoint
* Place storage points in safe zones (preferably near tent)
* Always test route manually before botting
* Use minimal radius values when possible
### ๐ค Community Spot Sharing
Share and download grinding spots with the community:
#### ๐ Publishing a Spot:
1. Sign in with Discord (required)
2. Go to Community page โ **SPOTS** tab
3. Click "UPLOAD SPOT"
4. Select a local spot file
5. Add metadata:
* Name (required)
* Tags (optional)
* Description (optional)
6. Click "Upload"
#### ๐ Features:
* ๐บ๏ธ Minimap preview for each spot
* โญ Rating system (1-5 stars + comments)
* ๐ Sort by: Recent, Rating, Downloads, Name
* ๐ฅ Downloads saved to local `Spots/` folder
#### ๐ Metadata Tracked:
* Author (Discord profile)
* Download count
* Average rating
* Waypoint count
* Creation date
## ๐ฎ Part 2: Bot Configuration
### Main Interface
The Bot Control page features a streamlined interface for configuring and monitoring automation.
### ๐๏ธ Configuration Panel
Configure your bot with three simple dropdowns:
| Selector | Description | Notes |
| ------------ | ------------------------------------ | ---------------------------------- |
| **SPOT** | Select your recorded farming route | Auto-sorted by most recent |
| **CLASS** | Select your character's combat class | Triggers rotation list reload |
| **ROTATION** | Select combat skill rotation | Loads rotations for selected class |
### โถ๏ธ Bot Controls
| Control | Description |
| --------- | ----------------------------------- |
| **START** | Begin bot automation (green button) |
| **STOP** | Stop bot automation (red button) |
| **F7** | Global hotkey to toggle bot on/off |
### ๐ Live Metrics Dashboard
The interface displays real-time information in organized cards:
#### ๐งญ Navigation Card
| Metric | Description |
| ------------ | ----------------------------------------- |
| **ANGLE** | Current character facing direction (ยฐ) |
| **TARGET** | Bot's target facing direction (ยฐ) |
| **POSITION** | X, Y coordinates with tracking confidence |
#### ๐ฏ Waypoint Card
| Metric | Description |
| ----------------- | ------------------------------------------- |
| **PROGRESS** | Current waypoint / Total (e.g., "WP 5/10") |
| **NEXT WAYPOINT** | Coordinates, type, and radius of next point |
#### ๐๏ธ Detection Card
| Metric | Indicator | Description |
| ---------------- | --------- | ---------------------------- |
| **HP BARS** | ๐ด Count | Detected monster HP bars |
| **MINIMAP MOBS** | ๐ Count | Monsters detected on minimap |
| **REPAIR** | ๐ข/๐ด Dot | Equipment durability status |
| **STORAGE** | ๐ข/๐ด Dot | Inventory fullness status |
### ๐ฌ Debug CV Lab
Access the **Debug CV Lab** from the sidebar (debug mode) to test and verify detection systems:
| Tab | Purpose |
| -------------- | --------------------------------------------- |
| ๐ Position | Test position tracking and minimap reading |
| ๐งญ Angle | Test character direction detection |
| ๐พ Monsters | Test minimap monster detection |
| ๐ Stats | Test HP/MP bar detection |
| ๐ HP Bars | Test monster HP bar detection (golden pixels) |
| ๐ง Maintenance | Test repair/storage detection |
| โก Skills | Test skill cooldown detection |
> ๐ก Use Debug CV Lab to verify all detection systems are working correctly before starting the bot.
### ๐ Bot States
| State | Description | Indicator |
| ----------- | -------------------------- | --------- |
| โซ Idle | Bot loaded but not running | Gray |
| ๐ก Starting | Initialization in progress | Yellow |
| ๐ข Running | Active automation | Green |
| ๐ด Error | Failure occurred | Red |
| ๐ก Stopping | Shutdown in progress | Yellow |
### โ๏ธ Settings (Sidebar โ Settings)
Configure bot behavior in the Settings page:
#### ๐ฅ๏ธ Virtual Machine Tab
* Connect to Hyper-V virtual machines
* Select streaming client (Parsec, Custom)
* Configure window class for input routing
#### โจ๏ธ Hotkeys Tab
* Configure bot Start/Stop hotkey (default: F7)
* Enable/disable global hotkeys
#### ๐ฎ Skill Keys Tab
* Map combat skills to keyboard keys
* Class-specific skill bindings
#### ๐งช Consumables Tab
* Configure auto-use for potions/buffs
* Set usage triggers and intervals
#### ๐ฑ Telegram Tab
* Connect Telegram bot for remote control
* Configure event notifications (death, stuck, repair, storage)
* See [Telegram Integration](https://pixelbot-docs.gitbook.io/pixelbot/products/broken-reference) for setup guide
## ๐งช Part 3: Consumables Management
Configure automatic buff and pet management:
| Consumable | Default Interval | Description |
| ----------- | ---------------- | -------------------------- |
| ๐พ Pet Feed | 5 minutes | Keeps pets fed and looting |
| ๐ Food | 30 minutes | Maintains food buffs |
| ๐งช Draught | 15 minutes | Refreshes draught buffs |
| ๐ Elixir | 5 minutes | Maintains elixir buffs |
### Configuration
1. Enable/disable each consumable type
2. Set custom intervals based on buff duration
3. Assign correct hotkeys matching your hotbar
> โ ๏ธ Make sure consumables are in your hotbar with correct keybinds
***
## ๐ Stuck Recovery System
The bot uses skills marked as **Stuck** type for recovery:
* **Detection**: Uses `MovementStallThresholdMs` parameter (default: 1+ seconds)
* **Recovery**: Executes skills assigned to the **Stuck** category in your rotation
* **Resume**: Returns to normal navigation after successful escape
> ๐ก Configure stuck recovery skills in **Combo Creation** by assigning movement skills to the **Stuck** category.
***
## ๐ Troubleshooting Guide
| Issue | Solution | Prevention |
| -------------- | -------------------------------------- | ------------------------------- |
| Not Moving | Test Position in Debug CV Lab | Verify minimap settings |
| Skip Attacks | Check MinimumCastTimeMs & key bindings | Test combo separately |
| No Monsters | Test HP Bars/Monsters in Debug CV Lab | Verify BW\_light photo filter |
| Getting Stuck | Add Stuck skills to rotation | Configure Stuck category skills |
| Buffs Dropping | Reduce consumable intervals | Match to buff duration |
| Wrong Angle | Test Angle in Debug CV Lab | Check camera settings |
| Repair Issues | Test Maintenance in Debug CV Lab | Verify tent placement |
> ๐ก Always use **Debug CV Lab** to test detection systems before starting the bot!
## โ ๏ธ Important Notes
### 1. Pre-Start Checklist
* โ
Clear inventory space
* โ
Check equipment durability
* โ
Verify game settings (see [Black Desert](https://pixelbot-docs.gitbook.io/pixelbot/configuration/bdo) page)
* โ
Position tent at Repair waypoint
* โ
Test all detection in **Debug CV Lab**:
* Position tracking working
* Angle detection accurate
* HP Bars detecting monsters
* Minimap monsters visible
### 2. Performance Requirements
* Use War Mode settings
* Remove unnecessary UI elements
* Maintain consistent FPS and Internet connection (100mbs required)
* Keep area clear of obstructions