Documentation — ByteBunny

Installation

System Requirements

OS: Windows 10/11 (64-bit)
RAM: 4 GB minimum, 8 GB recommended
Disk: 200 MB free space
Network: Stable internet connection
Discord: Active Discord account

Quick Install

1

Download

Log into your dashboard and download the latest installer from the Downloads section.

2

Run Installer

Double-click the installer. It will automatically set up all dependencies and create a desktop shortcut.

3

Activate

Launch ByteBunny and enter your license key when prompted. HWID locks automatically on first activation.

4

Configure Token

Enter your Discord user token in Settings > Authentication. The token is encrypted and stored locally.

Configuration

Config File

ByteBunny uses a JSON config file located at %APPDATA%/ByteBunny/config.json. All settings can also be changed through the GUI.

config.json

{
  "prefix": "!",
  "token": "encrypted_token_here",
  "ai_mode": true,
  "auto_update": true,
  "theme": "cosmic",
  "modules": ["moderation", "automation", "fun", "utility"],
  "status_rotator": {
    "enabled": true,
    "interval": 30,
    "statuses": ["Playing ByteBunny", "In the lab"]
  }
}

Key Settings

Setting	Type	Default	Description
`prefix`	String	`!`	Command prefix character
`ai_mode`	Boolean	`true`	Enable AI-powered features
`auto_update`	Boolean	`true`	Auto-update on startup
`theme`	String	`cosmic`	GUI theme name
`modules`	Array	`["all"]`	Active module list

Commands

Command Categories

Moderation

!purge <count> — Delete messages
!nuke — Clear all messages in channel
!snipe — View last deleted message
!editsnipe — View last edited message

Automation

!autoreply <trigger> <response>
!schedule <time> <message>
!massreact <emoji>
!massdm <message>

Utility

!userinfo <user>
!serverinfo
!avatar <user>
!banner <user>

Fun

!ascii <text>
!mock <text>
!reverse <text>
!8ball <question>

Modules

Module System

ByteBunny uses a modular architecture. Enable or disable modules based on your needs.

Moderation

Message management, purge, snipe commands

Active

Automation

Auto-replies, scheduled messages, mass operations

Active

Utility

User info, server info, lookups

Active

Fun

Text manipulation, games, random generators

Active

AI Engine

Smart responses, context awareness, learning

Active

Status Rotator

Custom status cycling with scheduling

Optional

AI Features

AI v2 Engine

ByteBunny's AI engine uses OpenAI to provide intelligent auto-responses, context-aware suggestions, and conversation memory.

Enable AI

!ai enable          — Turn on AI mode
!ai personality fun  — Set AI personality
!ai memory on        — Enable conversation memory
!ai context 10       — Set context window (messages)

AI features require an active premium or trial license.

GUI Guide

Interface Overview

ByteBunny's GUI provides a visual control center for all features. Access it by clicking the system tray icon or pressing Ctrl+Shift+B.

Drag-and-drop command panel reordering

Real-time log viewer with search and filtering

Custom theme builder with live preview

Fullscreen mode for distraction-free use

Activity analytics with charts and metrics

API Reference

Overview

ByteBunny exposes a REST API for dashboard integrations, admin management, and third-party scripts. All endpoints live under /api/ and return JSON.

Authenticated endpoints require a Bearer token in the Authorization header. Obtain a token via /api/auth.php?action=login.

Example Request

curl -H "Authorization: Bearer YOUR_JWT_TOKEN" \
     https://bytebunnyselfbot.com/api/dashboard.php?action=stats

Authentication

Base URL: /api/auth.php?action=

Method	Action	Description
POST	`register`	Create a new account (username, email, password)
POST	`login`	Log in & receive a JWT token
GET	`user`	Get current authenticated user profile

User / Dashboard Endpoints

Base URL: /api/dashboard.php?action= — All require authentication.

Account & Profile

Method	Action	Description
GET	`stats`	Dashboard summary stats (licenses, orders, activity)
GET	`profile`	Get your profile details
PUT	`profile`	Update username or email
POST	`avatar`	Upload a profile avatar
DELETE	`avatar`	Remove your avatar
POST	`change_password`	Change password (requires current password)
GET	`export_data`	Export all your data (GDPR-style JSON)
POST	`account_delete`	Permanently delete your account (requires password + "DELETE" confirmation)

Licenses & Downloads

Method	Action	Description
GET	`licenses`	List your license keys
POST	`license_activate`	Activate / claim a license key
POST	`license_deactivate`	Reset HWID on a license
GET	`orders`	List your order history
GET	`downloads`	Available downloads & installer links

Activity & Notifications

Method	Action	Description
GET	`activity`	Recent account activity log
GET	`notifications`	Aggregated notifications (ticket replies, expiring licenses, achievements)
GET	`security_log`	Security-relevant login & auth events

Support & Tickets

Method	Action	Description
GET	`support`	List your support tickets
POST	`support`	Create a new support ticket
POST	`ticket_reply`	Reply to an existing ticket

Achievements & Referrals

Method	Action	Description
GET	`achievements`	List all achievements & your progress
POST	`achievements_check`	Trigger an achievement eligibility check
GET	`referrals`	Referral stats & history

API Keys & Usage

