
AutoWhitelist
A way to automate the whitelist of a minecraft server based on discord roles
- Загрузки
- 10K
- Подписчики
- 66
- Обновлён
- 29 июня 2026 г.
- Лицензия
- LGPL-3.0-only
Опубликован 19 апреля 2023 г.
⚙️ 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
Ченджлог
2.0.0-alpha.1+26.1Альфа26.1, 26.1.1, 26.1.2 · 29 июня 2026 г.
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
ymltojsonon 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_delayandcache_discord_datahave 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 entriesis now namedallow, it has also been updated to support multiple or no actions- An entry now takes an
actionsfield, which can be an action object or a list of action objects
- An entry now takes an
- 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 account previously linked, but is no longer in the whitelist, they will be automatically added to the whitelist (if qualified) when they attempt to join the server.
- For a lower impact on connection time the cache now uses the internal cache exclusively.
This is currently being tested, if you encounter a case where a Discord user was not in the cache when the should please report it.
- The not whitelisted disconnect message now has a line appended to the end
- The message is controlled by the translation
multiplayer.autowhitelist.disconnect.not_whitelisted.tip, the.geyserkey suffix is used if GeyserMC and Floodgate are present - The message will always use the server language, this is a limitation due to it being used early in the
- The message is controlled by the translation
- Whitelisted usernames are updated on connection
- When a player logs in, if the whitelist entry for their UUID doesn't match their username, it will then be updated and saved into the whitelist file
- Removed the
/autowhitelist fix-duplicate-commandscommand - Added
/awutowhitelist rebuild-from-cachewhich goes through the whitelist cache to update the whitelist with linked entries - Added
/autowhitelit remove-all-guild-commands, this command deletes all the Discord application's guild commands. This command is only present to fix unused or broken application commands, use with caution!
Discord integration
- Migrated from JDA to Discord4J
- Rewrote the registration process
- The process is now cleaner, smoother and a lot easier to expand and implement
- Reworked the interaction handler
- Updated all commands
- Renamed
registertolink - Added autocomplete options for the
linkcommand, these options are suggestions based on the discord username and display name - Renamed
infotomy-link - Added
link-info, an admin command to view a user's link details- This command has a chat and user variant
- User commands show under
Appswhen right-clicking a user
- User commands show under
- The chat command has 2 subcommands,
userandusernameuserlets you get a user's link info from a discord profileusernamelets you get a user's link info from a Minecraft username
- This command has a chat and user variant
- Added
user-link, an admin command to modify the link of a user- The subcommand
modifyallows a moderator to add or modify a user's linked account - The subcommand
removeallows a moderator to remove a user's linked account
- The subcommand
- Renamed
- Improved replies
- Updated to Components V2
- Reworked all replies
1.3.3+1.21.9Релиз1.21.9, 1.21.10 · 27 декабря 2025 г.
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, 1.21.7, 1.21.8 · 27 декабря 2025 г.
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 · 27 декабря 2025 г.
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, 1.21.3, 1.21.4 · 27 декабря 2025 г.
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, 1.21.1 · 27 декабря 2025 г.
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 · 27 декабря 2025 г.
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, 1.20.1 · 27 декабря 2025 г.
Added support for 1.21.11
This is the last version support update for AutoWhitelist 1.x.x
Комментарии
Загружаем…