Whitelistd
by ruattd
Whitelistd is a Fabric server mod for managing the player whitelist through MySQL, MongoDB or an HTTP API instead of the plain whitelist file.
What it does
The mod injects into the Minecraft dedicated server to provide advanced whitelist management. Storage can be chosen to suit the server: MySQL and MongoDB are implemented, an HTTP API is available, and the author notes that more implementations may follow in later versions. Whitelistd needs Architectury API installed alongside it.
A player can be added by name alone through a record command, and the UUID is then filled in automatically when that player first joins. The UUID does not have to be known in advance, which covers servers that authenticate through a third-party service such as LittleSkin. Server owners can edit the configuration file to set how the mod behaves, and the wiki page explains the setup.
Whitelistd runs on the server only, so players join without installing anything. Files are published for Fabric 1.20.1, with version 1.0.1 as the latest build from 2024-01-12. The source code, issue tracker and wiki are public, and the project is open source under the GNU General Public License v3.0 or later. The author notes that the Forge version is kept as a GitHub release and is not published on Modrinth.
Key features
Multiple storage backends
Whitelist entries can be kept in MySQL, MongoDB or through an HTTP API, so the storage matches the server's setup.
Add by name
A record command adds a player to the whitelist using only the player's name, without needing the UUID first.
Automatic UUID capture
When a listed player first joins, the mod records the UUID, which fits servers that use third-party authentication.
Configurable behavior
A configuration file lets the server owner adjust how the whitelist is handled.
Gallery
Compatibility
Latest build for each game version and loader.
Only full game releases are shown. This mod publishes no snapshot builds.
Requirements
Dependencies declared by the latest file for each loader.
Required 1
Use cases
Who it’s for: Server maintainers who manage a whitelist for a Fabric 1.20.1 server and want database or API-backed storage. The mod is not intended for client installation.
How it compares
Simple Whitelist is also server-side only and open source, under the MIT License, for Fabric across 1.18 – 26.2. Custom Whitelist Text is server-side only for Fabric across 1.21.1 – 1.21.11, but it is not open source and is released under the MIT License. Zero Whitelist is server-side only for NeoForge 1.21.1 and is not open source. Whitelistd is limited to Fabric 1.20.1, so for other versions one of these may fit better.
| Mod | Loaders | Game versions | Environment | Updated |
|---|---|---|---|---|
| Whitelistd | Fabric | 1.20.1 | Server-side only | 2024-01-12 |
| Simple Whitelist | Fabric | 1.18 – 26.2 | Server-side only | 2026-07-26 |
| Custom Whitelist Text | Fabric | 1.21.1 – 1.21.11 | Server-side only | 2026-08-04 |
| Zero Whitelist | NeoForge | 1.21.1 | Server-side only | 2025-07-05 |
Questions
Does Whitelistd need Architectury API?
Does Whitelistd have to be installed on the client?
Does Whitelistd work on Forge or Quilt?
In the catalog
Whitelistd is one of 8,016 Management mods on ModsFinder, and one of 5,930 Management mods for Fabric. 34,764 mods support Minecraft 1.20.1.
Similar mods
What the author says
Whitelistd provides advanced whitelist management through an injection to Minecraft dedicated server. Whitelistd has some storage implementations, you can choose storage mode according to your needs.
Official listing
- Modrinth page
- modrinth.com/mod/whitelistd
- Owner
- ruattd
- Published
- 2024-01-12
- Updated on Modrinth
- 2024-01-12
- Facts verified
- 2026-10-15