Better Whitelist
by JFronny
Better Whitelist replaces hand-edited whitelist files with a configurable system on Fabric servers, where the rules are written in a script.
What it does
Better Whitelist provides a basic whitelist for a server, and its rules are written in the Script language rather than kept in a plain list. Server owners can adapt the checks to their own use case, for example allowing users temporarily or keeping a blacklist of names. A config file is created on the first start of a server running the mod, and its default settings can be edited to add exceptions.
The mod is built around a script standard library with date and time helpers, so a rule can depend on when a player connects. Scripts can read the id and name of a player attempting to join before deciding on access, and can kick a player with an optional message. A closure can be sent to the client or executed on the server, and closures may take other closures as arguments.
Better Whitelist runs on client and server, and both sides need it for connecting players to be checked. It requires Fabric API and LibJF, and is published for Fabric across 25 release versions, 1.19.4 – 26.3. The code is open source under the MIT License.
Key features
Script-based whitelist rules
Whitelist decisions are written as scripts, so the logic can go beyond a fixed list of names.
Temporary access and blacklists
Scripts can grant access for a limited time or refuse specific users, covering cases a plain list does not.
Login information
A script receives the id and name of a player attempting to join before deciding whether to admit them.
Resource pack and mod listing
Helper functions list loaded mods and client resource packs, with name, description and version fields, to help debugging.
Compatibility
Latest build for each game version and loader.
26.x5 of 5 versions with builds
1.21.x12 of 12 versions with builds
1.20.x7 of 7 versions with builds
1.19.x1 of 1 version with builds
Only full game releases are shown. This mod publishes no snapshot builds.
Requirements
Dependencies declared by the latest file for each loader.
Required 2
Use cases
Who it’s for: Server owners who want to write custom whitelist logic, and script authors who extend it for their own servers.
How it compares
Simple Whitelist is server-side only, open source under the MIT License and published for 1.18 – 26.2, so it covers older versions than Better Whitelist. Custom Whitelist Text is also server-side only and MIT licensed, but it is published for 1.21.1 – 1.21.11 and is not open source. Better Whitelist differs in being configured with scripts and in requiring a client install alongside the server.
| Mod | Loaders | Game versions | Environment | Updated |
|---|---|---|---|---|
| Better Whitelist | Fabric | 1.19.4 – 26.3 | Client and server | 2026-09-15 |
| 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 |
Questions
Does Better Whitelist need Fabric API?
Does every player need the mod?
Which versions are supported?
Where are the rules stored?
In the catalog
Better Whitelist is one of 8,016 Management mods on ModsFinder, and one of 5,930 Management mods for Fabric. 8,071 mods support Minecraft 26.3.
More from JFronny
Similar mods
What the author says
Better-Whitelist provides a basic whitelist system for your server that you can adapt to your use case. The mod is required both on the server and any clients connecting to the server.
Official listing
- Modrinth page
- modrinth.com/mod/better-whitelist
- Owner
- JFronny
- Published
- 2023-03-12
- Updated on Modrinth
- 2026-09-15
- Facts verified
- 2026-10-15