BetterWhitelist
PluginMIT

BetterWhitelist

A 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.

57
Downloads
3
Followers
5 months ago
Updated
📦
3
Versions

📖About BetterWhitelist

🎮 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


🔧 Requirements

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

Made with ❤️ for the Minecraft Community