BetterWhitelist
1.1.0A configurable whitelist plugin that allows trusted players or VIPs to invite friends to your server without admin intervention. Supports multiple languages and optional LuckPerms integration.
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
Similar projects
Config →VeinMiner
Mine the whole vein on mining a single ore/block. Make the tedious mining experience to something satisfying and fun! FTB Ultimine alternative
99.3MSueta
Simple Voice Chat
A working voice chat in Minecraft!
76.8MSueta
Let Me Despawn
Improves performance by tweaking mob despawn rules. Say bye to pesky unintentional persistent mobs.
25MSueta
Chunky
Pre-generates chunks, quickly and efficiently
18.4MSueta
VeinMiner Enchantment
Veinminer Addon - Adds vineminer enchantment to enchanting tables. Only tools with the enchantment can veinmine
18MSueta
JourneyMap
Real-time map used for mapping in-game or your browser as you explore.
14.7MSueta