Overview
A powerful and flexible whitelist plugin for Paper servers. mWL gives you full control over who can join your server with support for temporary whitelist entries, permission-based bypass, MongoDB or JSON storage, and compatibility from 1.18.x all the way to Paper 26.2.
Perfect for private servers, whitelisted communities, or any server that needs more control than vanilla's built-in whitelist.
Features
| Feature | Description |
|---|---|
| Temporary Whitelist | Add players for a limited time — auto-removed on expiry |
| Bypass Permission | Let staff or VIPs join regardless of whitelist status |
| Dual Database Support | Store players in JSON (no setup) or MongoDB |
| Expiry Notifications | Warn players when their whitelist time is about to run out |
| Auto-kick on Remove | Optionally kick online players when removed from the whitelist |
| Reload Support | Reload config and language files without restarting |
| Permission System | Fine-grained access control for every command |
| Privacy-Focused | Optional bStats metrics (can be disabled in config) |
Why Choose mWL?
- Modern & maintained — compatible with the latest Paper versions including 26.2
- Lightweight with minimal performance impact
- Async database operations — no server freezes on lookup
- Highly configurable — online/offline UUID mode, time formats, bypass settings and more
- LuckPerms compatible — bypass permission works seamlessly with permission plugins
Configuration
mWL offers extensive configuration options:
- Whitelist on/off toggle with command or config
- Online / Offline UUID mode for cracked server support
- Temporary whitelist with flexible time syntax (e.g.
1d12h30m) - Permission bypass — assignable via any permission plugin
- Periodic player check with configurable interval
- Expiry notify threshold
- MongoDB connection settings
- bStats metrics toggle (
enableMetrics: true/false)
Commands & Permissions
Commands
| Command | Description |
|---|---|
/mwl add <player> |
Add a player to the whitelist |
/mwl remove <player> |
Remove a player from the whitelist |
/mwl addtemp <player> <time> |
Add a player temporarily |
/mwl settemp <player> <time> |
Set expiry time for an existing player |
/mwl extendtemp <player> <time> |
Extend a player's remaining time |
/mwl check <player> |
Check if a player is whitelisted |
/mwl list |
List all whitelisted players |
/mwl toggle [enable|disable] |
Toggle or set whitelist status |
/mwl info |
Show plugin information |
/mwl reload |
Reload config and language files |
/mwl help |
Show help overview |
Permissions
mwl.command.add— Add playersmwl.command.remove— Remove playersmwl.command.addtemp— Add temporary playersmwl.command.settemp— Set expiry timemwl.command.extendtemp— Extend expiry timemwl.command.check— Check whitelist statusmwl.command.list— List whitelisted playersmwl.command.toggle— Toggle whitelistmwl.command.info— View plugin infomwl.command.reload— Reload configmwl.command.help— View helpmwl.whitelist.bypass— Bypass whitelist check entirely
Database Support
mWL supports two storage backends:
- JSON (default) — zero setup, stores data locally in
whitelist.json - MongoDB — for larger servers or shared data setups; configure the connection URL in
config.yml
Switch between backends at any time by changing database.type in the config and restarting.
Credits
Original Plugin: mWL by TRUEC0DER
This is an updated fork, coordinated with and known to the original author, as the original plugin is now EOL (end of life) and no longer maintained. This fork adds bug fixes, broader version compatibility (1.18.x – 26.2), and additional features for modern Paper servers.
Take control of your whitelist — simple, powerful, and always up to date.
Made with ❤️ for the Minecraft community
