ModsFinder

Simple Whitelist

by iSlavok

Simple Whitelist is a Fabric server mod that restricts who can join a server, keyed to usernames rather than player UUIDs.

FabricServer-side onlyMIT LicenseOpen source1.18 – 26.2

What it does

Simple Whitelist keeps an allow list of player names. Entries are matched by username, and the matching is case-sensitive, so Steve and steve count as separate accounts. Whitelist data is kept in a JSON file by default, or in a MySQL database for servers that prefer shared storage.

The same whitelist is also offered as a server plugin, in a single jar that runs on Spigot, Paper, Purpur, Folia and other Bukkit-based servers, so the rules stay identical across both setups. Those plugin builds need nothing on the player's side, while the Fabric build is server-side only and requires Fabric API and Fabric Language Kotlin. Files are published for Fabric 1.18 – 26.2, across 31 release versions, under the MIT License, and the project is open source.

Key features

  1. Username-based whitelist

    Entries are stored by player name, not by UUID, which keeps the list readable and editable by hand.

  2. Case-sensitive matching

    Names are compared with their exact letter case, so two accounts that differ only in capitalization are separate entries.

  3. Commands with permission fallback

    Management commands can be gated by a permissions provider such as LuckPerms; without one, vanilla operator level 4 applies.

  4. ModMenu configuration screen

    When ModMenu is installed on a Fabric client, a minimal config screen lets the owner toggle the whitelist from singleplayer or LAN worlds.

  5. Command aliases

    The command can be invoked as simplewhitelist, swl, swh or swhitelist.

Compatibility

Latest build for each game version and loader.

26.x4 of 4 versions with builds
26.21.1.0+mc26.2
26.1.21.1.0+mc26.1.2
26.1.11.1.0+mc26.1.2
26.11.1.0+mc26.1.2
1.21.x12 of 12 versions with builds
1.21.111.2.0+mc1.21.10
1.21.101.2.0+mc1.21.10
1.21.91.2.0+mc1.21.10
1.21.81.2.0+mc1.21.10
1.21.71.2.0+mc1.21.10
1.21.61.2.0+mc1.21.10
1.21.51.2.0+mc1.21.10
1.21.41.2.0+mc1.21.10
1.21.31.2.0+mc1.21.10
1.21.21.2.0+mc1.21.10
1.21.11.2.0+mc1.21.10
1.211.2.0+mc1.21.10
1.20.x7 of 7 versions with builds
1.19.x5 of 5 versions with builds
1.18.x3 of 3 versions with builds
ReleaseBetaAlphaNot available

Only full game releases are shown. This mod publishes no snapshot builds.

Requirements

Dependencies declared by the latest file for each loader.

Required 2

Fabric Language KotlinThis is a mod that enables usage of the Kotlin programming language for Fabric mods.
Required
Fabric APILightweight and modular API providing common hooks and intercompatibility measures utilized by mods using the Fabric toolchain.
Required

Optional 1

Mod MenuAdds a mod menu to view the list of mods you have installed.
Optional

Use cases

Who it’s for: Server owners who manage access by player name and want the same rules on Fabric and Bukkit-based servers. Players need nothing installed, since the mod is server-side only.

How it compares

Full comparison

AutoWhitelist is server-side only, licensed under the GNU Lesser General Public License v3.0 only and open source, with Fabric files for 1.18 – 26.2. LANLock needs both client and server, is under the MIT License and is published for Fabric and Quilt across 1.19.2 – 26.3. Whitelist Sync 2 is open source under the GNU General Public License v3.0 only and covers Fabric, Forge and NeoForge across 1.12.2 – 26.2.

ModLoadersGame versionsEnvironmentUpdated
Simple WhitelistFabric1.18 – 26.2Server-side only2026-07-26
AutoWhitelistFabric1.18 – 26.2Server-side only2026-09-12
LANLockFabric and Quilt1.19.2 – 26.3Client and server2026-09-15
Whitelist Sync 2Fabric, Forge and NeoForge1.12.2 – 26.2Server-side only2026-07-07

Questions

Does Simple Whitelist need Fabric API?

Yes. Fabric API and Fabric Language Kotlin are required dependencies, and both must be installed on the server.

Do players need to install anything?

No. Server owners install it, and players connect with no copy of their own. Only a client that uses ModMenu can open the optional config screen.

Can the whitelist be stored in a database?

Yes. Data can be kept in a flat file or a shared database server, which suits servers that run several instances against one list.

In the catalog

Simple Whitelist is one of 8,016 Management mods on ModsFinder, and one of 5,930 Management mods for Fabric. 13,894 mods support Minecraft 26.2.

Management mods8,016Fabric modsMods for 26.213,894

More from iSlavok

All projects
Simple Player Heads1.18 – 26.2Friendly Phantoms1.13 – 26.2Simple Frames1.18 – 26.2

Similar mods

Cherished Worlds1.12.2 – 26.3Default Options1.18 – 26.3Axiom1.20 – 26.3Resourcify1.8.9 – 26.3Rebind Narrator1.16.1 – 26.1.2Paxi1.19.2 – 26.1.2

What the author says

A simple, username-based whitelist for Minecraft servers — available both as a Fabric mod and as a server plugin. The same whitelist is available as a server plugin — one jar for Spigot, Paper, Purpur and Folia. It reuses the mod's JSON/MySQL storage and the same case-sensitive, username-based rules, and needs no…
iSlavok, on the Modrinth page

Official listing

Owner
iSlavok
Published
2024-07-14
Updated on Modrinth
2026-07-26
Facts verified
2026-10-15

Tags

ManagementUtility
Open on ModrinthCompare