# \ud83d\udcc4 PasswordWhitelist
\nA plugin to make users enter a password on server join.<\/p>\n
## Quick links
\n– Paper download<\/p>\n
## Description
\nThis plugin adds a new twist to whitelisting! Instead of manually adding players to your whitelist, you can set a server-wide password, which all connecting users will have to enter on server join. The plugin utilizes the new dialog system introduced with the 1.21.6 Minecraft update and a new configuration API introduced by Paper in 1.21.7 to make the process very clean and smooth.<\/p>\n
## Features
\n– Extensive customizability
\n– MiniMessage Format
\n– New dialog system introduced in 1.21.6
\n– Async configuration-phase password input<\/p>\n
## Folia compatibility
\nFolia compatibility is a goal, which at the time of writing might not be reached yet,
\nas no public builds of Folia 1.21.7 have been released so far.<\/p>\n
## Paper compatibility
\nThis plugin should work on all Paper servers on version 1.21.7 (build #17) and higher.<\/p>\n
## Permissions
\n\u26a0\ufe0f It is suggested that you install LuckPerms for managing permissions.<\/p>\n
Below is a table of all permissions, their default values, and their descriptions:<\/p>\n
| Permission | Default | Description |
\n|—————————————–|———|——————————————————————————|
\n| passwordwhitelist.exclude | false | Excludes a user from having to enter the password |
\n| passwordwhitelist.command.use | op | Main permission required to run the \/passwordwhitelist command |
\n| passwordwhitelist.command.help | true | Permission required to run the ‘\/passwordwhitelist help’ subcommand |
\n| passwordwhitelist.command.reload | true | Permission required to run the ‘\/passwordwhitelist reload’ subcommand |
\n| passwordwhitelist.command.enable | true | Permission required to run the ‘\/passwordwhitelist enable’ subcommand |
\n| passwordwhitelist.command.disable | true | Permission required to run the ‘\/passwordwhitelist disable’ subcommand |
\n| passwordwhitelist.command.attempts | true | Permission required to run the ‘\/passwordwhitelist attempts’ subcommand |
\n| passwordwhitelist.command.password | true | Permission required to run the ‘\/passwordwhitelist password’ subcommand |
\n| passwordwhitelist.command.password.set | op | Permission required to run the ‘\/passwordwhitelist password set’ subcommand |
\n| passwordwhitelist.command.password.show | op | Permission required to run the ‘\/passwordwhitelist password show’ subcommand |<\/p>\n
If you are confused about the `true` values for some of the subcommands: The only reason they are set to `true` by
\ndefault is to make quick permission setups easier. All players require to `passwordwhitelist.command.use` permission
\nin order to use any command. The sub-permissions merely allow for fine-grained control for server owners.<\/p>\n
### Note regarding the exclude permission<\/p>\n
Because of the exclude permission being checked during the configuration phase of a player’s server connection, it is
\nnot possible
\nto check the player’s permission through Paper’s API. Therefore, this feature requires
\nthat LuckPerms
\nis installed on the server.<\/p>\n
## Command
\n– Aliases: `passwordwhitelist`, `\/passw`, and `\/pw`.<\/p>\n
| Command | Description | Set a global password for your server!<\/p>\n","protected":false},"featured_media":119691,"template":"","meta":{"_minecraft_slug":"passwordwhitelist","_minecraft_project_id":"40zW4HrD","_minecraft_author":"Strokkur24","_minecraft_license":"CC-BY-ND-4.0","_minecraft_downloads":472,"_minecraft_follows":2,"_minecraft_client_side":"unsupported","_minecraft_server_side":"required","_minecraft_storage_type":"zip","_minecraft_archive_name":"passwordwhitelist.zip","_minecraft_size_bytes":200113,"_minecraft_version_count":3,"_minecraft_updated_at":"2026-05-16T10:43:07.668593Z","_minecraft_date_created":"2025-07-21T20:18:53.658857Z","_minecraft_date_modified":"2025-07-16T16:53:53.713873Z","_minecraft_project_url":"https:\/\/modrinth.com\/mod\/passwordwhitelist","_minecraft_icon_attachment_id":119691,"_minecraft_imported_at":"2026-06-07T01:02:33+00:00","_minecraft_import_hash":"9498d120ffc44675847a7969cf9f10ce","_minecraft_versions":"","_minecraft_links":"","_minecraft_gallery":"","_minecraft_api_metadata":""},"mod_category":[89,126,127,867,92],"mod_loader":[132],"minecraft_version":[40,41,80,81,82,83,167],"class_list":["post-119690","mod","type-mod","status-publish","has-post-thumbnail","hentry","mod_category-game-mechanics","mod_category-management","mod_category-paper","mod_category-social","mod_category-utility","mod_loader-paper","minecraft_version-1-21-10","minecraft_version-1-21-11","minecraft_version-1-21-7","minecraft_version-1-21-8","minecraft_version-1-21-9","minecraft_version-26-1","minecraft_version-26-1-1"],"yoast_head":"\n
\n|———————————————-|————————————————|
\n| `\/passwordwhitelist help` | Show a help message |
\n| `\/passwordwhitelist reload [
\n| `\/passwordwhitelist enable` | Enable the password whitelist |
\n| `\/passwordwhitelist disable` | Disable the password whitelist |
\n| `\/passwordwhitelist password set
\n| `\/passwordwhitelist password show` | Show the current password |
\n| `\/passwordwhitelist attempt reset