Method	Action	Description
GET	`api_keys`	List your API keys
POST	`api_keys`	Generate a new API key
DELETE	`api_keys`	Revoke an API key
GET	`usage`	API usage statistics

Admin Endpoints

Base URL: /api/admin.php?action= — Requires admin role. Most endpoints also require your IP to be whitelisted.

Admin API endpoints are protected by IP whitelisting. Add your IP via the Admin Panel > Security section before using these endpoints. The ip_whitelist and ip_whitelist_status actions are exempt so you can manage the whitelist itself.

Dashboard & Analytics

Method	Action	Description
GET	`stats`	Admin overview stats (users, revenue, licenses)
GET	`analytics`	Detailed analytics & charts data
GET	`activity`	Global activity feed (all users)
GET	`revenue_report`	Revenue report (params: `period` = 7d/30d/90d/1y/all)
GET	`license_report`	License distribution & activation stats
GET	`user_growth`	User registration growth over time
GET	`ticket_stats`	Support ticket statistics & response times
GET	`api_key_stats`	API key usage & active key counts
GET	`achievement_stats`	Achievement unlock rates & leaderboard
GET	`active_sessions`	Currently active user sessions

User Management

Method	Action	Description
GET	`users`	List all users (paginated, searchable)
GET	`user`	Get single user details
PUT	`user`	Update a user (ban, role, email, etc.)
DELETE	`user`	Delete a user account
POST	`bulk_users`	Bulk action on users (ban/unban/delete/promote/demote)
POST	`reset_user_password`	Force-reset a user's password
GET	`user_export`	Export all users (JSON or CSV)

License Management

Method	Action	Description
GET	`licenses`	List all licenses (paginated)
POST	`license`	Create a new license
PUT	`license`	Update a license
DELETE	`license`	Delete a license
POST	`bulk_licenses`	Generate up to 50 licenses at once

Orders & Tickets

Method	Action	Description
GET	`orders`	List all orders
PUT	`order`	Update order status
GET	`tickets`	List all support tickets
PUT	`ticket`	Update / respond to a ticket

Security & IP Whitelist

Method	Action	Description
GET	`ip_whitelist`	List whitelisted IPs
POST	`ip_whitelist`	Add an IP to the whitelist
DELETE	`ip_whitelist`	Remove an IP from the whitelist
GET	`ip_whitelist_status`	Check if IP whitelisting is enabled
PUT	`ip_whitelist_status`	Enable or disable IP whitelisting
GET	`audit_log`	Paginated admin audit log (filterable by action)

System & Maintenance

Method	Action	Description
GET	`system_health`	Database & system health check
GET	`site_settings`	Get all site settings
PUT	`site_settings`	Update site settings
POST	`toggle_maintenance`	Toggle maintenance mode on/off
POST	`database_cleanup`	Cleanup old data (activity/usage/expired_licenses/audit)
POST	`send_announcement`	Broadcast an announcement to users
POST	`revoke_all_keys`	Revoke all API keys for a user

Discord OAuth2

Base URL: /api/discord-auth.php?action=

Method	Action	Description
GET	`redirect`	Redirects to Discord OAuth consent screen (params: `mode` = login/register/link)
GET	`callback`	OAuth callback — exchanges code for token and completes flow
POST	`unlink`	Unlink Discord account from your profile (requires auth)

Public Settings

Base URL: /api/settings.php?action=

Method	Action	Description
GET	`public`	Get public site settings (maintenance mode, site name, etc.)
GET	`all`	Get all settings (admin only)
PUT	`update`	Update a setting (admin only)

Security

Security Model

Never share your Discord token or license key with anyone. ByteBunny staff will never ask for these.

HWID Lock — License bound to your hardware fingerprint

Token Encryption — AES-256 encrypted token storage

Zero Logs — No message content is ever logged or transmitted

Integrity Check — Binary verification on every update

Troubleshooting

Common Issues

"License Invalid" Error

Ensure you're using the correct license key. If you changed hardware, use the HWID Reset tool in Discord.

Bot Not Responding

Check your token is valid and your prefix is correct. Run !ping to test. If no response, restart ByteBunny.

Auto-Updater Stuck

This usually means a firewall is blocking the update server. Allow ByteBunny through your firewall or download the update manually.

GUI Won't Open

Try pressing Ctrl+Shift+B. If that doesn't work, restart the application. Check the system tray for the ByteBunny icon.

Still Need Help?

Join our Discord server for live support from the development team and community.

Join Support Server

Getting Started

Installation

System Requirements

Quick Install

Download

Run Installer

Activate

Configure Token

Configuration

Config File

Key Settings

Commands

Command Categories

Moderation

Automation

Utility

Fun

Modules

Module System

Moderation

Automation

Utility

Fun

AI Engine

Status Rotator

AI Features

AI v2 Engine

GUI Guide

Interface Overview

API Reference

Overview

Authentication

User / Dashboard Endpoints

Account & Profile

Licenses & Downloads

Activity & Notifications

Support & Tickets

Achievements & Referrals

API Keys & Usage

Admin Endpoints

Dashboard & Analytics

User Management

License Management

Orders & Tickets

Security & IP Whitelist

System & Maintenance

Discord OAuth2

Public Settings

Security

Security Model

Troubleshooting

Common Issues

"License Invalid" Error

Bot Not Responding

Auto-Updater Stuck

GUI Won't Open

Still Need Help?