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

1. Stop your server.
2. Put the PendingWhitelist JAR in your server's plugins folder.
3. Start the server.
4. Run /wl in-game to open the admin dashboard.
5. Give trusted staff the pendingwhitelist.admin permission 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:

1. Players who tried to join while the whitelist was on
2. Players who are online
3. 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.

/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.

View the source code.