# MCPVP Tiers Bot - Setup Guide ## 📋 Prerequisites - Python 3.8 or higher - Discord Bot Token - Discord Server with Administrator permissions ## 🚀 Quick Setup ### 1. Install Dependencies ```bash pip install -r requirements.txt ``` ### 2. Configure Bot Token 1. Create a `.env` file in the root directory 2. Add your Discord bot token: ``` DISCORD_TOKEN=your_discord_bot_token_here ``` ### 3. Get Your Bot Token 1. Go to [Discord Developer Portal](https://discord.com/developers/applications) 2. Create a New Application 3. Go to the "Bot" section 4. Click "Reset Token" to get your token 5. Copy the token to your `.env` file ### 4. Invite Bot to Server Use this URL (replace YOUR_CLIENT_ID with your application's client ID): ``` https://discord.com/api/oauth2/authorize?client_id=YOUR_CLIENT_ID&permissions=8&scope=bot%20applications.commands ``` ### 5. Run the Bot ```bash python main.py ``` ## ⚙️ Configuration ### Set Staff Roles After the bot is running, use these commands in your Discord server: ``` /setrole role_type:Admin Role role:@YourAdminRole /setrole role_type:Moderator Role role:@YourModRole /setrole role_type:Queue Manager Role role:@YourQueueManagerRole ``` ## 📚 Commands Overview ### Public Commands - `/tiers ` - View tier information for any player - `/leaderboard [gamemode]` - View the leaderboard (alias: `/lb`) - `/queuestatus` - Check current queue status - `/leavequeue` - Leave your current queue ### Queue Manager Commands - `/queue ` - Open a queue for a specific gamemode ### Moderator Commands - `/settier ` - Set a player's tier - `/setpoints ` - Set a player's points - `/setgamemode ` - Set a player's gamemode - `/cheater [reason]` - Ban a player from queues - `/unban ` - Unban a player - `/baninfo ` - Check ban information - `/createplayer ` - Create a new player profile ### Admin Commands - All moderator commands - `/setrole ` - Configure staff roles ## 🎮 Gamemodes - Ranked - Unranked - Diapot - Mace ## 🏆 Tier System - **High Tier:** HT1, HT2, HT3, HT4, HT5 - **Mid Tier:** MT1, MT2, MT3, MT4, MT5 - **Low Tier:** LT1, LT2, LT3, LT4, LT5 ## 🗄️ Database The bot uses SQLite for data storage. The database file `mcpvp_tiers.db` will be created automatically on first run. ## 🐛 Troubleshooting ### Bot not responding to commands 1. Make sure the bot has proper permissions in your server 2. Check if commands are synced (should happen automatically on startup) 3. Verify the bot is online ### Commands not showing up 1. Wait a few minutes for Discord to propagate commands 2. Try right-clicking the server icon → Server Settings → Integrations 3. Restart Discord client ### Database errors 1. Make sure the bot has write permissions in the directory 2. Check if `mcpvp_tiers.db` exists and is not corrupted 3. Delete the database file and restart (will reset all data) ## 📞 Support For issues or questions, check the bot's console output for error messages. ## 🔒 Security - Never share your `.env` file or bot token - Keep your bot token secure and private - Regenerate your token if it's compromised