Discord Whitelister 1.4.9

A simple spigot plugin which allows whitelisting through a discord text channel.

  1. JoeShimo
    Native Minecraft Version:
    Tested Minecraft Versions:
    • 1.12
    • 1.13
    • 1.14
    • 1.15
    • 1.16
    • 1.17
    Source Code:
    Discord Whitelister Bot for Spigot
    A simple spigot plugin which allows whitelisting through a discord text channel. This provides an easy way for users to whitelist without needing to be on the minecraft server.

    If you're using version 1.3.7 or below and the plugin is causing your server to hang on start-up please enable 'SERVER MEMBERS INTENT' located at https://discord.com/developers/applications -> the application you're using to run this bot -> the bot button on the left and also update to version 1.3.8 or higher.



    3 separate role groups

    • add-remove group: allows the user to add and remove users from the whitelist an unlimited amount of times (recommended for owners and admins).
    • add group: allows the user to add to the whitelist an unlimited amount of times (recommended for moderators).
    • limited-add group: allows the user to whitelist a limited amount of times (recommended for users, default amount is 3).
    • limited-add group can be disabled in the config (enabled by default).
    Removed List
    • This list removes the ability for limited-add users to add back users that have been removed by the add-remove group. For example: a whitelisted user cannot add a user that has been removed by an admin or moderator.
    • Can be disabled in the config (enabled by default).
    Discord Commands

    As of version 1.4.9, the ! prefix for commands has been replaced with / to utilize Discord's slash commands feature.

    • Use /whitelist add "minecraftUsername" in a valid channel to whitelist people on your minecraft server.
    • Use /whitelist remove "minecraftUsername" in a valid channel to remove people from the whitelist on your minecraft server.
    • Use /whitelist in a valid channel to get info about the bot and how to use it.
    Custom Message Support
    • Allows editing of server response messages (file is located at (server-root)/plugins/DiscordWhitelister/custom-messages.yml)
    • This feature is disabled by default and can be enabled in the config file (use-custom-messages)
    • Note: Only message variables ({Sender} for example) in the original messages will be evaluated. For example: using {MaxWhitelistAmount} in the "insufficient-permissions" string/message will not work as it was never in the original string/message
    Use Discord Server/Guild role ids instead of role names

    • Allows the use of ids of roles instead of names, for example: 445666895333687347 instead of Admin
    • To enable this set 'use-id-for-roles' to true
    Example of relevant fields changed in the config to use ids:
    Code (YAML):
    - 446223693887176704
    - 485463455940214794
    - 639221397981233162
    : true
    Reload command
    • Use the command 'dwreload' or 'discordwhitelisterreload' to reload the config and re-initialize the bot without having to restart the Minecraft server
    Automatically add/remove a role when adding/removing to/from the whitelist
    • This feature is meant to be used when users can add themselves to the whitelist.
    • If whitelisted-role-auto-add is set to true (false by default), the Discord role with the name defined by whitelisted-role ("Whitelisted" by default) will be added to that user when they successfully add (themselves) to the whitelist.
    • If whitelisted-role-auto-remove is set to true (false by default), that role will be removed from that user when they successfully remove (themselves) from the whitelist.
    • This requires:
      • The bot to have the Manage Roles permission in Discord
      • Setting up a Discord role with the same name (case sensitive) as the config
      • The bots role must be higher than the whitelist role

    • Only select Discord roles can whitelist through the bot
    • Bot only listens for messages in select text channels
    • Logs whitelist attempts from valid roles in the console

    Set Up
    Config file is located at: (server-root)/plugins/DiscordWhitelister/discord-whitelister.yml, this needs a valid bot token and valid channel id(s) to work. To create a Discord application and/or find your discord bot token, follow this link: https://discordapp.com/developers/applications/

    UPDATE: please enable 'SERVER MEMBERS INTENT' located at https://discord.com/developers/applications, the application you're using to run this bot, then the bot button on the left and make sure your version is 1.3.8 or higher.

    For the most up to date information on how to configure the bot please check the wiki.

    Here is a short video showing all the steps needed to configure the bot:

    Backwards compatibility (Only applies to versions lower than v1.2.0)
    Version 1.2.0 onward are not compatible with version 1.1.x and lower. This is due to the layout of user-list.yml being changed. You will need to remove user-list.yml manually and let the plugin create a new one. If you upgrade without doing so, registration will not work correctly.

    Need Help?

    • If you get stuck setting up the bot feel free to leave a post in the discussion section.
    MondmannTV and WhitePythagos like this.

Recent Reviews

  1. freezinger
    Version: 1.4.9
    Good, simple plugin that should do it's job perfectly and I believe it 1) has in the past and 2) does for some people. One issue - the bot is entirely unresponsive in the Discord even though it doesn't have any errors when launching the server and the logs are fine. This seems like it has happened more than once because another user on GitHub has presented this as an issue looking for assistance and the creator has not responded in almost a week.

    TLDR: I would love to use this plugin but it isn't working and the creator is very slow with addressing issues or assisting users.

    My rating will change when the author becomes active again or SOMETHING happens.
  2. TryPanix
    Version: 1.4.9
    Good plugin, pls help me. I add bot to the my discord channel, when i type /whitelist in my commands channel it says "This Channel is for Commands Only
    @NoFraGG (traumvolles), this channel is for commands only, please use another channel." pls help me my discord is NoFraGG#4269
  3. Nyukey
    Version: 1.4.9
    Good plugin, pls help me. I add bot to the my discord channel, but / doesn`t work, if i try write bot pm, they have / commands. I switch on "show-warning-in-command-channel: true" and when i write in correct channel, bot reply use command only, but i write /whitelist add Nyukey.
  4. Daveb7945
    Version: 1.4.9
    This plugin has been great, and has done exactly what it says. I just upgraded however to the 1.4.9 version and started experiencing issues.

    First issue: I now get the console message: "11.08 13:19:17 [Server] ERROR Could not pass event PlayerQuitEvent to DiscordWhitelister v1.4.8"

    Second issue: I am able to add users (testing) to the whitelist, but when I go to remove them, I am told that "could not find name testing to clear in user list."

    Lastly... Does anybody else find it Ironic that the person who made a *Discord* plugin... doesn't have a Discord server?
  5. MondmannTV
    Version: 1.4.7
    great plugin but when can we expact an 1.17 update? i would really enjoy this one <3
  6. AustinFRG
    Version: 1.4.7
    Great plugin, but I'm having a few issues with it. Whitelisted players are still being kicked for not being whitelisted, even though they are whitelisted. (Still leaving a 5 star review, because I doubt it's an issue with this plugin)
  7. HAG0S
    Version: 1.4.7
  8. Screams88
    Version: 1.4.7
    Dropping 5 star because whitelist feature works great. Cannot figure out how to add and remove roles upon using the whitelist command from the bot. I added you on discord pls add me back Screams is the username
  9. berner5300
    Version: 1.4.5
    Such a lifesaver. Wish that I could give you more stars.
    Is there a way to remove a user from the whitelist, if the user loses the role on discord?
  10. hammad_alhassan
    Version: 1.4.5
    5stars plugin and thanks for creating this amazing plugin .