01. Home - utils-bot/utils-bot-plus GitHub Wiki

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 Started โ†’ 3. For Users โ†’ 4. Commands Reference

โš ๏ธ **GitHub.com Fallback** โš ๏ธ