All Mods Resource Packs Data Packs Shaders Modpacks Plugins
AutoWhitelist

AutoWhitelist

by Awakened-Redstone • Downloads: 0 • Followers: 0
Description
Gallery
Changelog
Versions

fabric-api

⚙️ Features

  • Discord link - allow users to add their Minecraft accounts to the whitelist with access filtered by role
  • Whitelist actions - execute actions when whitelisting/removing a player, execute commands, give them LuckPerms permissions or just whitelist
  • Whitelist cache - keep memory of the usernames, and automatically whitelist the players when they log in if they gained the required role back
  • Rich documentation - quickly setup the mod and start using within minutes
  • Custom messages - easily customize the mod messages
  • Extendable - the mod offers an API for mods to add more whitelist actions
  • Built-in LuckPerms compatibility - the mod comes with LuckPerms compatibility by default
  • Fast and clean - the mod uses the vanilla whitelist, providing a closer vanilla experience and is designed to provide a seamless login experience compared to vanilla
  • Stable - the mod was originally made to and is still made to be as stable as possible
  • Friendly logging - the logging was done to provide necessary details on errors and warnings and to be understandable by anyone

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

You can customize the bot messages with a datapack, more about it can be found here

You can find a detailed documentation here

How to Install AutoWhitelist (Mod)

AutoWhitelist by Awakened-Redstone is verified for Fabric across Minecraft versions 1.18, 1.18.1, 1.18.2, 1.19, 1.19.1, 1.19.2, 1.19.3, 1.19.4 (latest release: 2.0.0-alpha.2+26.1, file size: 13.1 MB). Follow the steps below to install it safely from ModCraft.tv:

  1. Click the Download button above and select your Minecraft version (1.18, 1.18.1, 1.18.2, 1.19, 1.19.1, 1.19.2, 1.19.3, 1.19.4) and platform (Fabric).
  2. Make sure you have the compatible loader or environment installed for Fabric.
  3. Move the downloaded AutoWhitelist file into your Minecraft .minecraft/mods folder and launch the game.

All Versions

