![mWL Updated by Knabbiii](https://cdn.modrinth.com/data/cached_images/60783b8de3b0977ef263fd9a43bdb1ff93057374.png) [![Downloads](https://img.shields.io/modrinth/dt/mwl-updated?style=for-the-badge&logo=modrinth&color=71ab68)](https://modrinth.com/plugin/mwl-updated) [![Minecraft](https://img.shields.io/badge/Minecraft-1.18.x%20%2F%2026.2-green?style=for-the-badge&logo=minecraft)](https://www.minecraft.net/) [![Server](https://img.shields.io/badge/Server-Paper-blue?style=for-the-badge)](https://papermc.io/)

![Divider](https://cdn.modrinth.com/data/cached_images/b9a20dd8fac1ec8b2ea1f4645f43314723aaa556.png) ## 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.** ![Divider](https://cdn.modrinth.com/data/cached_images/b9a20dd8fac1ec8b2ea1f4645f43314723aaa556.png) ## 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 ![Divider](https://cdn.modrinth.com/data/cached_images/b9a20dd8fac1ec8b2ea1f4645f43314723aaa556.png) ## 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`) ![Divider](https://cdn.modrinth.com/data/cached_images/b9a20dd8fac1ec8b2ea1f4645f43314723aaa556.png) ## Commands & Permissions ### Commands | Command | Description | |---------|-------------| | `/mwl add ` | Add a player to the whitelist | | `/mwl remove ` | Remove a player from the whitelist | | `/mwl addtemp ` | Add a player temporarily | | `/mwl settemp ` | Set expiry time for an existing player | | `/mwl extendtemp ` | Extend a player's remaining time | | `/mwl check ` | 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 ![Divider](https://cdn.modrinth.com/data/cached_images/b9a20dd8fac1ec8b2ea1f4645f43314723aaa556.png) ## 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. ![Divider](https://cdn.modrinth.com/data/cached_images/b9a20dd8fac1ec8b2ea1f4645f43314723aaa556.png) ## Credits **Original Plugin:** [mWL](https://modrinth.com/plugin/mwl) by [TRUEC0DER](https://modrinth.com/user/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. ![Divider](https://cdn.modrinth.com/data/cached_images/b9a20dd8fac1ec8b2ea1f4645f43314723aaa556.png)

**Take control of your whitelist — simple, powerful, and always up to date.** *Made with ❤️ for the Minecraft community*

mwl-updated

2.3.0