About WhitelistByTime [1.21.x]
From SpigotMCAdd players to the whitelist for either a temporary period or indefinitely
This plugin is for Minecraft servers, allowing you to add players to the whitelist either permanently or temporarily.
Features:
- Fully customizable.
- Supports MiniMessage.
- Compatible with any SQL database.
- Case-sensitive nickname support.
- Player freezing feature.
- PlaceholderAPI (PAPI) support.
- Lightweight: minimal load on the main thread.
- Multi-server support: utilizes SQL transactions.
- Safe: the code is extensively covered by automated tests.
- UUID support: stores UUIDs in online/floodgate (GeyserMC) modes to handle nickname changes.
Placeholders:
All output can be configured in the config
%wlbytime_in_whitelist% - In whitelist or not
%wlbytime_time_left% - How much is left in whitelist
Commands and Permissions:
/whitelist add [nickname] (time) - wlbytime.add
/whitelist remove [nickname] - wlbytime.remove
/whitelist check [nickname] - wlbytime.check
/whitelist checkme - wlbytime.checkme
/whitelist time set/add/remove [nickname] [time] - wlbytime.time
/whitelist getall - wlbytime.getall
/whitelist freeze [nickname] [time] - wlbytime.freeze
/whitelist unfreeze [nickname] - wlbytime.unfreeze
/whitelist reload - wlbytime.reload
/whitelist on/off/status - wlbytime.toggle
Permissions can be configured in the commands.yml config!
(time) - time for which the player will be added to the whitelist
Example: 2d 3h 10m
Leave this value empty if you want to add player forever
If you find a bug or encounter a problem, please let me know by creating a issue on github
Statistics
Highlights
From source dataGame versions
Supports 3 Minecraft versions, the newest being 1.21.
Loaders
Runs on Spigot and Paper.
Footprint
Rated a light load on a server.
WhitelistByTime [1.21.x] on Nxeon
From our catalogue- One-click install
- Supported on Nxeon Minecraft servers, for Paper servers. We download it from SpigotMC, place it, and restart the server.
- Server side
- Required on the server
- Server type needed
- Spigot, Paper
- Server load
- light
- Smallest plan we suggest
- Minecraft — 1.5 GB (2 GB RAM). This follows our own load rating above, not a benchmark.
- Latest build
- 2.4.0, released 2026-02-10
Game versions by loader
| Loader | Game versions | Newest |
|---|---|---|
| Paper | 1.20 to 1.21 (3 versions) | 1.21 |
| Spigot | 1.20 to 1.21 (3 versions) | 1.21 |
From 10 recorded builds of WhitelistByTime [1.21.x].
Recent builds
| Build | Released | Game versions | Loaders |
|---|---|---|---|
| 2.4.0 | 2026-02-10 | 1.20 to 1.21 (3 versions) | Spigot, Paper |
| 2.3.0 | 2025-07-06 | n/a | Spigot, Paper |
| 2.2.0 | 2025-04-10 | n/a | Spigot, Paper |
| 2.1.0 | 2025-02-22 | n/a | Spigot, Paper |
| 2.0.1 | 2025-01-28 | n/a | Spigot, Paper |
| 2.0.0 | 2025-01-26 | n/a | Spigot, Paper |
Run WhitelistByTime [1.21.x] on a Minecraft server
Pick a server or deploy a new one above; it is installed in one click.
What kind of mod it is
From the catalogAdmin & protection
Permissions, moderation, anti-cheat and land protection for the people running the server.
Runs on your server
From source side supportSpigotMC lists WhitelistByTime [1.21.x] as required on the server. Check its SpigotMC page to see whether players need it too.
Compatibility
- Game
- Minecraft
- Loaders
- SpigotPaper
- Runs on
- Serverrequired on the server
- Game versions
- 1.21 and 2 earlier
- Requires
- One-click install needs a Paper server.
Verified at the source
- ✓SpigotMCOfficial listing, checked 2026-10-16Open ↗
- ✓AuthorNightMirror, as published on SpigotMC
- ✓LicenseNot published by the sourceFree










