modpacks.ch by CreeperHost No ads. Just mods.
Back to mods
SimpleWhitelist project artwork

Modrinth · Minecraft mod

SimpleWhitelist

Simple whitelist system for your private server

Choose a version Pick your version below, then grab the matching file.

Quick answer

Which SimpleWhitelist release matches 26.3 sponge?

Updated today
Best match for your filters sponge-2.1.0
Game version 1.16.5, 1.17, 1.17.1
Loader sponge

SimpleWhitelist sponge-2.1.0 targets 1.16.5, 1.17, 1.17.1 with sponge. 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 SimpleWhitelist required on the client, server, or both?

Do not install it on the client. It must be installed on the dedicated server.

Client Not supported
Dedicated server Required
Loader for this release sponge
Required install it here Optional supported, not mandatory Not supported do not install here Source doesn’t say do not assume

This file is marked server-only.

Understand client and server requirements Read the Minecraft installation guide

What else does SimpleWhitelist sponge-2.1.0 need?

sponge-2.1.0 on 26.3 sponge. Every mod below is checked against that same setup.

No extra mods listed for this file

This file does not list any required mods. Do not add a library just because a different file uses it.

LuckPerms Optional for SimpleWhitelist sponge-2.1.0
optional
No matching file

We only count dependency files that match this setup. A file for another loader does not fill the gap.

Before you install it

Add SimpleWhitelist without breaking your instance.

Built for SimpleWhitelist sponge-2.1.0 on 26.3 sponge. Pick another file and the loader, install side or required mods may change.

  1. 01

    Stick to this file

    Use sponge-2.1.0. It targets 1.16.5, 1.17, 1.17.1 with sponge; another release may have different loader, side or dependency requirements.

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

  3. 03

    Put it on the correct side

    Do not install it on the client. It must be installed on the dedicated server.

  4. 04

    Pick the file you checked

    Use the “Get this file” button beside sponge-2.1.0. It opens that exact file at the source.

About this project

What does SimpleWhitelist add?

SimpleWhitelist

SimpleWhitelist is a lightweight, universal nickname-based whitelist plugin & mod for private Minecraft servers (1.12 – 26.x).

Why SimpleWhitelist?

  • Nickname-based (whitelist.txt) — works seamlessly on online-mode, offline-mode, proxy, and Geyser / Floodgate Bedrock servers (supports ., *, +, - prefixes and spaces);
  • Universal 12-platform support (1.12 – 26.x) — proxies, Bukkit forks, Sponge, and mod loaders;
  • Fully customizable Adventure MiniMessage messages in config.yml;
  • Blocked-join logging & actions — optional console notifications (logBlockedJoins) and custom console commands (onBlockedJoinCommands);
  • Granular permissions — per-subcommand permissions with LuckPerms / native PermissionAPI & Brigadier tab-completion.

Quick Start

  1. Disable vanilla whitelist in server.properties (white-list=false);
  2. Put the JAR into plugins/ (Bukkit/Sponge/Proxies) or mods/ (Fabric/Quilt/Forge/NeoForge);
  3. Start your server;
  4. Add players via /swl add <name> and toggle via /swl enable / /swl disable.

Commands & Permissions

Aliases: /simplewhitelist, /swl, /simplewl

Command Permission Description
/swl add <name> simplewhitelist.command.add Add a player to the whitelist
/swl remove <name> simplewhitelist.command.remove Remove a player from the whitelist
/swl list simplewhitelist.command.list Show whitelisted players
/swl enable simplewhitelist.command.enable Enable the whitelist
/swl disable simplewhitelist.command.disable Disable the whitelist
/swl reload simplewhitelist.command.reload Reload config.yml and whitelist.txt
/swl help Any simplewhitelist.command.* Show command help

Wildcard / base permissions: simplewhitelist.command.* or simplewhitelist.command.

Configuration (config.yml)

  • enabled: true — enable/disable whitelist check;
  • caseSensitive: false — case-sensitive nickname matching;
  • enforceWhitelist: true — kick online non-whitelisted players on enable / remove / reload;
  • logBlockedJoins: true — log blocked join attempts with username in console;
  • onBlockedJoinCommands: [] — console commands executed when a non-whitelisted player tries to join (<name> placeholder).

Project description from Modrinth.

Pick your setup

SimpleWhitelist by Minecraft version and loader

Choose the version and loader you play, then open the matching release.

233 available setups

Showing the newest 12 of 63 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

SimpleWhitelist versions and loaders

1 of 37 releases match
Clear filters

Looking for an older file? The official Modrinth project page is in Resources.

Keep browsing

See more mods

Like this one? One of these might be worth a look.