# CustomLevelingBot A highly customizable Discord leveling bot with multi-skill progression, configurable XP thresholds, role rewards, and a RESTful API for external integration. ## Features - ✨ **Fully Customizable XP System** - Set custom XP requirements for each level - 🎯 **Multiple Skill Categories** - Track progress across different skill types - 🏆 **Leaderboards** - Global and per-skill leaderboards - 🎁 **Level Rewards** - Automatic role assignments and custom messages - ⚙️ **Admin Controls** - Comprehensive configuration commands - 🌐 **RESTful API** - External integration for games and applications - 📊 **Real-Time Tracking** - Live progress monitoring and statistics ## Setup ### 1. Install Dependencies ```bash pip install -r requirements.txt ``` ### 2. Configure Environment Edit `.env` file: ```env DISCORD_TOKEN=your_actual_discord_bot_token API_PORT=8080 API_HOST=0.0.0.0 API_SECRET_KEY=your_secure_api_key ``` ### 3. Run the Bot ```bash python bot.py ``` ## Commands ### User Commands - `/rank [member]` - View rank and XP statistics - `/skills [member]` - View skill levels and progress - `/leaderboard [skill]` - View server leaderboards ### Admin Commands #### Configuration - `/config xp_rate ` - Set XP per message - `/config cooldown ` - Set XP cooldown - `/config multiplier ` - Set global XP multiplier - `/config levelup_message ` - Customize level-up message - `/config set_level_xp ` - Set custom XP requirement - `/config view` - View current configuration #### Skills - `/skill add [multiplier]` - Add skill category - `/skill remove ` - Remove skill category - `/skill list` - List all skills #### Rewards - `/reward add_role ` - Add role reward - `/reward add_message ` - Add message reward - `/reward remove ` - Remove reward - `/reward list ` - List rewards for level #### Manual XP - `/addxp [skill]` - Add XP manually ## API Endpoints All endpoints require the `X-API-Key` header with your secret key. ### GET /api/health Health check endpoint. ### GET /api/player/{user_id}/stats?guild_id={guild_id} Get player statistics. **Response:** ```json { "user_id": 123456789, "guild_id": 987654321, "total_xp": 5000, "level": 15, "rank": 3, "xp_progress": 200, "xp_required": 2500 } ``` ### POST /api/player/{user_id}/xp Add XP to a player. **Request Body:** ```json { "guild_id": 987654321, "xp": 100, "skill": "Combat" } ``` ### GET /api/leaderboard/{guild_id}?limit=10&skill=Combat Get leaderboard data. ### GET /api/config/{guild_id} Get server configuration. ## Database Schema The bot uses SQLite with the following tables: - `players` - User progression data - `skills` - Skill-specific XP tracking - `level_configs` - Custom level requirements - `skill_categories` - Available skills per server - `rewards` - Level-based rewards - `guild_settings` - Server configurations ## Customization Examples ### Custom Level Requirements ``` /config set_level_xp 10 5000 /config set_level_xp 20 15000 /config set_level_xp 50 100000 ``` ### Add Skill Categories ``` /skill add Combat 1.5 /skill add Mining 1.0 /skill add Social 0.8 ``` ### Configure Rewards ``` /reward add_role 10 @Novice /reward add_role 25 @Expert /reward add_message 50 You've reached Master rank! ``` ## License MIT License - Feel free to modify and use for your server!