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

Download and place in /plugins folder
Start server to generate config
Edit config.yml with your Discord invite
Restart and enjoy automated whitelisting!

🎯 How It Works

When a player joins:

Check MCTiers for their ranking
Fallback to PVPTiers if needed
Compare against minimum requirement (LT3+)
Auto-whitelist qualified players
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

G1axWhitelist