mWL Updated

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 players
• mwl.command.remove — Remove players
• mwl.command.addtemp — Add temporary players
• mwl.command.settemp — Set expiry time
• mwl.command.extendtemp — Extend expiry time
• mwl.command.check — Check whitelist status
• mwl.command.list — List whitelisted players
• mwl.command.toggle — Toggle whitelist
• mwl.command.info — View plugin info
• mwl.command.reload — Reload config
• mwl.command.help — View help
• mwl.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.