+ Add Version
Name Game version Platforms Published Downloads Actions
26.1.x
Fabric
2mo ago 1
26.2
Fabric
2mo ago 1
26.3.x
Fabric
2mo ago 1
26.1.x
Fabric
4mo ago 1
1.21.x
Fabric
10mo ago 1
1.21.x
Fabric
10mo ago 1
1.21.5
Fabric
10mo ago 1
1.21.x
Fabric
10mo ago 1
1.21.x
Fabric
10mo ago 1
1.21.11
Fabric
10mo ago 1
1.20.x
Fabric
10mo ago 1
1.21.x
Fabric
last yr. 1
1.21.x
Fabric
last yr. 1
1.21.x
Fabric
last yr. 1
1.21.x
Fabric
last yr. 1
1.20.x
Fabric
last yr. 1
1.21.5
Fabric
last yr. 1
1.21.x
Fabric
last yr. 1
1.21.x
Fabric
last yr. 1
1.21.5
Fabric
last yr. 1
1.21.x
Fabric
last yr. 1
1.21.x
Fabric
last yr. 1
1.20.x
Fabric
last yr. 1
1.21.5
Fabric
last yr. 1
1.21.x
Fabric
last yr. 1
1.21.x
Fabric
last yr. 1
1.20.x
Fabric
last yr. 1
1.21.x
Fabric
last yr. 1
1.21.x
Fabric
last yr. 1
1.21.x
Fabric
last yr. 1
1.20.x
Fabric
last yr. 1
1.21.x
Fabric
last yr. 1
1.21.x
Fabric
last yr. 1
1.21.5
Fabric
last yr. 1
1.20.x
Fabric
last yr. 1
1.21.6
Fabric
last yr. 1
1.21.x
Fabric
last yr. 1
1.21.x
Fabric
last yr. 1
1.21.5
Fabric
last yr. 1
1.21.x
Fabric
last yr. 1
1.20.x
Fabric
last yr. 1
1.21.x
Fabric
last yr. 1
1.21.x
Fabric
last yr. 1
1.21.5
Fabric
last yr. 1
1.21.x
Fabric
last yr. 1
1.20.x
Fabric
last yr. 1
1.21.x
Fabric
last yr. 1
1.21.5
Fabric
last yr. 1
1.20.x
Fabric
last yr. 1
1.21.x
Fabric
last yr. 1
1.21.5
Fabric
last yr. 1
1.21.x
Fabric
last yr. 1
1.20.x
Fabric
last yr. 1
1.21.x
Fabric
last yr. 1
1.21.x
Fabric
last yr. 1
1.21.5
Fabric
last yr. 1
1.20.x
Fabric
last yr. 1
1.21.x
Fabric
last yr. 1
1.21.x
Fabric
last yr. 1
1.21.5
Fabric
last yr. 1
1.20.x
Fabric
last yr. 1
1.21.x
Fabric
last yr. 1
1.21.x
Fabric
last yr. 1
1.20.x
Fabric
last yr. 1
1.21.x
Fabric
last yr. 1
1.21.x
Fabric
last yr. 1
1.20.x
Fabric
last yr. 1
1.21.x
Fabric
last yr. 1
1.21.x
Fabric
last yr. 1
1.21.x
Fabric
last yr. 1
1.21.x
Fabric
last yr. 1
1.20.2
Fabric
last yr. 1
1.20.x
Fabric
last yr. 1
1.20.x
Fabric
last yr. 1
1.20.x
Fabric
last yr. 1
1.18.x
Fabric
last yr. 1
1.18.2
Fabric
last yr. 1
1.19.x
Fabric
last yr. 1
1.19.4
Fabric
last yr. 1
1.20.x
Fabric
last yr. 1
1.20.2
Fabric
last yr. 1
1.20.x
Fabric
last yr. 1
1.20.x
Fabric
last yr. 1
1.21.x
Fabric
last yr. 1
1.21.4
Fabric
last yr. 1
1.18.x
Fabric
last yr. 1
1.18.2
Fabric
last yr. 1
1.19.x
Fabric
last yr. 1
1.19.4
Fabric
last yr. 1
1.20.x
Fabric
last yr. 1
1.20.2
Fabric
last yr. 1
1.20.x
Fabric
last yr. 1
1.21.x
Fabric
last yr. 1
1.20.x
Fabric
last yr. 1
1.21.4
Fabric
last yr. 1
1.20.x
Fabric
last yr. 1
1.21.4
Fabric
last yr. 1
1.19.4
Fabric
last yr. 1
1.20.x
Fabric
last yr. 1
1.18.2
Fabric
last yr. 1
1.19.x
Fabric
last yr. 1
1.18.x
Fabric
last yr. 1
1.21.x
Fabric
last yr. 1
1.20.2
Fabric
last yr. 1
1.20.x
Fabric
last yr. 1
1.18.x
Fabric
last yr. 1
1.18.2
Fabric
last yr. 1
1.19.x
Fabric
last yr. 1
1.19.4
Fabric
last yr. 1
1.20.x
Fabric
last yr. 1
1.20.2
Fabric
last yr. 1
1.20.x
Fabric
last yr. 1
1.20.x
Fabric
last yr. 1
1.21.x
Fabric
last yr. 1
1.18.x
Fabric
last yr. 1
1.18.2
Fabric
last yr. 1
1.19.x
Fabric
last yr. 1
1.19.4
Fabric
last yr. 1
1.20.x
Fabric
last yr. 1
1.20.2
Fabric
last yr. 1
1.20.x
Fabric
last yr. 1
1.20.x
Fabric
last yr. 1
1.21.x
Fabric
last yr. 1
1.18.x
Fabric
last yr. 1
1.18.2
Fabric
last yr. 1
1.19.x
Fabric
last yr. 1
1.19.4
Fabric
last yr. 1
1.20.x
Fabric
last yr. 1
1.20.2
Fabric
last yr. 1
1.20.x
Fabric
last yr. 1
1.20.x
Fabric
last yr. 1
1.21.x
Fabric
last yr. 1
1.18.x
Fabric
last yr. 1
1.19.4
Fabric
last yr. 1
1.18.2
Fabric
last yr. 1
1.20.x
Fabric
last yr. 1
1.19.x
Fabric
last yr. 1
1.20.2
Fabric
last yr. 1
1.20.x
Fabric
last yr. 1
1.20.x
Fabric
last yr. 1
1.21.x
Fabric
last yr. 1
1.18.x
Fabric
last yr. 1
1.18.2
Fabric
last yr. 1
1.19.x
Fabric
last yr. 1
1.19.4
Fabric
last yr. 1
1.20.x
Fabric
last yr. 1
1.20.2
Fabric
last yr. 1
1.20.x
Fabric
last yr. 1
1.20.x
Fabric
last yr. 1
1.21
Fabric
last yr. 1
1.18
Fabric
last yr. 1
1.18.1
Fabric
last yr. 1
1.18.2
Fabric
last yr. 1
1.19.x
Fabric
last yr. 1
1.19.x
Fabric
last yr. 1
1.20.x
Fabric
last yr. 1
1.20.2
Fabric
last yr. 1
1.20.x
Fabric
last yr. 1
1.20.x
Fabric
last yr. 1
1.18
Fabric
last yr. 1
1.18.1
Fabric
last yr. 1
1.18.2
Fabric
last yr. 1
1.19.x
Fabric
last yr. 1
1.19.x
Fabric
last yr. 1
1.20.x
Fabric
last yr. 1
1.20.2
Fabric
last yr. 1
1.20.x
Fabric
last yr. 1
1.20.2
Fabric
last yr. 1
1.20.2
Fabric
last yr. 1
1.20.2
Fabric
last yr. 1
1.20.1
Fabric
last yr. 1
1.20.1
Fabric
last yr. 1
1.19.4
Fabric
last yr. 1
1.20.x
Fabric
last yr. 1
1.19.4
Fabric
last yr. 1
1.19.4
Fabric
last yr. 1
1.19.4
Fabric
last yr. 1
1.19.4
Fabric
last yr. 1
# Changes in 2.0 - Alpha 2

