Перейти к содержимому
Mineforgian

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

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

Ченджлог

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 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 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 .geyser key 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
  • 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-commands command
  • Added /awutowhitelist rebuild-from-cache which 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 register to link
    • Added autocomplete options for the link command, these options are suggestions based on the discord username and display name
    • Renamed info to my-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 Apps when right-clicking a user
      • The chat command has 2 subcommands, user and username
        • user lets you get a user's link info from a discord profile
        • username lets you get a user's link info from a Minecraft username
    • Added user-link, an admin command to modify the link of a user
      • The subcommand modify allows a moderator to add or modify a user's linked account
      • The subcommand remove allows a moderator to remove a user's linked account
  • 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

Комментарии

Загружаем…