🎮 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
- Download the plugin
- Copy to
plugins/folder - Start server (config is created automatically)
- Grant permissions:
/lp group trusted permission set invite.use true - 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