### This is an alpha release!

### Before updating the mod, always backup your whitelist.json!

## Fixes

  • /link and /linkinfo no longer register as requiring admin permission
  • For some reason, passing 0 as the permission bitset defaults to admin only...
  • Locks that never expire no longer show a date in the past
  • instead it will say it expires in ~31k years. This is a temporary fix, it will be changed to say "never" in the future

## Changes
  • 26.2 support (petersv5)
  • 26.3 support
  • Reduced the mod jar size
  • Added the /userlinkinfo command
  • It allows an admin to view a specific user's link
  • The command requires the admin to have the kick member permission be default
  • It has 2 sub commands, user and username
  • user allows viewing the link of a Discord user
  • username allows viewing the link of the given in game username
  • username shows an autocomplete with currently whitelisted usernames
  • This command is planned into being merged into /userlink as a sub-command group.
  • Updated the autowhitelist rebuild-from-cache in game command
  • The command now adds all qualifying cached entries, instead of just removing whitelist entries and letting the cache on login do the rest
  • The option to not run actions has been removed. The new implementation doesn't support not running the add actions.
  • The command now runs asynchronously to avoid hanging the server thread for a long period, it will send a message when finished.
  • It is a bad idea do run the reload while it is running, that can cause issues
  • Added the /status command
  • This command shows the status of several parts of the mod environment.
  • There are 6 sub-commands
  • minecraft shows details about the game and loader.
  • networking shows details about the Minecraft server networking, this will be updated once multilink is implemented.
  • whitelist shows details about the server and mod whitelist.
  • cache shows details about the whitelist cache.
  • bot shows details about the Discord bot.
  • config shows details about the mod's config, this does **not** show the config itself.
  • The command currently has a hardcoded text and layout, this will be changed once the new system for the Discord messages is implemented.

Please provide feedback for the current command structure and naming.

# Changes in 2.0 - Alpha 2

### This is an alpha release!

### Before updating the mod, always backup your whitelist.json!

## Fixes

  • /link and /linkinfo no longer register as requiring admin permission
  • For some reason, passing 0 as the permission bitset defaults to admin only...
  • Locks that never expire no longer show a date in the past
  • instead it will say it expires in ~31k years. This is a temporary fix, it will be changed to say "never" in the future

