SimpleWhitelist
Simple whitelist system for your private server
FabricNeoForgeForgeQuilt
- Loaders
- FabricNeoForgeForgeQuilt
- Downloads on Modrinth
- 26.2K
- Followers on Modrinth
- 55
- versions
- 37
- Updated
- November 14, 2026Nov 14
- Published
- in 2023
At a glance
Runs on Fabric, NeoForge, Forge and Quilt
For Minecraft 1.8.8, 1.12–26.3
Server only — players don't need to install it
Latest version — velocity-2.1.0 from November 14, 2026
License MIT — free
Where it's neededGame versions1.8.8, 1.12–26.3
In gamenot neededOn serverrequired
Install on the server only; players don't need it
SimpleWhitelist
SimpleWhitelist is a lightweight, universal nickname-based whitelist plugin & mod for private Minecraft servers (1.12 – 26.x).
Why SimpleWhitelist?
- Nickname-based (
whitelist.txt) — works seamlessly on online-mode, offline-mode, proxy, and Geyser / Floodgate Bedrock servers (supports.,*,+,-prefixes and spaces); - Universal 12-platform support (
1.12 – 26.x) — proxies, Bukkit forks, Sponge, and mod loaders; - Fully customizable Adventure MiniMessage messages in
config.yml; - Blocked-join logging & actions — optional console notifications (
logBlockedJoins) and custom console commands (onBlockedJoinCommands); - Granular permissions — per-subcommand permissions with LuckPerms / native PermissionAPI & Brigadier tab-completion.
Quick Start
- Disable vanilla whitelist in
server.properties(white-list=false); - Put the JAR into
plugins/(Bukkit/Sponge/Proxies) ormods/(Fabric/Quilt/Forge/NeoForge); - Start your server;
- Add players via `/swl add
and toggle via/swl enable//swl disable`.
Commands & Permissions
Aliases: /simplewhitelist, /swl, /simplewl
| Command | Permission | Description |
|---|---|---|
| `/swl add ` | simplewhitelist.command.add | Add a player to the whitelist |
| `/swl remove ` | simplewhitelist.command.remove | Remove a player from the whitelist |
/swl list | simplewhitelist.command.list | Show whitelisted players |
/swl enable | simplewhitelist.command.enable | Enable the whitelist |
/swl disable | simplewhitelist.command.disable | Disable the whitelist |
/swl reload | simplewhitelist.command.reload | Reload config.yml and whitelist.txt |
/swl help | Any simplewhitelist.command.* | Show command help |
Wildcard / base permissions: simplewhitelist.command.* or simplewhitelist.command.
Configuration (config.yml)
enabled: true— enable/disable whitelist check;caseSensitive: false— case-sensitive nickname matching;enforceWhitelist: true— kick online non-whitelisted players onenable/remove/reload;logBlockedJoins: true— log blocked join attempts with username in console;onBlockedJoinCommands: []— console commands executed when a non-whitelisted player tries to join (`` placeholder).
FAQ
How to install SimpleWhitelist?
Install Fabric for your Minecraft version, download SimpleWhitelist for the same version and loader, put the file into the mods folder and launch the game with the loader profile.
Which Minecraft versions does SimpleWhitelist support?
SimpleWhitelist has builds for Minecraft 1.8.8, 1.12–26.3.
Is SimpleWhitelist needed on the server?
Server only — players don't need to install it
License and source
MIT Licensefree to use and share with credit to the author
