Simple Whitelist
A simple, username-based whitelist for Minecraft servers — available both as a Fabric mod and as a server plugin.
Features
- Whitelist based on usernames: The whitelist is keyed on usernames, not UUIDs. Names are case-sensitive —
Steveandsteveare treated as different players. - Database storage: Store the whitelist data in a JSON file or a MySQL database.
- ModMenu screen (Fabric client, 1.21+): With ModMenu installed, a minimal config screen lets you toggle the whitelist — handy when you open a singleplayer world to LAN.
Fabric mod
Dependencies
Required:
Optional:
- A fabric-permissions-api provider (e.g. LuckPerms) for permission-based command access. Without it, commands fall back to vanilla operator level 4.
Installation
- Download the latest release for your Minecraft version from Modrinth.
- Place the
.jarfile in yourmodsfolder.
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 client mod.
- Config:
plugins/SimpleWhitelist/config.json— same schema as the mod (see below). - Permission:
simplewhitelist.command(default: op) — grant it via any permissions plugin, e.g. LuckPerms.
Installation
- Download the latest plugin release from Modrinth.
- Place the
.jarfile in yourpluginsfolder.
Client-only features (the ModMenu config screen) are mod-only and have no plugin equivalent.
Configuration
The default configuration file is config/SimpleWhitelist/config.json (mod) or plugins/SimpleWhitelist/config.json (plugin):
{
"whitelist": true,
"databaseType": "json",
"mysqlUrl": "jdbc:mysql://<username>:<password>@<host>:<port>/<database>",
"jsonFileName": "whitelist.json"
}
Configuration options:
whitelist: Enable or disable the whitelist.databaseType: The type of database to use. Can be eitherjsonormysql.mysqlUrl: The connection string for the MySQL database.jsonFileName: The name of the JSON file to store the whitelist data.
Commands
simplewhitelist list: List all players on the whitelist.simplewhitelist add <player>: Add a player to the whitelist.simplewhitelist remove <player>: Remove a player from the whitelist.simplewhitelist on: Enable the whitelist.simplewhitelist off: Disable the whitelist.
simplewhitelist aliases: swl, swh, swhitelist
Permissions
simplewhitelist.command: Allows players to use the whitelist commands.
No gallery available for this project.
| Version | Minecraft | Loader | Download |
|---|---|---|---|
|
Simple Whitelist (plugin) 1.2.0 1.2.0+plugin |
1.18, 1.18.1, 1.18.2, 1.19, 1.19.1, 1.19.2, 1.19.3, 1.19.4, 1.20, 1.20.1, 1.20.2, 1.20.3, 1.20.4, 1.20.5, 1.20.6, 1.21, 1.21.1, 1.21.2, 1.21.3, 1.21.4, 1.21.5, 1.21.6, 1.21.7, 1.21.8, 1.21.9, 1.21.10, 1.21.11, 26.1, 26.1.1, 26.1.2, 26.2
|
bukkit, folia, paper, purpur, spigot
|
Download |
|
1.21.10 1.2.0+mc1.21.10 1.2.0+mc1.21.10 |
1.21, 1.21.1, 1.21.2, 1.21.3, 1.21.4, 1.21.5, 1.21.6, 1.21.7, 1.21.8, 1.21.9, 1.21.10, 1.21.11
|
fabric
|
Download |
|
1.20.1 1.2.0+mc1.20.1 1.2.0+mc1.20.1 |
1.20, 1.20.1, 1.20.2, 1.20.3, 1.20.4
|
fabric
|
Download |
|
1.19.4 1.2.0+mc1.19.4 1.2.0+mc1.19.4 |
1.19, 1.19.1, 1.19.2, 1.19.3, 1.19.4
|
fabric
|
Download |
|
1.18.2 1.2.0+mc1.18.2 1.2.0+mc1.18.2 |
1.18, 1.18.1, 1.18.2
|
fabric
|
Download |
|
1.20.6 1.2.0+mc1.20.6 1.2.0+mc1.20.6 |
1.20.5, 1.20.6
|
fabric
|
Download |
|
26.2 1.1.0+mc26.2 1.1.0+mc26.2 |
26.2
|
fabric
|
Download |
|
26.1.2 1.1.0+mc26.1.2 1.1.0+mc26.1.2 |
26.1, 26.1.1, 26.1.2
|
fabric
|
Download |
|
1.21.10 1.1.0+mc1.21.10 1.1.0+mc1.21.10 |
1.21, 1.21.1, 1.21.2, 1.21.3, 1.21.4, 1.21.5, 1.21.6, 1.21.7, 1.21.8, 1.21.9, 1.21.10, 1.21.11
|
fabric
|
Download |
|
1.19.4 1.1.0+mc1.19.4 1.1.0+mc1.19.4 |
1.19, 1.19.1, 1.19.2, 1.19.3, 1.19.4
|
fabric
|
Download |
|
1.20.1 1.1.0+mc1.20.1 1.1.0+mc1.20.1 |
1.20, 1.20.1, 1.20.2, 1.20.3, 1.20.4
|
fabric
|
Download |
|
1.20.6 1.1.0+mc1.20.6 1.1.0+mc1.20.6 |
1.20.5, 1.20.6
|
fabric
|
Download |
|
1.18.2 1.1.0+mc1.18.2 1.1.0+mc1.18.2 |
1.18, 1.18.1, 1.18.2
|
fabric
|
Download |
|
Simple Whitelist 1.0.3 1.0.3 |
1.21, 1.21.1, 1.21.2, 1.21.3, 1.21.4
|
fabric
|
Download |
|
Simple Whitelist 1.0.2 1.0.2 |
1.21
|
fabric
|
Download |
|
Simple Whitelist 1.0.1 1.0.1 |
1.21
|
fabric
|
Download |
|
Simple Whitelist 1.0.0 1.0.0 |
1.21
|
fabric
|
Download |