Flectone Logo FlectonePulse

/whitelist

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

command whitelist

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

Path localizations → 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

You can add your own reasons, for example
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

Path command.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: false

enable

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

ValueExplanation
WORLD_TYPEThe message will be sent only to players who have the permission flectonepulse.world.type.dimension_name
WORLD_NAMEThe message will be sent only to players who have the permission flectonepulse.world.name.world_folder_name
PROXYThe message will be sent to all players on the server and on the Proxy
SERVERThe message will be sent to all players on the server
PLAYERThe message will be sent only to the sender
any number greater than 0, for example range: 100The 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

ALIASES CAN BE ANYTHING

For example newcommand, newcommand_ru, ban, me etc.

destination

Where the message will be sent

TypeExplanationRequires additional configuration?
ACTION_BARMessage above the player's inventoryYes
BOSS_BARMessage at the top of the screenYes
BRANDMessage in F3No
CHATMessage in chatNo
TEXT_SCREENMessage anywhere on the screenYes
TITLEFull-screen messageYes
SUBTITLEFull-screen message (bottom line)Yes
TAB_HEADERMessage in TAB (top)No
TAB_FOOTERMessage in TAB (bottom)No
TOASTMessage in the top right corner (achievement)Yes

cooldown

Usage delay

sound

Sound playback


🔐 Permissions

Path permission.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

TypeExplanation
TRUEAvailable to any player
FALSEAvailable to no one, must be granted separately (e.g., using LuckPerms)
OPAvailable to server operators
NOT_OPAvailable 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

On this page

Authors of page