G1axWhitelist

# G1axWhitelist - Intelligent Tier-Based Auto-Whitelist ## 🎯 Transform Your Server's Player Management **G1axWhitelist** revolutionizes Minecraft server access control by automatically whitelisting skilled players based on their **MCTiers** and **PVPTiers** rankings. Say goodbye to manual whitelist management and hello to intelligent, automated player verification! ## ✨ Why Choose G1axWhitelist? ### 🚀 **Fully Automated** - Zero manual intervention required - Real-time tier verification during login - Seamless integration with existing server systems ### 🔄 **Dual Platform Support** - **Primary:** MCTiers API integration - **Fallback:** PVPTiers for comprehensive coverage - **Smart Logic:** Always uses the best tier available ### ⚡ **Performance Optimized** - Asynchronous processing prevents server lag - Built-in caching system (5-minute duration) - Non-blocking authentication process ### 🎨 **Rich User Experience** - Beautiful console ASCII art display - Colorful MiniMessage support - Customizable kick messages with Discord integration - Professional, clean logging ## 🏆 Perfect For - **PvP Servers** seeking skilled players - **Competitive Communities** with tier requirements - **Server Owners** wanting automated management - **Networks** needing consistent player quality ## 🛠️ Key Features ### 📊 **Intelligent Tier System** ``` HT1 (10) → LT1 (9) → HT2 (8) → LT2 (7) → HT3 (6) → LT3 (5) ### 💾 **Database Integration** - SQLite database for player tracking - Persistent tier information storage - Comprehensive player history ### 🎮 **Easy Management** - `/checktier <username>` - View player tiers from both platforms - Configurable minimum tier requirements - Bypass permissions for staff ### 🔧 **Highly Configurable** ```yaml minimum-tier-value: 5 # LT3 requirement kick-message: "Custom message with Discord invite" enable-pvptiers-fallback: true discord-invite: "https://discord.gg/yourserver" ``` ## 📋 Requirements - **Minecraft:** 1.20.4+ - **Server:** Paper/Spigot/Bukkit - **Java:** 17+ - **Dependencies:** None (all libraries included) ## 🚀 Quick Setup 1. **Download** and place in `/plugins` folder 2. **Start** server to generate config 3. **Edit** `config.yml` with your Discord invite 4. **Restart** and enjoy automated whitelisting! ## 🎯 How It Works When a player joins: 1. **Check MCTiers** for their ranking 2. **Fallback to PVPTiers** if needed 3. **Compare** against minimum requirement (LT3+) 4. **Auto-whitelist** qualified players 5. **Deny** with helpful message if insufficient ## 🌟 What Players See ### ✅ **Qualified Players (LT3+)** ``` You've been automatically whitelisted! (Tier: LT3) ``` ### ❌ **Unqualified Players** ``` You need to be LT3+ on MCTiers or PVPTiers to join this server! Create a ticket on our Discord: https://discord.gg/yourserver ``` ## 🤝 Open Source & Community Driven - **GitHub:** (https://github.com/AkaTriggered/G1axWhitelist) - **License:** MIT (Free to use and modify) - **Contributions:** Welcome and encouraged! ## 📊 Server Benefits - **Reduced Admin Workload** - No more manual whitelist management - **Higher Player Quality** - Only skilled players gain access - **Better Community** - Tier-based filtering creates competitive environment - **Professional Image** - Automated systems show server quality ## 🔮 Future Plans - Multi-platform tier support - Advanced analytics dashboard - Custom tier thresholds per game mode - Integration with more ranking systems **Transform your server today with intelligent, automated player management!** *Created by AkaTriggered with ❤️ for the Minecraft community*