# DiscordWhitelistPlugin<\/p>\n
A simple PaperMC plugin to whitelist Minecraft players based on their Discord roles using EssentialsX Discord Link.<\/p>\n
## Features
\n– Only allow players with a specific Discord role to join your server
\n– Customizable kick messages and log prefix
\n– Bypass permission for staff or trusted users
\n– Easy configuration<\/p>\n
## Requirements
\n– PaperMC 1.21+
\n– EssentialsX Discord Link
\n– Java 17+<\/p>\n
## Installation
\n1. Download `SimpleDiscordWhitelist-1.0.0.jar` and place it in your server’s `plugins` folder.
\n2. Make sure EssentialsX Discord Link is installed and configured.
\n3. Start your server to generate the default `config.yml`.
\n4. Edit `plugins\/SimpleDiscordWhitelist\/config.yml`:
\n – Set `required-discord-role-id` to your Discord role’s ID.
\n – Optionally set custom messages and other options.<\/p>\n
## Example config.yml
\n“`yaml
\nrequired-discord-role-id: “YOUR_ROLE_ID_HERE”
\n# Optional: required-discord-role-name: “RoleNameHere”
\n# Message shown if player is linked but does not have the required Discord role
\nkick-no-role: “You are linked to a Discord account, but you do not have the required role to join this server.”
\n# Message shown if there was an error verifying the Discord role
\nkick-error: “Could not verify your whitelist. Try again later or contact staff.”
\n# Message shown if the plugin is not configured correctly
\nkick-not-configured: “Plugin not configured correctly. Contact server staff.”
\n# Message shown if the player is not linked to Discord
\nkick-not-linked: “Please link using EssentialX.”
\nbypass-permission: “discordwhitelist.bypass”
\nlog-prefix: “[DiscordWhitelist] ”
\n“`<\/p>\n
## Permissions
\n– `discordwhitelist.bypass` \u2014 Allows a player to bypass the Discord whitelist check.<\/p>\n
## Support
\nIf you need help, open an issue on GitHub or ask in the EssentialsX Discord.<\/p>\n
## License
\nMIT<\/p>\n","protected":false},"excerpt":{"rendered":"
SimpleDiscordWhitelist is a PaperMC plugin that whitelists players by Discord role using EssentialsX Discord Link.<\/p>\n","protected":false},"featured_media":0,"template":"","meta":{"_minecraft_slug":"simplediscordwhitelist","_minecraft_project_id":"XUv94o6z","_minecraft_author":"kryclopz1","_minecraft_license":"MIT","_minecraft_downloads":118,"_minecraft_follows":1,"_minecraft_client_side":"unsupported","_minecraft_server_side":"required","_minecraft_storage_type":"zip","_minecraft_archive_name":"simplediscordwhitelist.zip","_minecraft_size_bytes":11102,"_minecraft_version_count":2,"_minecraft_updated_at":"2026-05-15T19:14:43.045489Z","_minecraft_date_created":"2025-08-12T03:20:01.279641Z","_minecraft_date_modified":"2025-08-11T17:19:45.355046Z","_minecraft_project_url":"https:\/\/modrinth.com\/mod\/simplediscordwhitelist","_minecraft_icon_attachment_id":0,"_minecraft_imported_at":"2026-06-08T08:58:25+00:00","_minecraft_import_hash":"31fdb10413cdabfa637206f18c5d2645","_minecraft_versions":"","_minecraft_links":"","_minecraft_gallery":"","_minecraft_api_metadata":""},"mod_category":[127],"mod_loader":[132],"minecraft_version":[62,37,73,74,38,78,79,80,81],"class_list":["post-140970","mod","type-mod","status-publish","hentry","mod_category-paper","mod_loader-paper","minecraft_version-1-21","minecraft_version-1-21-1","minecraft_version-1-21-2","minecraft_version-1-21-3","minecraft_version-1-21-4","minecraft_version-1-21-5","minecraft_version-1-21-6","minecraft_version-1-21-7","minecraft_version-1-21-8"],"yoast_head":"\n