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.

Please report any bugs, errors, or feature suggestions on Discord: https://discord.gg/4XUPywnEyE

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.

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

All output messages can be customized in the configuration.

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.

BStats Statistics are obtained through bstats metrics.