Mambo the Omniscient

Uma Musume Fan Count Manager - Discord Bot 📊 Overview A professional Discord bot designed to manage and track fan counts for Uma Musume clubs. The bot automatically syncs data from chronogenen.net and provides detailed statistics, leaderboards, and comprehensive member management tools.

⭐ Key Features 🔄 Automatic Data Synchronization Daily Auto-sync: Bot automatically updates fan count data from chronogenen.net around 10:15-10:20 AM UTC daily Smart Caching System: Intelligent caching system with 24-hour TTL, automatic refresh and disk persistence for reliability Google Sheets Integration: Direct integration with Google Sheets, supporting retry logic and exponential backoff for stable connections Offline Mode: Operates with local cache when internet connection is lost 📈 Statistics & Leaderboards Detailed Leaderboard: Display member rankings by total fans, daily fans, surplus/deficit 2 Club Modes Support: Competitive (with quota) and Casual (no quota) Member Statistics: View detailed individual member stats with daily fan growth charts Multiple Sorting Options: Sort by various criteria (total fans, daily, surplus, etc.) 🔍 Search & Discovery Search Club: Search and view data for any club on chronogenen.net Club Request System: Users can request new clubs to be added to the tracking system with admin approval workflow Autocomplete: Smart club and member name suggestions when entering commands 👥 Club Management (Admin) Club Creation: Automatically create new clubs from API or import from Excel files Member Management: Add/remove members, update quotas, manage member lists Club Configuration: Set quota, webhook URL, club type, and other settings Excel Import/Export: Import data from Excel files, export for backup 🔔 Notifications & Webhooks Discord Webhook Integration: Send fan count update notifications via webhook Change Log Channel: Automatically log all configuration changes to dedicated channel Request Notifications: Admins receive notifications for new club requests 🛡️ Permission System God Mode: Highest level admin, not restricted by channel limitations Admin Roles: Support multiple admin roles with full permissions Channel Restrictions: Limit bot to operate only in allowed channels Multi-Server Support: Manage multiple allowed channels across different servers 💾 Backup & Reliability Disk Persistence: Cache saved to disk, automatic restore on bot restart Retry Mechanism: Automatic retry with exponential backoff on network errors Error Handling: Comprehensive error handling, fallback to cache when Google Sheets unavailable Update Detection: Automatically detect and invalidate cache when new updates available 🔧 System Commands Cache Management: Clear cache, view cache stats, warm cache Bot Restart: Restart bot with notification Library Upgrade: Automatically upgrade dependencies and restart Health Check: Monitor bot status, uptime, connection health 🎯 Use Cases For Members:

View personal ranking and stats Compare progress with other members Search for other club information Request new clubs to be added to system For Club Admins:

Manage member lists and quotas Monitor daily club performance Receive notifications via webhook Export/Import Excel data For System Admins:

Manage multiple clubs across servers Configure permissions and channels Monitor system health Handle club requests 📊 Data Sources Primary: chronogenen.net API Storage: Google Sheets with service account authentication Cache: Local disk cache for reliability 🌟 Highlights ✅ High uptime with offline mode support ✅ Fast response time thanks to smart caching ✅ Scalable with multiple clubs and members ✅ User-friendly with autocomplete and beautiful embeds ✅ Secure with detailed permission system ✅ Regular updates and maintenance The bot is designed to run 24/7, automatically handle edge cases, and provide the best experience for both users and admins.