🚀 Boda Handler v2.0.0

✨ Features

• 🎨 Beautiful Console Interface - Stunning visual feedback with colors, animations, and tables
• 🌈 Multiple Themes - Choose from Default, Neon, or Dark themes
• ⚡ Lightning Fast - Optimized performance with async/await throughout
• 🔧 Interactive CLI - Complete command-line interface for easy management
• 📊 Real-time Statistics - Monitor your bot's performance and usage
• 🎯 Smart Error Handling - Comprehensive error tracking and reporting
• 🔄 Auto-reload - Automatic command and event reloading
• 📱 Slash Commands - Full support for Discord's slash commands
• 🛡️ Type Safety - Built with modern JavaScript standards
• 🚀 Easy Setup - Get started in seconds with our interactive wizard

🎬 Demo

# Initialize with beautiful animations
npx boda-handler init

# Interactive setup wizard
npx boda-handler setup

# Create components instantly
npx boda-handler create command ping
npx boda-handler create slash userinfo
npx boda-handler create event guildMemberAdd

📦 Installation

npm install boda-handler

🚀 Quick Start

Method 1: Using CLI (Recommended)

# Interactive setup with beautiful interface
npx boda-handler setup

# Or quick initialization
npx boda-handler init --theme neon

Method 2: Programmatic Setup

const BodaHandler = require('boda-handler');

const handler = new BodaHandler({
  theme: 'neon',        // 'default', 'neon', 'dark'
  animation: true,      // Enable beautiful animations
  showStats: true,      // Display performance statistics
  silent: false         // Show all output
});

await handler.init();

🎨 Themes

🌈 Neon Theme (Default)

Vibrant colors with electric blue and hot pink accents

🔵 Default Theme

Classic blue and green color scheme

🌑 Dark Theme

Elegant monochrome with bright accents

🛠️ CLI Commands

| Command | Description | Options | |---------|-------------|---------| | init | Initialize new bot project | --theme, --silent, --no-animation | | setup | Interactive setup wizard | None | | create <type> <name> | Create command/event/slash | --category, --description | | info | Show handler information | None |

Examples:

# Create a moderation command
npx boda-handler create command ban --category "Moderation" --description "Ban a user"

# Create a welcome event
npx boda-handler create event guildMemberAdd --description "Welcome new members"

# Create a slash command
npx boda-handler create slash ping --description "Check bot latency"

📁 Project Structure

your-bot/
├── 📁 Handler/
│   ├── Commands.js       # Command loader with beautiful output
│   ├── Events.js         # Event loader with status tracking
│   └── SlashCommand.js   # Slash command handler
├── 📁 Commands/
│   └── ping.js          # Example command with rich embed
├── 📁 Events/
│   ├── ready.js         # Bot ready event with stats
│   ├── messageCreate.js # Message handler
│   └── interactionCreate.js # Interaction handler
├── 📁 SlashCommand/
│   └── serverinfo.js    # Example slash command
├── 📁 Config/
│   └── config.js        # Bot configuration
├── 📄 .env              # Environment variables
└── 📄 index.js          # Main bot file

🔧 Configuration

Environment Variables (.env)

# Discord Bot Configuration
TOKEN=your_bot_token_here
PREFIX=-
OWNER_ID=your_user_id_here

# Handler Configuration
THEME=neon
SHOW_STATS=true
ANIMATION=true

Config File (Config/config.js)

module.exports = {
  bot: {
    prefix: process.env.PREFIX || '-',
    token: process.env.TOKEN,
    ownerID: process.env.OWNER_ID
  },
  handler: {
    theme: 'neon',
    showStats: true,
    animation: true,
    silent: false
  },
  // ... more configuration options
};

📝 Creating Commands

Regular Commands

module.exports = {
  name: 'ping',
  description: 'Check bot latency',
  category: 'Utility',
  usage: 'ping',
  cooldown: 3000,
  run: async (client, message, args) => {
    const embed = {
      color: 0x00ff00,
      title: '🏓 Pong!',
      fields: [
        {
          name: '📡 WebSocket Ping',
          value: `${client.ws.ping}ms`,
          inline: true
        }
      ]
    };
    
    message.reply({ embeds: [embed] });
  }
};

Slash Commands

module.exports = {
  name: 'serverinfo',
  description: 'Get server information',
  options: [
    {
      name: 'detailed',
      description: 'Show detailed information',
      type: 5,
      required: false
    }
  ],
  run: async (client, interaction) => {
    // Your slash command code
    await interaction.reply({ content: 'Server info!' });
  }
};

🎭 Events

const chalk = require('chalk');

module.exports = async (client, member) => {
  console.log(chalk.green(`✅ New member joined: ${member.user.tag}`));
  
  // Your event code here
};

📊 Statistics & Monitoring

The handler automatically tracks:

• ⏱️ Setup time and performance
• 📈 Commands loaded and executed
• 🎭 Events registered and triggered
• ❌ Errors and warnings
• 📊 Real-time bot statistics

🔍 Advanced Features

Custom Themes

const handler = new BodaHandler({
  theme: 'custom',
  customTheme: {
    primary: chalk.hex('#your-color'),
    secondary: chalk.hex('#your-color'),
    // ... more colors
  }
});

Performance Monitoring

const stats = handler.getStats();
console.log('Commands loaded:', stats.commandsLoaded);
console.log('Setup time:', stats.setupTime);

Error Tracking

All errors are automatically logged with beautiful formatting and context information.

🛡️ Error Handling

The handler includes comprehensive error handling:

• Command execution errors
• Event listener errors
• File loading errors
• API communication errors

All errors are displayed with beautiful formatting and helpful context.

🚀 Pro Tips

1. Use Environment Variables - Keep your token secure in .env
2. Organize Commands - Use categories to organize your commands
3. Custom Themes - Create your own theme for unique branding
4. Monitor Performance - Enable statistics to track bot performance
5. Interactive Setup - Use npx boda-handler setup for best experience

🤝 Contributing

We welcome contributions! Please feel free to submit a Pull Request.

📄 License

This project is licensed under the MIT License - see the LICENSE file for details.

👨‍💻 Author

Boda - Creator and maintainer

🌟 Support

If you find this handler useful, please consider:

• ⭐ Starring the repository
• 🐛 Reporting bugs
• 💡 Suggesting new features
• 📢 Sharing with others