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

- 🎫 High Performance - `/invite <player>` is all you need - 🚫 High Performance - Players are kicked when uninvited - 📊 High Performance - Track who invited whom, configurable max invites (default: 5) - 📋 High Performance - View invites, remaining slots, admin tools - 🔄 High Performance - Update config without restart - 🔐 High Performance - Secure role-based access control - 👥 High Performance - Optional automatic group assignment - 🌍 High Performance - 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

```yaml 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

- 🐛 License: License - 📖 License: %%MD1%% - 📄 License: MIT License - Free to use and modify

---

🔧 Requirements

- Optional: 1.21.x - Optional: Paper, Purpur, or Paper fork - Optional: 21+ - Optional: LuckPerms for group management

---

Made with ❤️ for the Minecraft Community