Simple Whitelist

Simple Whitelist

Nickname based whitelist fabric mod

by
942 Downloads
fabricmanagementutility
Rent Server with this 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 either json or mysql.
  • 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

  1. Download the latest release of Simple Whitelist from here.
  2. Place the .jar file in your mods folder.

Available Versions

Simple Whitelist 1.0.3release
MC 1.21, 1.21.1, 1.21.2, 1.21.3, 1.21.4fabric
December 8, 2024
Simple Whitelist 1.0.2release
MC 1.21fabric
July 21, 2024
Simple Whitelist 1.0.1release
MC 1.21fabric
July 20, 2024
Simple Whitelist 1.0.0release
MC 1.21fabric
July 15, 2024

How to Install Simple Whitelist on Your Server

1

Order Server

Order a Minecraft Java server with at least 3 GB RAM (4 GB recommended).

2

Set fabric Loader

In the panel under "Egg", select the fabric loader and matching Minecraft version (1.21.4).

3

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

fabric

Minecraft Versions

1.21.4, 1.21.3, 1.21.2 (+2 more)

Server-side

Required

Recommended 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.

Rent Modded Server

Install Simple Whitelist with just one click on your server.

Recommended RAM
4 GBab €8/mo
Min. 3 GB | +1 GB pro 8 Spieler
Create Server Now
1-Click Mod Install
NVMe SSD Storage
DDoS Protection included

Details

License
MIT License
Server-side
Required

Supported Versions

1.21.41.21.31.21.21.21.11.21