Skip to content
ad1107 edited this page May 24, 2025 · 2 revisions

Welcome to UtilsBot+ Wiki

A modern, feature-rich Discord bot built with Python 3.11+ and discord.py 2.4+

UtilsBot+ provides comprehensive utilities including AI integration, interactive games, network tools, security features, and developer commands—all through intuitive slash commands.

🚀 Quick Start

New to UtilsBot+? Start here:

  1. 2. Getting Started - Installation and basic setup
  2. 3. For Users - User-friendly guide to all commands
  3. 4. Commands Reference - Complete technical command list

📚 Documentation Navigation

👥 For Discord Users

🛠️ For Bot Administrators

💻 For Developers

🆕 Recent Enhancements (Latest Update)

We've significantly improved the bot's user experience and functionality with these major updates:

🛠️ Enhanced Help System

  • Complete /help command rewrite with modern UI design
  • Category-based filtering with emoji icons (ℹ️ Information, 🤖 AI, 🎮 Games, etc.)
  • Smart command grouping with support for subcommands
  • Developer permission indicators (🔒) for system commands
  • Interactive autocomplete for category selection
  • Built-in usage guides and documentation links
  • Responsive field splitting for large command lists

🎭 Dynamic Bot Status System

  • Intelligent status rotation based on time of day
  • Real-time server and user statistics in bot presence
  • Milestone celebrations (server count achievements)
  • Performance-aware status updates (every 30 minutes)
  • Contextual activity types (Playing, Watching, Listening)
  • Uptime tracking and display

🔗 Bot Invite Management

  • Standalone invite generator script (generate_invite.py)
  • In-Discord /invite command with permission customization
  • Multiple permission presets: Minimal, Recommended, Network Tools, Administrator
  • Interactive permission selection with detailed descriptions
  • Automatic bot ID detection from environment settings
  • Save-to-file functionality for generated invite links

🏗️ Technical Improvements

  • Enhanced error handling with user-friendly messages
  • Improved autocomplete systems across all commands
  • Better embed formatting with consistent styling
  • Optimized database interactions for status updates
  • Comprehensive logging for all new features

✨ Key Features

🤖 AI Integration

  • Google Gemini 1.5 Flash integration for intelligent responses
  • Interactive chat sessions with context awareness
  • Free tier with generous limits (15 requests/minute)

🎮 Interactive Games

  • Full Wordle implementation with color-coded feedback
  • Game statistics and progress tracking
  • Extensible game framework for future additions

🌐 Network Tools

  • Website screenshots with customizable options
  • IP geolocation with comprehensive data
  • URL unshortening with security checks

🔐 Security & Utilities

  • TOTP generation for two-factor authentication
  • QR code creation with multiple sizes
  • Text encoding/decoding (Base64, hashing)
  • Secure password generation

🛠️ Developer Tools

  • Command synchronization (global and guild-specific)
  • Code evaluation with secure sandboxing
  • Hot reloading for development efficiency
  • Comprehensive logging and monitoring

🏗️ Architecture Highlights

  • Slash Commands Only - Modern Discord UX
  • Async-First Design - High performance and responsiveness
  • Modular Cog System - Easy feature management
  • Type Safety - Full type hints and validation
  • Database Integration - SQLAlchemy with async support
  • Comprehensive Error Handling - Robust error management

🔧 Technology Stack

  • Discord.py 2.4+ - Modern Discord API wrapper
  • SQLAlchemy 2.0 - Async database ORM
  • Google Generative AI - Gemini 1.5 Flash integration
  • Pydantic 2.8+ - Configuration validation
  • Structlog - Structured logging
  • aiohttp/httpx - Async HTTP clients

📖 Getting Help

🤝 Contributing

We welcome contributions! See 7. Developer Guide for:

  • Code structure and standards
  • Setting up development environment
  • Submitting pull requests
  • Adding new features

📄 License

UtilsBot+ is open source software licensed under the MIT License.


Navigation: 2. Getting Started3. For Users4. Commands Reference

Clone this wiki locally