🎮 BetterWhitelist

Finally, your players can invite friends themselves!

---

📖 The Problem

On most whitelisted servers, players always have to contact an admin when they want to invite a friend. That's annoying and time-consuming.

💡 The Solution

BetterWhitelist gives trusted players the ability to independently add friends to the whitelist – with a single command!

---

✨ Features

• 🎫 Simple Whitelist Management - /invite <player> is all you need
• 🚫 Auto-Kick on Removal - Players are kicked when uninvited
• 📊 Invite Tracking & Limits - Track who invited whom, configurable max invites (default: 5)
• 📋 Statistics & Management - View invites, remaining slots, admin tools
• 🔄 Hot Reload - Update config without restart
• 🔐 Permission System - Secure role-based access control
• 👥 LuckPerms Integration - Optional automatic group assignment
• 🌍 Multilingual - German and English support
• ⚡ High Performance - Async operations, persistent JSON storage

---

🚀 Quick Start

1. Download the plugin
2. Copy to plugins/ folder
3. Start server (config is created automatically)
4. Grant permissions: /lp group trusted permission set invite.use true
5. Done! Players can now use /invite <name>

---

📋 Commands

Command	Permission	Description
/invite <player>	invite.use	Invites a player to the whitelist
/uninvite <player>	invite.admin	Removes a player (kicks if online)
/invitelist [player]	invite.use	Shows your invites and remaining slots
/invitelist <player>	invite.admin	View another player's invites
/betterwhitelist reload	invite.admin	Reloads config and invite data

Aliases: /invitelist → /ilist, /invites • /betterwhitelist → /bwl, /bwhitelist

---

🔐 Permissions

Permission	Description	Default
invite.use	Invite and view own invites	OP
invite.admin	Unlimited invites, manage all players	OP

---

⚙️ Configuration

language: "en"         # "en" or "de"
max-invites: 5         # Max invites per player (admins unlimited)

luckperms:
  enabled: false
  default-group: "default"

---

📊 Invite System

Players can invite up to 5 friends (configurable). Use /invitelist to see your invites and remaining slots. When you uninvite someone, the slot becomes available again. All invites are tracked with timestamps in invites.json.

Admin Features: View any player's invites, unlimited invites, see top inviters from console.

---

💬 Support & Links

• 🐛 Issues: GitHub Issues
• 📖 Source Code: GitHub Repository
• 📄 License: MIT License - Free to use and modify

---

🔧 Requirements

• Minecraft: 1.21.x
• Server: Paper, Purpur, or Paper fork
• Java: 21+
• Optional: LuckPerms for group management

---

Made with ❤️ for the Minecraft Community