?
Host a serverModrinth App
Sign in
ModsResource PacksData PacksShadersModpacksPluginsServers
Settings
Pending Whitelist

Pending Whitelist

Add players to your whitelist directly from in-game join attempts with a clickable whitelist button.

13downloads
1follower
13downloads
1follower

Compatibility

Minecraft: Java Edition

26.2

Platforms

Links

Report issues View source

Tags

Creators

Details

Licensed MIT
Published 2 days ago
Updated yesterday

PendingWhitelist

PendingWhitelist is a lightweight Paper/Purpur plugin that makes whitelist management easier by automatically tracking players who try to join while they are not whitelisted.

Instead of asking players to send their usernames manually, admins can review the pending list and whitelist players directly with commands or clickable in-game actions.

Features

  • Automatically records players rejected by the server whitelist.
  • Stores player name, UUID, attempt count, and timestamps.
  • View pending players with pagination using /wl pl.
  • Whitelist one or multiple pending players with /wl add <player...>.
  • Use /wl add as a full /whitelist add replacement for usernames and UUIDs.
  • Supports Geyser/Bedrock players by temporarily whitelisting their UUID, then converting it to a username entry after they join.
  • Remove entries from the pending list with /wl rpl <player...>.
  • Remove players from both the whitelist and pending storage with /wl remove <player...>.
  • Sends clickable admin notifications when a non-whitelisted player tries to join.
  • Automatically removes pending entries after players are whitelisted.
  • Optional automatic purge for old pending entries.
  • Checks for newer GitHub releases and downloads updates automatically.
  • Shows installed/latest versions with /wl version and provides a clickable update button.
  • Logs update checks, downloads, and errors in the server panel.
  • Lightweight and designed for Paper/Purpur servers.

Commands

Command Description
/wl pl [page] Shows players waiting to be whitelisted.
/wl list Shows currently whitelisted players.
/wl add <player...> Whitelists pending or regular username/UUID players.
/wl rpl <player...> Removes players only from the pending list.
/wl remove <player...> Removes players from both the whitelist and pending storage.
/wl reload Reloads the config file.
/wl version Shows the installed/latest versions and an update button when available.

Permission

Permission Description
pendingwhitelist.admin Allows access to all PendingWhitelist commands.

Example

/wl add Steve Alex Notch
/wl version

Why Use PendingWhitelist?

Managing a whitelist can be annoying when new players frequently try to join. PendingWhitelist automatically captures those join attempts, so admins can review and approve players without needing usernames to be sent manually.

It is especially useful for SMPs, private community servers, event servers, and any server that keeps whitelist enabled.

Compatibility

  • Paper
  • Purpur
  • Minecraft/Paper API 26.2+
  • Java 25
  • Geyser/Bedrock players

License

Licensed under the MIT License. Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the software, subject to the conditions of the MIT License.