/whitelist
Command to enable/disable the whitelist and add players to it

The whitelist can be enabled/disabled temporarily with a reason specified; the server will automatically enable/disable it after the time expires. Players can also be added temporarily.
The command for adding/removing can be used with a name /whitelistplayer add TheFaser or with a uuid /whitelistplayer add cdc5b40e-103a-403b-9f4e-4b58cb02b9f2.
When adding a player who has not yet played on the server, a record will be created in the database with the specified name and uuid. If the server is online-mode=true, the name and uuid will be automatically created correctly. If the server is online-mode=false, the entered value will be used and will be empty, to be updated upon the player's first login. You may receive a warning that the uuid or name has changed on login; this should be ignored
🌍 Localization
Pathlocalizations → language.yml → command.whitelist
whitelist:
empty: "<color:#98FB98>☺ Whitelist is empty"
null_page: "<color:#ff7171><sprite_or:⁉:gui:icon/chat_modified>Page not found"
null_player: "<color:#ff7171><sprite_or:⁉:gui:icon/chat_modified>Player not found"
null_type: "<color:#ff7171><sprite_or:⁉:gui:icon/chat_modified>Invalid type entered"
reasons:
default: "You have been added to the server whitelist"
removed: "You have been removed from the server whitelist"
enabled: "Whitelist is enabled on the server"
disabled: "Whitelist is disabled on the server"
already_add: "<color:#ff7171><sprite_or:⁉:gui:icon/chat_modified>Player is already whitelisted"
already_off: "<color:#ff7171><sprite_or:⁉:gui:icon/chat_modified>Whitelist is already disabled"
already_on: "<color:#ff7171><sprite_or:⁉:gui:icon/chat_modified>Whitelist is already enabled"
already_remove: "<color:#ff7171><sprite_or:⁉:gui:icon/chat_modified>Player is not in the whitelist"
format_add: "<fcolor:1>☰ Player <display_name> has been added to the whitelist <hover:show_text:\"<fcolor:1>ID: <id><br>Date: <date><br>Time: <time><br>Time left: <time_left><br>Moderator: <moderator><br>Reason: <reason>\">[INFO]</hover>"
format_off: "<fcolor:1>☰ Whitelist <fcolor:2>disabled <fcolor:1><hover:show_text:\"<fcolor:1>ID: <id><br>Date: <date><br>Time: <time><br>Time left: <time_left><br>Moderator: <moderator><br>Reason: <reason>\">[DETAILS]</hover>"
format_on: "<fcolor:1>☰ Whitelist <fcolor:2>enabled <fcolor:1><hover:show_text:\"<fcolor:1>ID: <id><br>Date: <date><br>Time: <time><br>Time left: <time_left><br>Moderator: <moderator><br>Reason: <reason>\">[DETAILS]</hover>"
format_remove: "<fcolor:1>☰ Player <display_name> has been removed from the whitelist <fcolor:1><hover:show_text:\"<fcolor:1>ID: <id><br>Date: <date><br>Moderator: <moderator><br>Reason: <reason>\">[INFO]</hover>"
person: "<color:#ff7171>☰ You are not on the server whitelist"
connection_attempt: "<color:#ff7171>☰ Player <display_name>, who is not on the whitelist, attempted to connect"
global:
header: "<fcolor:2>▋ Whitelisted players: <count> <br>"
line: "<hover:show_text:\"<fcolor:1>Remove from whitelist <target>\"><click:run_command:\"<command>\"><color:#ff7171>☒ <target></click></hover> <fcolor:1><hover:show_text:\"<fcolor:1>ID: <id><br>Date: <date><br>Time: <time><br>Moderator: <moderator><br>Reason: <reason>\">[INFO]</hover>"
footer: "<br><fcolor:2>▋ <click:run_command:\"<command> <prev_page>\">←</click> <fcolor:1>Page: <current_page>/<last_page> <fcolor:2><click:run_command:\"<command> <next_page>\">→"
player:
header: "<fcolor:2>▋ Player whitelist records: <count> <br>"
line: "<hover:show_text:\"<fcolor:1>Delete record <target>\"><click:run_command:\"<command>\"><color:#ff7171>☒ <target></click></hover> <fcolor:1><hover:show_text:\"<fcolor:1>ID: <id><br>Date: <date><br>Time: <time><br>Moderator: <moderator><br>Reason: <reason>\">[INFO]</hover>"
footer: "<br><fcolor:2>▋ <click:run_command:\"<command> <prev_page>\">←</click> <fcolor:1>Page: <current_page>/<last_page> <fcolor:2><click:run_command:\"<command> <next_page>\">→"whitelist:
empty: "<color:#98FB98>☺ Белый список пустой"
null_page: "<color:#ff7171><sprite_or:⁉:gui:icon/chat_modified>Страница не найдена"
null_player: "<color:#ff7171><sprite_or:⁉:gui:icon/chat_modified>Игрок не найден"
null_type: "<color:#ff7171><sprite_or:⁉:gui:icon/chat_modified>Тип введён неверно"
reasons:
default: "Ты добавлен в белый список сервера"
removed: "Ты был удалён из белого списка сервера"
enabled: "На сервере включен белый список"
disabled: "На сервере выключен белый список"
already_add: "<color:#ff7171><sprite_or:⁉:gui:icon/chat_modified>Игрок уже в белом списке"
already_off: "<color:#ff7171><sprite_or:⁉:gui:icon/chat_modified>Белый список уже выключен"
already_on: "<color:#ff7171><sprite_or:⁉:gui:icon/chat_modified>Белый список уже включен"
already_remove: "<color:#ff7171><sprite_or:⁉:gui:icon/chat_modified>Игрока нет в белом списке"
format_add: "<fcolor:1>☰ Игрок <display_name> добавлен в белый список <hover:show_text:\"<fcolor:1>Айди: <id><br>Дата: <date><br>Время: <time><br>Осталось: <time_left><br>Модератор: <moderator><br>Причина: <reason>\">[ПОДРОБНЕЕ]</hover>"
format_off: "<fcolor:1>☰ Белый список <fcolor:2>выключен <fcolor:1><hover:show_text:\"<fcolor:1>Айди: <id><br>Дата: <date><br>Время: <time><br>Осталось: <time_left><br>Модератор: <moderator><br>Причина: <reason>\">[ПОДРОБНЕЕ]</hover>"
format_on: "<fcolor:1>☰ Белый список <fcolor:2>включен <fcolor:1><hover:show_text:\"<fcolor:1>Айди: <id><br>Дата: <date><br>Время: <time><br>Осталось: <time_left><br>Модератор: <moderator><br>Причина: <reason>\">[ПОДРОБНЕЕ]</hover>"
format_remove: "<fcolor:1>☰ Игрок <display_name> удалён из белого списка <fcolor:1><hover:show_text:\"<fcolor:1>Айди: <id><br>Дата: <date><br>Модератор: <moderator><br>Причина: <reason>\">[ПОДРОБНЕЕ]</hover>"
person: "<color:#ff7171>☰ Тебя нет в белом списке сервера"
connection_attempt: "<color:#ff7171>☰ Игрок <display_name>, которого нет в белом списке, попытался подключиться"
global:
header: "<fcolor:2>▋ Игроки в белом списке: <count> <br>"
line: "<hover:show_text:\"<fcolor:1>Удалить из белого списка <target>\"><click:run_command:\"<command>\"><color:#ff7171>☒ <target></click></hover> <fcolor:1><hover:show_text:\"<fcolor:1>Айди: <id><br>Дата: <date><br>Время: <time><br>Модератор: <moderator><br>Причина: <reason>\">[ПОДРОБНЕЕ]</hover>"
footer: "<br><fcolor:2>▋ <click:run_command:\"<command> <prev_page>\">←</click> <fcolor:1>Страница: <current_page>/<last_page> <fcolor:2><click:run_command:\"<command> <next_page>\">→"
player:
header: "<fcolor:2>▋ Записи игрока в белом списке: <count> <br>"
line: "<hover:show_text:\"<fcolor:1>Удалить запись <target>\"><click:run_command:\"<command>\"><color:#ff7171>☒ <target></click></hover> <fcolor:1><hover:show_text:\"<fcolor:1>Айди: <id><br>Дата: <date><br>Время: <time><br>Модератор: <moderator><br>Причина: <reason>\">[ПОДРОБНЕЕ]</hover>"
footer: "<br><fcolor:2>▋ <click:run_command:\"<command> <prev_page>\">←</click> <fcolor:1>Страница: <current_page>/<last_page> <fcolor:2><click:run_command:\"<command> <next_page>\">→"empty
Message if no one is on the whitelist
null_page
Message if the entered page does not exist
null_player
Message if the entered player is not found
null_type
Message if the entered type is incorrect
reasons
A list with keys and values, where the key is a word and the value is a specific reason
random_kek: "Random reason"Then if I write /whitelistplayer add Notch 1d random_kek, the reason will be Random reason
If no reason is specified, default will be used
already_add
Message if the entered player is already on the whitelist
already_off
Message if the whitelist is already disabled
already_on
Message if the whitelist is already enabled
already_remove
Message if the entered player is not on the whitelist
format_add
Message when adding a player to the whitelist
format_off
Message when disabling the whitelist
format_on
Message when enabling the whitelist
format_remove
Message when removing a player from the whitelist
person
Message for the player when they try to join the server
connection_attempt
Message for administrators when a player tries to join the server and is not on the whitelist
global
player
⚙️ Setting
Pathcommand.yml → whitelist
whitelist:
enable: true
auto_add: false
auto_add_duration: -1
check_duplicate: true
filter_by_server: true
show_connection_attempts: true
per_page: 4
range: "PLAYER"
sub_command_player: "player"
aliases:
- "whitelist"
destination:
type: "CHAT"
cooldown:
enable: false
sound:
enable: falseenable
Enables or disables the functionality of the module
auto_add
Whether to automatically add players currently on the server to the whitelist
auto_add_duration
How long a player must play to be automatically added to the whitelist. Only works if auto_add: true
check_duplicate
Whether to check if the player is already on the whitelist when adding a new entry. If disabled, the same player can be added to the whitelist multiple times
filter_by_server
If enabled, this moderation will only work on this server. All commands related to this moderation will also be filtered relative to the server value in config.yml
show_connection_attempts
If enabled, administrators will be shown a message about a login attempt by a player not on the whitelist
per_page
The number of components per page
range
How far in blocks the message will be displayed
| Value | Explanation |
|---|---|
WORLD_TYPE | The message will be sent only to players who have the permission flectonepulse.world.type.dimension_name |
WORLD_NAME | The message will be sent only to players who have the permission flectonepulse.world.name.world_folder_name |
PROXY | The message will be sent to all players on the server and on the Proxy |
SERVER | The message will be sent to all players on the server |
PLAYER | The message will be sent only to the sender |
any number greater than 0, for example range: 100 | The message will be sent to players whose distance between them and the sender is less than this number. Players must also be in the same world as the sender |
sub_command_player
The name of the additional command used to interact with a player (it is always appended to the current command name, i.e., it will be /whitelistplayer)
aliases
A list of aliases for using the command
For example newcommand, newcommand_ru, ban, me etc.
destination
Where the message will be sent
| Type | Explanation | Requires additional configuration? |
|---|---|---|
ACTION_BAR | Message above the player's inventory | Yes |
BOSS_BAR | Message at the top of the screen | Yes |
BRAND | Message in F3 | No |
CHAT | Message in chat | No |
TEXT_SCREEN | Message anywhere on the screen | Yes |
TITLE | Full-screen message | Yes |
SUBTITLE | Full-screen message (bottom line) | Yes |
TAB_HEADER | Message in TAB (top) | No |
TAB_FOOTER | Message in TAB (bottom) | No |
TOAST | Message in the top right corner (achievement) | Yes |
cooldown
Usage delay
sound
Sound playback
🔐 Permissions
Pathpermission.yml → command.whitelist
whitelist:
name: "flectonepulse.module.command.whitelist"
type: "OP"
bypass:
name: "flectonepulse.module.command.whitelist.bypass"
type: "OP"
cooldown_bypass:
name: "flectonepulse.module.command.whitelist.cooldown.bypass"
type: "OP"
sound:
name: "flectonepulse.module.command.whitelist.sound"
type: "TRUE"name
Permission name
type
Permission type
| Type | Explanation |
|---|---|
TRUE | Available to any player |
FALSE | Available to no one, must be granted separately (e.g., using LuckPerms) |
OP | Available to server operators |
NOT_OP | Available to NON-operators of the server |
bypass
Permission to bypass the whitelist check
cooldown_bypass
Permission to ignore the cooldown between uses
sound
Permission to use the sound
FlectonePulse