## Changes
  • 26.2 support (petersv5)
  • 26.3 support
  • Reduced the mod jar size
  • Added the /userlinkinfo command
  • It allows an admin to view a specific user's link
  • The command requires the admin to have the kick member permission be default
  • It has 2 sub commands, user and username
  • user allows viewing the link of a Discord user
  • username allows viewing the link of the given in game username
  • username shows an autocomplete with currently whitelisted usernames
  • This command is planned into being merged into /userlink as a sub-command group.
  • Updated the autowhitelist rebuild-from-cache in game command
  • The command now adds all qualifying cached entries, instead of just removing whitelist entries and letting the cache on login do the rest
  • The option to not run actions has been removed. The new implementation doesn't support not running the add actions.
  • The command now runs asynchronously to avoid hanging the server thread for a long period, it will send a message when finished.
  • It is a bad idea do run the reload while it is running, that can cause issues
  • Added the /status command
  • This command shows the status of several parts of the mod environment.
  • There are 6 sub-commands
  • minecraft shows details about the game and loader.
  • networking shows details about the Minecraft server networking, this will be updated once multilink is implemented.
  • whitelist shows details about the server and mod whitelist.
  • cache shows details about the whitelist cache.
  • bot shows details about the Discord bot.
  • config shows details about the mod's config, this does **not** show the config itself.
  • The command currently has a hardcoded text and layout, this will be changed once the new system for the Discord messages is implemented.

Please provide feedback for the current command structure and naming.

# Changes in 2.0 - Alpha 2

### This is an alpha release!

### Before updating the mod, always backup your whitelist.json!

## Fixes

  • /link and /linkinfo no longer register as requiring admin permission
  • For some reason, passing 0 as the permission bitset defaults to admin only...
  • Locks that never expire no longer show a date in the past
  • instead it will say it expires in ~31k years. This is a temporary fix, it will be changed to say "never" in the future

## Changes
  • 26.2 support (petersv5)
  • 26.3 support
  • Reduced the mod jar size
  • Added the /userlinkinfo command
  • It allows an admin to view a specific user's link
  • The command requires the admin to have the kick member permission be default
  • It has 2 sub commands, user and username
  • user allows viewing the link of a Discord user
  • username allows viewing the link of the given in game username
  • username shows an autocomplete with currently whitelisted usernames
  • This command is planned into being merged into /userlink as a sub-command group.
  • Updated the autowhitelist rebuild-from-cache in game command
  • The command now adds all qualifying cached entries, instead of just removing whitelist entries and letting the cache on login do the rest
  • The option to not run actions has been removed. The new implementation doesn't support not running the add actions.
  • The command now runs asynchronously to avoid hanging the server thread for a long period, it will send a message when finished.
  • It is a bad idea do run the reload while it is running, that can cause issues
  • Added the /status command
  • This command shows the status of several parts of the mod environment.
  • There are 6 sub-commands
  • minecraft shows details about the game and loader.
  • networking shows details about the Minecraft server networking, this will be updated once multilink is implemented.
  • whitelist shows details about the server and mod whitelist.
  • cache shows details about the whitelist cache.
  • bot shows details about the Discord bot.
  • config shows details about the mod's config, this does **not** show the config itself.
  • The command currently has a hardcoded text and layout, this will be changed once the new system for the Discord messages is implemented.

Please provide feedback for the current command structure and naming.

# Changes in 2.0 - Alpha 1

### This is an alpha release!

### Before updating the mod, always backup your whitelist.json!

## Alpha notes

  • The alpha will only be available for 26.1 and later 26.2, if both will be supported at once is uncertain.
  • Many features aren't available yet, they will be added over time during the alpha stage.
  • The Discord responses are currently handled trough translations and have a fixed layout. This format may change in the future.
  • Admin discord commands are not yet available, they will be added in a future alpha version.
  • Several translation keys were changed. Backup your translation datapack and generate a new one for the new messages.
  • The Minecraft Server Management Protocol support is not fully developed and may have issues, use at your own risk.
  • The mod is currently using a tool that converts the translation file from yml to json on build time. The generated translations JSON may differ from the
