
Simple Whitelist
Nickname based whitelist fabric mod
About this Mod
Simple Whitelist
This is a Fabric mod for Minecraft 1.21 that provides a simple whitelist system based on usernames.
Features
- Whitelist based on usernames: The whitelist system is based on usernames, not UUIDs.
- Database storage: You can choose between storing the whitelist data in a JSON file or a MySQL database.
Dependencies
This mod requires the following dependencies:
Configuration
The default configuration file is config\SimpleWhitelist\config.json:
{
"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.
simplewhitelistaliases: swl, swh, swhitelist
Permissions
simplewhitelist.command: Allows players to use the whitelist commands.
Installation
- Download the latest release of Simple Whitelist from here.
- Place the
.jarfile in yourmodsfolder.
Available Versions
How to Install Simple Whitelist on Your Server
Order Server
Order a Minecraft Java server with at least 3 GB RAM (4 GB recommended).
Set fabric Loader
In the panel under "Egg", select the fabric loader and matching Minecraft version (1.21.4).
Install Mod
Open the mod browser in the dashboard and search for "Simple Whitelist". Click "Install" – done! Alternatively, upload the .jar via SFTP to the /mods folder.
Compatibility
Mod Loaders
Minecraft Versions
1.21.4, 1.21.3, 1.21.2 (+2 more)
Server-side
✓ RequiredRecommended RAM
4 GB(min. 3 GB)Frequently Asked Questions
Simple Whitelist server crashes on startup – what to do?
Most common cause: wrong fabric version or insufficient RAM. Check the server log (latest.log) for "OutOfMemoryError" or "Mixin" errors. With Mado Hosting: ensure at least 3 GB RAM is allocated and the loader matches the mod version (1.21.4). You can switch loaders with one click in the panel.
Is Simple Whitelist compatible with fabric?
Simple Whitelist officially supports fabric for Minecraft 1.21.4, 1.21.3, 1.21.2. The Mado dashboard automatically detects incompatible loader combinations.
Server lagging with Simple Whitelist – how to optimize performance?
Recommended RAM: 4 GB (per 8 players). Use /spark profiler to check if Simple Whitelist consumes the most tick time. Common fixes: reduce server view-distance to 8-10, install "performant" or "starlight" as supplementary mods on Forge. With Mado Hosting, your server runs on NVMe SSDs with dedicated CPU cores for minimal latency.
Similar Mods
Rent Modded Server
Install Simple Whitelist with just one click on your server.