PendingWhitelist
See who tried to join your server while the whitelist was on, and decide who to let in.
When a player who isn't whitelisted tries to join while the whitelist is on, the server rejects them as usual. PendingWhitelist saves the attempt so you and your staff can review it later. Players are not added to the whitelist automatically.
What you can do
- See who tried to join, how many times they tried
- Review pending players and manage your whitelist in-game
- Get clickable notifications when someone is rejected
- Add Bedrock players with Floodgate
- Automatically remove old pending requests
Getting started
Requirements
- A Paper or Purpur server running Minecraft 1.20+
- Java 17 or newer, as required by your server version
- Floodgate for Bedrock support (optional)
- SkinsRestorer for offline-mode player skins (optional)
Installation
- Stop your server.
- Put the PendingWhitelist JAR in your server's
pluginsfolder. - Start the server.
- Run
/wlin-game to open the admin dashboard. - Give trusted staff the
pendingwhitelist.adminpermission so they can manage the plugin and receive notifications.
To change the settings, edit plugins/PendingWhitelist/config.yml and run /wl reload.
Managing players
Add players
Open the Add Players menu with /wl add or /wl rpl. Players are shown in this order:
- Players who tried to join while the whitelist was on
- Players who are online
- Players who have joined before
Bedrock players appear before Java players in the pending and online sections.
- Left-click a player to add them to the whitelist.
- Shift-click to add all players on the current page.
You can also use /wl add <player> to add a player by name. If you use Floodgate, /wlb add <player> is available for Bedrock players.
Remove players from the whitelist
Open the Whitelisted Players menu with /wl remove.
- Left-click a player to remove them from the whitelist.
- Shift-click to remove all players on the current page.
Join notifications
Staff with pendingwhitelist.admin can receive a notification when a non-whitelisted player is rejected. The notification includes clickable actions for managing the request.
You can configure notifications and set a cooldown to reduce spam from repeated attempts.
Commands
All administration commands require the pendingwhitelist.admin permission. Replace <player...> with one or more player names; [page] is optional.
| Command | Description |
|---|---|
/wl |
Open the admin dashboard |
/wl add |
Open the Add Players menu |
/wl add <player...> |
Add players to the whitelist |
/wl list [page] |
List whitelisted players |
/wl remove |
Open the Whitelisted Players menu |
/wl remove <player...> |
Remove players from the whitelist |
/wl pl [page] |
List pending players |
/wl rpl |
Open the Add Players menu |
/wl rpl <player...> |
Remove players from the pending list |
/wlb add <player...> |
Add Bedrock players to the whitelist |
/wl on |
Turn the whitelist on |
/wl off |
Turn the whitelist off |
/wl reload |
Reload the plugin settings |
/wl version |
Check for a newer stable release |
/wlb is available when Floodgate is installed.
Settings
You can change notification settings, the notification cooldown, and cleanup of old pending requests. See the configuration guide for all available settings.
After making changes, run /wl reload.
bStats
PendingWhitelist uses bStats for anonymous plugin statistics. You can disable bStats through its global configuration.
Support
Found a bug or have a feature request? Open an issue on GitHub.
No gallery available for this project.
| Version | Minecraft | Loader | Download |
|---|---|---|---|
|
Pending Whitelist 2.2.4 2.2.4 |
1.20, 1.20.1, 1.20.2, 1.20.3, 1.20.4, 1.20.5, 1.20.6, 1.21, 1.21.1, 1.21.10, 1.21.11, 1.21.2, 1.21.3, 1.21.4, 1.21.5, 1.21.6, 1.21.7, 1.21.8, 1.21.9, 26.1, 26.1.1, 26.1.2, 26.2, 26.3
|
paper, purpur
|
Download |
|
Pending Whitelist 2.2.3 2.2.3 |
1.20, 1.20.1, 1.20.2, 1.20.3, 1.20.4, 1.20.5, 1.20.6, 1.21, 1.21.1, 1.21.10, 1.21.11, 1.21.2, 1.21.3, 1.21.4, 1.21.5, 1.21.6, 1.21.7, 1.21.8, 1.21.9, 26.1, 26.1.1, 26.1.2, 26.2, 26.3
|
paper, purpur
|
Download |
|
Pending Whitelist 2.2.2 2.2.2 |
1.20, 1.20.1, 1.20.2, 1.20.3, 1.20.4, 1.20.5, 1.20.6, 1.21, 1.21.1, 1.21.10, 1.21.11, 1.21.2, 1.21.3, 1.21.4, 1.21.5, 1.21.6, 1.21.7, 1.21.8, 1.21.9, 26.1, 26.1.1, 26.1.2, 26.2, 26.3
|
paper, purpur
|
Download |
|
Pending Whitelist 2.2.1 2.2.1 |
1.20.1, 1.20.2, 1.20.3, 1.20.4, 1.20.5, 1.20.6, 1.21, 1.21.1, 1.21.10, 1.21.11, 1.21.2, 1.21.3, 1.21.4, 1.21.5, 1.21.6, 1.21.7, 1.21.8, 1.21.9, 26.1, 26.1.1, 26.1.2, 26.2, 26.3
|
paper, purpur
|
Download |
|
Pending Whitelist 2.2.0 2.2.0 |
1.20.1, 1.20.2, 1.20.3, 1.20.4, 1.20.5, 1.20.6, 1.21, 1.21.1, 1.21.10, 1.21.11, 1.21.2, 1.21.3, 1.21.4, 1.21.5, 1.21.6, 1.21.7, 1.21.8, 1.21.9, 26.1, 26.1.1, 26.1.2, 26.2
|
paper, purpur
|
Download |
|
Pending Whitelist 2.1.0 2.1.0 |
1.20.1, 1.20.2, 1.20.3, 1.20.4, 1.20.5, 1.20.6, 1.21, 1.21.1, 1.21.10, 1.21.11, 1.21.2, 1.21.3, 1.21.4, 1.21.5, 1.21.6, 1.21.7, 1.21.8, 1.21.9, 26.1, 26.1.1, 26.1.2, 26.2
|
paper, purpur
|
Download |
|
Pending Whitelist 2.0.0 2.0.0 |
26.2
|
paper, purpur
|
Download |
|
Pending Whitelist 1.2.8 1.2.8 |
26.2
|
paper, purpur
|
Download |
|
Pending Whitelist 1.2.6 1.2.6 |
26.2
|
paper, purpur
|
Download |
|
Pending Whitelist 1.2.0 1.2.0 |
26.2
|
paper, purpur
|
Download |
|
Pending Whitelist 1.0.0 1.0.0 |
26.2
|
paper, purpur
|
Download |