> ## Documentation Index
> Fetch the complete documentation index at: https://docs.botifymanager.xyz/llms.txt
> Use this file to discover all available pages before exploring further.

# logs

> Real-time scrolling log viewer for all Botify activity.

The Logs tab provides a live, color-coded view of everything happening inside Botify — from bot launches and cookie refreshes to errors, warnings, and remote commands.

***

## Log Viewer

* **Real-Time Scrolling** — new entries appear automatically as events occur
* **Timestamps** — every entry includes a timestamp (date + time)
* **Level Indicators** — entries are color-coded by severity:

| Level     | Color        | Meaning                                                |
| --------- | ------------ | ------------------------------------------------------ |
| `INFO`    | White / Gray | Normal operation events                                |
| `SUCCESS` | Green        | Completed actions (bot joined, cookie refreshed, etc.) |
| `WARNING` | Yellow       | Non-critical issues (stale account, slow API response) |
| `ERROR`   | Red          | Failures requiring attention                           |

***

## Controls

| Button          | Action                                                                                  |
| --------------- | --------------------------------------------------------------------------------------- |
| **Clear**       | Clears the log viewer display — does **not** delete persisted logs from disk or MongoDB |
| **Auto-Scroll** | Keeps the view pinned to the latest entry; disable to scroll back through history       |

***

## Log Persistence

All log entries are written to **two destinations simultaneously**:

1. **`persistence_log.txt`** — local file saved in the same directory as `Botify.exe`
2. **`botify_logs` MongoDB collection** — cloud storage scoped per PC name and owner ID

<Info>
  MongoDB log storage lets you review activity history from any device and provides the audit trail used by the Remote Command system.
</Info>

***

## What Gets Logged

<AccordionGroup>
  <Accordion title="Bot & Engine Events">
    * Bot launch initiated (account username, target server)
    * Bot successfully joined server
    * Bot closed or killed
    * Engine start / stop events
    * Wave deployment progress (batch N of N)
    * Auto-remove triggered (server fill detection)
  </Accordion>

  <Accordion title="Cookie Events">
    * Auto-refresh cycle started / completed
    * Individual cookie refresh success / failure
    * Cookie validation on account add
    * Expired cookie detection
  </Accordion>

  <Accordion title="Server Monitoring">
    * PRC API poll results (player count)
    * Ghost server detection triggered
    * Ghost server reset completed (with cooldown timer)
    * Teleport error codes detected (524, 773, 279)
  </Accordion>

  <Accordion title="Anti-AFK & Watchdog">
    * Anti-AFK cycle completions (window count, action type)
    * Auto-Reconnect triggers (with pixel match confirmation)
    * Stale join alerts (account list, running time)
    * Jail detection events
  </Accordion>

  <Accordion title="Remote Commands & Auth">
    * Remote command received and executed
    * Command auth token validation (success / reject)
    * Authentication events (OAuth2 login, license validation)
    * Startup sequence steps
    * Errors and exceptions with stack traces
  </Accordion>
</AccordionGroup>