ModsFinder

AutoWhitelist

by Awakened-Redstone

AutoWhitelist links a Discord role on a Minecraft Java server to the server's whitelist, so a player who gains the role is whitelisted automatically.

FabricServer-side onlyGNU Lesser General Public License v3.0 onlyOpen source1.18 – 26.2

What it does

Whitelisting is driven by Discord roles. When a member gains the role set by the server owner, the matching player is added to the whitelist, and the mod can remove the player again when the role is lost. Usernames are kept in memory, so a returning player with the required role is whitelisted without a manual step. Whitelist actions can also run commands, for example to grant LuckPerms permissions alongside the whitelist entry. Fabric API is required, and LuckPerms and Player Roles are optional dependencies.

The mod uses the vanilla whitelist rather than a separate list, so the login process stays close to the vanilla experience. It works with the whitelist setting in server.properties and with whitelisting done from the server console. Messages shown to players can be customized, and the mod offers an API so other mods can add more whitelist actions. Text Placeholder API is bundled inside the mod. Only the server needs it, and players join without installing anything. AutoWhitelist is open source under the GNU Lesser General Public License v3.0 only and has files for 1.18 – 26.2, including snapshot builds.

Key features

  1. Role-based whitelisting

    Players are added to or removed from the whitelist according to the Discord role they hold.

  2. Whitelist cache

    Usernames are kept in memory, so a returning player with the required role is whitelisted again without a manual step.

  3. Whitelist actions

    Each action can run commands, such as granting LuckPerms permissions when a player is whitelisted.

  4. Custom messages

    The text shown to players can be changed in the mod's configuration.

  5. Extension API

    An API lets other mods register additional whitelist actions.

Compatibility

Latest build for each game version and loader.

26.x4 of 4 versions with builds
26.22.0.0-alpha.2+26.2
26.1.22.0.0-alpha.2+26.1
26.1.12.0.0-alpha.2+26.1
26.12.0.0-alpha.2+26.1
1.21.x12 of 12 versions with builds
1.21.111.3.3+1.21.11
1.21.101.3.3+1.21.9
1.21.91.3.3+1.21.9
1.21.81.3.3+1.21.6
1.21.71.3.3+1.21.6
1.21.61.3.3+1.21.6
1.21.51.3.3+1.21.5
1.21.41.3.3+1.21.2
1.21.31.3.3+1.21.2
1.21.21.3.3+1.21.2
1.21.11.3.3+1.21
1.211.3.3+1.21
1.20.x7 of 7 versions with builds
1.19.x5 of 5 versions with builds
1.18.x3 of 3 versions with builds
ReleaseBetaAlphaNot available

This mod also publishes snapshot builds. Snapshots are not shown in the matrix.

Requirements

Dependencies declared by the latest file for each loader.

Required 1

Fabric APILightweight and modular API providing common hooks and intercompatibility measures utilized by mods using the Fabric toolchain.
Required

Optional 2

LuckPermsA permissions plugin/mod for Minecraft servers.
Optional
Player RolesRole & permission management for Fabric servers
Optional

Embedded 1

Text Placeholder APIPlaceholder and Text manipulation library for your Minecraft mods.
Embedded

How it compares

Full comparison

Simple Whitelist is also server-side only and open source under the MIT License, with files for 1.18 – 26.2, but it does not link to Discord roles. Discord: JustSync is server-side only under the GNU General Public License v3.0 or later, published for 1.21.4 – 26.3, and covers Discord synchronization as its main purpose. Discord integration Luckperms is a client and server mod for Fabric and Forge on 1.20.1 only, and it is not open source.

ModLoadersGame versionsEnvironmentUpdated
AutoWhitelistFabric1.18 – 26.2Server-side only2026-09-12
Simple WhitelistFabric1.18 – 26.2Server-side only2026-07-26
Discord: JustSyncFabric1.21.4 – 26.3Server-side only2026-09-24
Discord integration LuckpermsFabric and Forge1.20.1Client and server2024-10-16

Questions

Does AutoWhitelist need Fabric API?

Yes. Fabric API is a required dependency and must be installed on the server next to AutoWhitelist.

Does a player need the mod on their client?

No. Server owners install it, and players connect with no copy of their own.

Can AutoWhitelist grant LuckPerms permissions?

Yes. LuckPerms compatibility is built in, and a whitelist action can run commands that give permissions when a player is added.

In the catalog

AutoWhitelist is one of 8,016 Management mods on ModsFinder, and one of 5,930 Management mods for Fabric. 13,894 mods support Minecraft 26.2.

More from Awakened-Redstone

All projects

Similar mods

What the author says

This mod works on top of the vanilla whitelist, so make sure to enable the vanilla whitelist, you can do that by changing white-list on server.properties to true or by running whitelist on on the server console
Awakened-Redstone, on the Modrinth page

Official listing

Owner
Awakened-Redstone
Published
2023-04-19
Updated on Modrinth
2026-09-12
Facts verified
2026-10-15

Tags