original file.
  • The GeyserMC support uses the Geyser Global Cache to get a user's xuid from the username, currently it will fail if the username is not cached. \
There are plans for improving on this in a future alpha version.
  • The GeyserMC support has not been fully re-tested yet.

## General

  • It is now possible to disable the discord bot by setting the token to null
  • Fabric Language Kotlin is no longer required

## Config

The config is not final and will change during the alphas. \
Only the last version is kept, **keep a backup of your 1.x config!**
In the case that the config is split into multiple files, the v1 config is considered legacy and the autowhitelist folder will be reset

  • Reworked the config, separating it into categories
  • Updated the config handling to use an improved structure
  • Config errors are now cleaner and clearer
  • Updated the config to version 7
  • The config updater no longer supports configs of version 5 or prior
  • Renamed some options for easier understanding
  • Improved the comments on some options
  • $schema, enable_whitelist_cache, periodic_check_delay and cache_discord_data have been removed
  • Dropped updater support for versions 1-5
  • Added updater for version 6 to version 7
  • Whenever the config is updated, the old version is now saved as autowhitelist.json5.old
  • entries is now named allow, it has also been updated to support multiple or no actions
  • An entry now takes an actions field, which can be an action object or a list of action objects
  • Some options now have a hybrid structure, supporting multiple types.
  • Certain option structures are version dependent

### The allow field

The roles field remains within the entry object \
An action object holds the rest of the structure of the old entry object, with a type field for the action id,
and an execute field for action specific options

Check the actions section for the changes on actions

## Minecraft (in-game)

  • The whitelist cache now is always enabled
  • If a user had an a
...
[1.3.3+1.21.9] [1.21.9] Release 1.3.3 by Awakened-Redstone on Dec 27, 2025
Download
Added support for 1.21.11
### This is the last version support update for AutoWhitelist 1.x.x
[1.3.3+1.21.6] [1.21.6] Release 1.3.3 by Awakened-Redstone on Dec 27, 2025
Download
Added support for 1.21.11
### This is the last version support update for AutoWhitelist 1.x.x
[1.3.3+1.21.5] [1.21.5] Release 1.3.3 by Awakened-Redstone on Dec 27, 2025
Download
Added support for 1.21.11
### This is the last version support update for AutoWhitelist 1.x.x
[1.3.3+1.21.2] [1.21.2] Release 1.3.3 by Awakened-Redstone on Dec 27, 2025
Download
Added support for 1.21.11
### This is the last version support update for AutoWhitelist 1.x.x
[1.3.3+1.21] [1.21] Release 1.3.3 by Awakened-Redstone on Dec 27, 2025
Download
Added support for 1.21.11
### This is the last version support update for AutoWhitelist 1.x.x
[1.3.3+1.21.11] [1.21.11] Release 1.3.3 by Awakened-Redstone on Dec 27, 2025
Download
Added support for 1.21.11
### This is the last version support update for AutoWhitelist 1.x.x
[1.3.3+1.20] [1.20] Release 1.3.3 by Awakened-Redstone on Dec 27, 2025
Download
Added support for 1.21.11
### This is the last version support update for AutoWhitelist 1.x.x
[1.3.2+1.21.9] [1.21.9] Release 1.3.2 by Awakened-Redstone on Nov 03, 2025
Download
# Fixes
  • Fix the whitelist self nuking on reloads
[1.3.2+1.21.6] [1.21.6] Release 1.3.2 by Awakened-Redstone on Nov 03, 2025
Download
# Fixes
  • Fix the whitelist self nuking on reloads
[1.3.2+1.21.2] [1.21.2] Release 1.3.2 by Awakened-Redstone on Nov 03, 2025
Download
# Fixes
  • Fix the whitelist self nuking on reloads
[1.3.2+1.21] [1.21] Release 1.3.2 by Awakened-Redstone on Nov 03, 2025
Download
# Fixes
  • Fix the whitelist self nuking on reloads
AutoWhitelist Icon
Download AutoWhitelist
Select game version
Select platform