Discord Whitelister 1.4.4

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
    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
    • 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 send me a message on discord (Joe#5782).

Recent Reviews

  1. hammad_alhassan
    Version: 1.4.4
    five stars plugin i recommend .
  2. vk48
    Version: 1.4.2
    Great plugin with excellent support and active developer. The plugin helped my whitelist server so much. Thanks!
  3. gamerkaos
    Version: 1.4.1
    It would be awesome if the plugin let us whitelist the "invalid Minecraft username" 's with the EasyWhitelist for offline mode servers.
  4. ZeeRaider
    Version: 1.3.6
    Fantastic plugin and excellent support from a developer that clearly loves what he does! Kudos, this is better than many of the premium plugins I own and offers better support than most1 I would 100% support the development of this project!
  5. -BeefSoup-
    Version: 1.3.6
    Super nice developer! I had an issue that I noticed and when I reported it to him he patiently worked me through the issue and provided great support. Outside of support, the plugin overall is just an amazing and under-rated plugin.

    I highly recommend to any server owner of a whitelisted server, saves you so much time!
  6. iCaitlyn
    Version: 1.3.6
    Does what it says on the tin wonderfully, quite useful when configured properly!
  7. MrEngMan
    Version: 1.3.6
    Excellent plugin, does exactly what is says and does it very well!
    Author is responsive and active.
    Overall highly recommend.
  8. ZinitiateGames
    Version: 1.3.5
    Amazing plugin that does exactly what it says, along with amazing support from the developer!
  9. Sorienrot
    Version: 1.3.5
    Great job listening to the suggestions and helping in any way possible. I recommend its download for its ease of use.
  10. Athame
    Version: 1.2.0
    Thanks. I use it on my server. I like the system very much. Plugin owner is also very relevant