About
This is a plugin for a minecraft server. It allows you to add players for a certain time or permanently.
The plugin is developed and tested for Paper and Folia 1.20.x-1.21.x. It also supports forks of Paper and Folia.
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.
Feedback
Please report any bugs, errors, or feature suggestions on Discord: https://discord.gg/4XUPywnEyE
Commands and Permissions
| Command |
Permission |
| /whitelist add nickname |
whitelistbytime.add, wlbytime.add |
| /whitelist remove [nickname] |
whitelistbytime.remove, wlbytime.remove |
| /whitelist check [nickname] |
whitelistbytime.check, wlbytime.check |
| /whitelist checkme |
whitelistbytime.checkme, wlbytime.checkme |
| /whitelist time set/add/remove [nickname] [time] |
whitelistbytime.time, wlbytime.time |
| /whitelist getall (page) |
whitelistbytime.getall, wlbytime.getall |
| /whitelist freeze [nickname] [time] |
whitelistbytime.freeze, wlbytime.freeze |
| /whitelist unfreeze [nickname] |
whitelistbytime.unfreeze, wlbytime.unfreeze |
| /whitelist reload |
whitelistbytime.reload, wlbytime.reload |
| /whitelist on/off/status |
whitelistbytime.toggle, wlbytime.toggle |
Each subcommand can have multiple permissions. If any permission matches, access is granted. You can change these lists in commands.yml.
Notes:
[nickname] - required argument.(page) - list page number; defaults to 1 if not specified.(time) - the duration for which the player will be whitelisted.
Example: 2d 3h 10m.
Leave empty to whitelist permanently.
Placeholders
All output messages can be customized in the configuration.
%wlbytime_in_whitelist% - Indicates if a player is in the whitelist.%wlbytime_time_left% - Time remaining in the whitelist.
FAQ
Why is the plugin file size large?
It includes libraries such as ORMLite (database), Caffeine (cache), bStats (metrics), and Elytrium-Serializer (config handling).
I have an issue or a suggestion. Where should I report it?
Open an issue in this repository with a detailed description. Any feedback is welcome!
Will there be support for BungeeCord/Velocity?
No, the plugin is being developed exclusively for Paper and Folia.
Stats
Statistics are obtained through bstats metrics.
