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+)

[G1ax] 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: 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