
Modrinth · Minecraft mod
Simple Whitelist
Nickname based whitelist fabric mod
Quick answer
Which Simple Whitelist release matches 1.19.2?
Simple Whitelist 1.2.0+plugin targets 1.18, 1.18.1, 1.18.2 with bukkit, folia, paper. Do not install it on the client. It must be installed on the dedicated server. No extra mods listed for this file.
Where it goes
Is Simple Whitelist required on the client, server, or both?
Do not install it on the client. It must be installed on the dedicated server.
This file is marked server-only.
What else does Simple Whitelist 1.2.0+plugin need?
1.2.0+plugin on 1.19.2. Every mod below is checked against that same setup.
This file does not list any required mods. Do not add a library just because a different file uses it.
This file does not list any required or optional mods.
Before you install it
Add Simple Whitelist without breaking your instance.
Built for Simple Whitelist 1.2.0+plugin on 1.19.2. Pick another file and the loader, install side or required mods may change.
- 01
Stick to this file
Use 1.2.0+plugin. It targets 1.18, 1.18.1, 1.18.2 with bukkit, folia, paper; another release may have different loader, side or dependency requirements.
- 02
Bring the mods it needs
This file does not list any required mods. Do not add a library just because a different file uses it.
- 03
Put it on the correct side
Do not install it on the client. It must be installed on the dedicated server.
- 04
Pick the file you checked
Use the “Get this file” button beside 1.2.0+plugin. It opens that exact file at the source.
About this project
What does Simple Whitelist add?
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.
Project description from Modrinth.
Pick your setup
Simple Whitelist by Minecraft version and loader
Choose the version and loader you play, then open the matching release.
26.1.2
2 loader builds26.1.1
2 loader builds26.1
2 loader builds1.21.11
2 loader builds1.21.10
2 loader builds1.21.9
2 loader builds1.21.8
2 loader builds1.21.7
2 loader builds1.21.6
2 loader builds1.21.5
2 loader builds1.21.4
2 loader buildsShowing the newest 12 of 31 game versions. Older files are in the list below.
Check the dependencies, then try the file in a copied instance before changing a world you care about.
Recent files
Simple Whitelist versions and loaders
1.2.0+plugin
simple-whitelist-plugin-1.2.0.jar
26 Jul 2026
1.2.0+mc1.19.4
simple-whitelist-1.2.0+mc1.19.4.jar
26 Jul 2026
1.1.0+mc1.19.4
simple-whitelist-1.1.0+mc1.19.4.jar
25 Jul 2026
Looking for an older file? The official Modrinth project page is in Resources.