SimpleWhitelist

Name: SimpleWhitelist
Author: an1by

With SimpleWhitelist, a server owner limits who can join by keeping a list of player nicknames, and the list is managed with the swl command.

FabricForgeNeoForgeQuiltMIT LicenseOpen source1.8.8 – 1.21.11

What it does

The mod gives a private server a simple whitelist system. Only nicknames stored in the list can connect, which removes the need to hand-edit the vanilla whitelist file. An admin turns the list on with the swl enable command, and the mod can switch off Minecraft's own whitelist server.properties setting (white-list=false) so the two do not conflict. Messages shown to rejected players can be customized.

The jar goes into the plugins folder on server platforms or the mods folder on mod loaders, then the server is started. Fabric API is required on Fabric. LuckPerms is an optional dependency. The mod is published for Fabric, Forge, NeoForge and Quilt, and for Paper, Spigot, Purpur, Folia, Velocity, BungeeCord and Waterfall, across 47 release versions, 1.8.8 – 1.21.11. Snapshot builds are published as well. The code is under the MIT License and is open source.

Key features

Nickname whitelist
Only players whose nicknames are stored in the list can join the private server.
Swl command control
Admins switch the whitelist on and manage it with the swl command in the server console.
Vanilla whitelist override
The mod can turn off Minecraft's built-in whitelist setting so only its own list decides who connects.
Custom messages
The text shown to players who are refused entry can be changed to suit the server.

Compatibility

Latest build for each game version and loader.

Version

1.21.x4 of 4 versions with builds

1.21.7fabric-2.0.0Not availableneoforge-2.0.0Not available

1.21.5fabric-2.0.0Not availableneoforge-2.0.0Not available

1.21.1fabric-1.21.1-1.0.0forge-1.21.1-1.0.0Not available0.5

1.21fabric-1.21.1-1.0.0forge-1.21.1-1.0.0Not available0.5

1.20.x6 of 6 versions with builds

1.20.6Not available0.4Not availableNot available

1.20.5Not available0.4Not availableNot available

1.20.4Not available0.4Not availableNot available

1.20.3Not available0.4Not availableNot available

1.20.20.10.4Not available0.1

1.20.10.40.4Not available0.4

ReleaseBetaAlphaNot available

This mod also publishes snapshot builds. Snapshots are not shown in the matrix.

Requirements

Dependencies declared by the latest file for each loader.

Optional 1

LuckPermsA permissions plugin/mod for Minecraft servers.

Optional

Use cases

Who it’s for: Server owners who want a simple, invite-only player list without editing the vanilla whitelist file by hand. Players only need to be on the list; they do not install the mod to join.

How it compares

Full comparison

LAN Whitelist is a Fabric mod for 1.20.2 – 1.21.10 that runs on client and server, so both sides need it, and it is open source under the MIT License. FerrumWhiteList is a server-side mod for Forge and NeoForge built for 1.20.1 – 1.21.1 under a custom license, and it is not open source. WhitelistGate is also server-side only, for Forge and NeoForge on 1.20.1 – 1.21.1, and is open source under the Apache License 2.0.

Mod	Loaders	Game versions	Environment	Updated
SimpleWhitelist	Fabric, Forge, NeoForge and Quilt	1.8.8 – 1.21.11	Not published	2025-07-04
LAN Whitelist	Fabric	1.20.2 – 1.21.10	Client and server	2025-10-18
FerrumWhiteList	Forge and NeoForge	1.20.1 – 1.21.1	Server required, client optional	2026-05-29
WhitelistGate	Forge and NeoForge	1.20.1 – 1.21.1	Server-side only	2026-07-26

Questions

Does SimpleWhitelist need Fabric API?

Yes. Fabric API is a required dependency on the Fabric loader, so it must be installed next to SimpleWhitelist.

Does a player need the mod to join a whitelisted server?

No. The whitelist runs on the server, so players join without installing anything.

Can SimpleWhitelist run alongside Minecraft's own whitelist?

It can. The mod can disable the white-list=false setting in server.properties, so only its nickname list controls access.

Which version range is supported?

Files cover 1.8.8 – 1.21.11 across the release versions, with the latest Fabric file built for 1.21.7.

In the catalog

SimpleWhitelist is one of 8,016 Management mods on ModsFinder, and one of 5,930 Management mods for Fabric. 19,862 mods support Minecraft 1.21.11.