mcChat - Чат по новому

# Плагин: mcChat (Чат)
# Версия: 1.8+
#
# Описание:
# Плагин добавляет конфигурацию чата.
#
# Зависимости: (плагины без которых этот работать не будет)
# - UtilM ссылка на исходный ресурс
#
# Опциональные зависимости: (плагины без которых не будет полного функционала, но работать будет)
# - PlaceholdersAPI https://www.spigotmc.org/resources/placeholderapi.6245/
#
# Регулярные выражения.
# Плагин использует регулярные выражения в качестве инструмента конфигурации.
# Пожалуйста ознакомьтесь с примерами ниже, подобные выражения неоднократно
# использованы в конфигурации по умолчанию.
#
# В данном примере регулярное выражение распространяется на команду и все подкоманды.
#
# Протестировать регулярное выражение онлайн.
# https://regex101.com/
# Выбранные галочки:
# - (FLAVOR) Java 8
# - (FUNCTION) Match
#
# Регулярное выражение "(?i)^/afk(\\s+.*)?$" и его валидность:
# "/afk" = валидно
# "/afk " = валидно
# "/aFk" = валидно
# "/AFK" = валидно
# "/afk argument1" = валидно
# "/afk argument1 argument2 argument3" = валидно
# "afk argument1" = нет
# "/af" = нет
# "/afkargument1" = нет
#
# "(?i)" - Делает нечувствительным к регистру.
# "^" — Указывает на начало строки.
# "/afk" — Буквально соответствует строке /afk.
# "(\\s+.*)?" — Это группа, которая может присутствовать или отсутствовать. Она состоит из:
# "\\s+" — Один или несколько пробелов.
# ".*" — Любое количество (включая ноль) любых символов.
# "?" — Указывает, что вся группа может присутствовать ноль или один раз.
# "$" — Указывает на конец строки.
sample_regular_expression_1: "(?i)^/afk(\\s+.*)?$"

# В данном примере регулярное выражение распространяется только на команду без подкоманд/аргументов.
#
# Протестировать регулярное выражение онлайн.
# https://regex101.com/
# Выбранные галочки:
# - (FLAVOR) Java 8
# - (FUNCTION) Match
#
# Регулярное выражение "(?i)^/kit\\s*$" и его валидность:
# "/kit" = валидно
# "/kit " = валидно
# "/kiT" = валидно
# "/KIT" = валидно
# "/kit argument1" = нет
# "/kit argument1 argument2 argument3" = нет
# "kit argument1" = нет
# "/ki" = нет
# "/kitargument1" = нет
#
# "(?i)" - Делает нечувствительным к регистру.
# "^" — Указывает на начало строки.
# "/kit" — Буквально соответствует строке /kit.
# "\\s*" — 0 и более пробелов.
# "$" — Указывает на конец строки.
sample_regular_expression_2: "(?i)^/kit\\s*$"

message:
 # Поддерживается вывод сообщений в мультистрочном формате.
 reload_success:
 - "&aПлагин перезагружен!"
 permission_denied: "&cОтказано в доступе."
 spy_chat_enabled: "&eШпионский чат &aактивирован&e!"
 spy_chat_disabled: "&eШпионский чат &cвыключен&e!"
 help:
 - '&e/chat reload &7- перезагрузить плагин'
 - '&e/chat help &7- показать список команд'
 - '&e/chat spy &7- включить/выключить шпионский чат'

permission:
 reload: chat.reload # Разрешение на перезагрузку этого плагина.
 spy: chat.spy # Разрешение на включение/выключение шпионского чата.

# Конфигурация автоматического сохранения данных.
auto_save:
 delay: 300 # (Сек.) Интервал сохранения данных.

# Список модулей управления чатом.
#
# Примечание: последовательность объявления модулей важна, в начале следует
# объявить модули на проверки, а в конце модуль на чат (показывает сообщения).
# В противном случае сообщение сначала может быть показано, а потом будет
# написано, что оно не прошло проверку по той или иной причине, хотя показано.
chat_module_list:

 # Пример модуля на невозможность отправки сообщений в чат до
 # достижения игроком указанного проведенного времени в игре.
 newbie_message_delay_module: # ID модуля управления чатом.
 chat_module_type: NEWBIE_MESSAGE_DELAY # Тип модуля.
 bypass_permission: chat.newbie_message_delay_module.bypass # Разрешение на игнорирование работы этого модуля игроком.
 delay_seconds: 300 # (Сек.) Сколько секунд с момента входа игрока в игру на него будет действовать этот модуль?
 message:
 access_denied:
 time_color:
 # Цвет цифр оставшегося времени до прекращения действия "новичкового" ограничения.
 # Используйте цвета версии ядра на котором запускаете плагин (по умолничаю: 1.8.8).
 # Списки всех цветов для каждой версии:
 # https://helpch.at/docs/1.8.8/org/bukkit/ChatColor.html
 # https://helpch.at/docs/x.x.x/org/bukkit/ChatColor.html
 # ...
 number: AQUA
 abbreviation: RED
 text: "&cВоспользоваться чатом можно будет через %delay%"

 # Пример модуля на невозможность использования команд (в виде регулярных выражений) до
 # достижения игроком указанного проведенного времени в игре.
 newbie_command_delay_module:
 chat_module_type: NEWBIE_COMMAND_DELAY
 delay_seconds: 600 # (Сек.) Сколько секунд с момента входа игрока в игру на него будет действовать этот модуль?
 bypass_permission: chat.newbie_command_delay_module.bypass # Разрешение на игнорирование работы этого модуля игроком.
 command_regular_expression_list: # Список команд которые нельзя использовать пока игрок не проведет в игре "delay_seconds" секунд.
 - "(?i)^/spawn(\\s+.*)?$" # Я не понимаю, что это? Пожалуйста посмотрите примеры регулярных выражений вверху этого файла.
 - "(?i)^/afk\\s*$"
 message:
 access_denied:
 time_color:
 number: AQUA
 abbreviation: RED
 text: "&cВоспользоваться этой командой можно будет через %delay%"

 # Пример модуля на вайтлист команд (в виде регулярных выражений).
 # Только команды (в виде регулярных выражений) из этого списка будут разрешены к использованию.
 command_whitelist_module:
 chat_module_type: COMMAND_WHITELIST
 bypass_permission: chat.command_whitelist_module.bypass # Разрешение на игнорирование работы этого модуля игроком.
 command_regular_expression_list: # Список команд которые можно использовать (другие нельзя, тк. это вайтлист).
 - "(?i)^/spawn(\\s+.*)?$" # Я не понимаю, что это? Пожалуйста посмотрите примеры регулярных выражений вверху этого файла.
 - "(?i)^/afk\\s*$"
 message:
 access_denied: "&cЭтой команды нет в списке разрешенных, она запрещена к использованию."

 # Пример модуля на блеклист команд (в виде регулярных выражений).
 # Все команды (в виде регулярных выражений) кроме указанных в списке будут разрешены к использованию.
 command_blacklist_module:
 chat_module_type: COMMAND_BLACKLIST
 bypass_permission: chat.command_blacklist_module.bypass # Разрешение на игнорирование работы этого модуля игроком.
 command_regular_expression_list: # Список регулярных выражений команд которые нельзя использовать (другие можно, тк. это блеклист).

 # В качестве примера конфигурации по умолчанию, устроим пересечение ограничений вайтлиста и блеклиста, доступной останется только команда "/spawn".
 # Я не понимаю, что это? Пожалуйста посмотрите примеры регулярных выражений вверху этого файла.
 - "(?i)^/afk(\\s+.*)?$"

 message:
 access_denied: "&cЭта комнада находится в списке запрещенных, она запрещена к использованию."

 # Пример модуля на задержки выполнения команд (в виде регулярных выражений).
 # Команды (в виде регулярных выражений) из этого списка при повторном выполнении не выполнятся, а напишут время до след. выполнения.
 # Время задержки определяется по умолчанию или разрешением, чем более
 # привелигированное разрешение, тем меньше задержка (так по умолчанию, можно изменить).
 command_delay_module:
 chat_module_type: COMMAND_DELAY
 command_regular_expression_list: # Список регулярных выражений команд на которые будет распространяться задержка.
 - "(?i)^/afk(\\s+.*)?$" # Я не понимаю, что это? Пожалуйста посмотрите примеры регулярных выражений вверху этого файла.
 - "(?i)^/kit\\s*$"

 permission_delay: # Секция конфигурации разрешений-задержек.
 default_delay: 7 # (Сек.) Задержка после которой сработает команда.
 list: # Список разрешений-задержек.
 permission_delay_1:
 permission: chat.command_delay_module.permission_delay_1
 delay: 5 # (Сек.) Задержка после которой сработает команда при наличии разрешения.
 permission_delay_2:
 permission: chat.command_delay_module.permission_delay_2
 delay: 2
 permission_delay_3:
 permission: chat.command_delay_module.permission_delay_3
 delay: 0 # (Сек.) 0 и ниже означает отсутствие задержки при наличии разрешения.
 message:
 access_denied:
 time_color:
 number: AQUA
 abbreviation: RED
 text: "&cНа эту команду действует задержка на выполнение, до след. выполнения осталось %delay%"

 # Пример модуля на индивидуальные задержки выполнения команды (в виде регулярного выражения).
 # Команды (в виде регулярных выражений) из этого списка при повторном выполнении не выполнятся, а напишут время до след. выполнения.
 # Время задержки определяется по умолчанию или разрешением, чем более
 # привелигированное разрешение, тем меньше задержка (так по умолчанию, можно изменить).
 custom_command_delay_module:
 chat_module_type: CUSTOM_COMMAND_DELAY
 custom_command_delay_list: # Список ID команд на которые распространяются индивидуальные задержки.
 custom_command_delay_1: # ID команды на которую распространяется индивидуальная задержка.
 command_regular_expression: "(?i)^/repair(\\s+.*)?$" # Я не понимаю, что это? Пожалуйста посмотрите примеры регулярных выражений вверху этого файла.
 permission_delay: # Секция конфигурации разрешений-задержек.
 default_delay: 7 # (Сек.) Задержка после которой сработает команда.

 # Список разрешений-задержек.
 # Если нужно оставить только основную задержку "default_delay", без индивидуальных разрешений, то
 # закомментируйте или удалите содержимое секции "list" и присвойте ей значение "list: {}" (пустой).
 list:
 permission_delay_1:
 permission: chat.custom_command_delay_module.permission_delay_1
 delay: 5 # (Сек.) Задержка после которой сработает команда при наличии разрешения.
 permission_delay_2:
 permission: chat.custom_command_delay_module.permission_delay_2
 delay: 2
 permission_delay_3:
 permission: chat.custom_command_delay_module.permission_delay_3
 delay: 0 # (Сек.) 0 и ниже означает отсутствие задержки при наличии разрешения.
 custom_command_delay_2:
 command_regular_expression: "(?i)^/call\\s*$"
 permission_delay:
 default_delay: 7
 list:
 permission_delay_1:
 permission: chat.custom_command_delay_module.permission_delay_1
 delay: 5
 permission_delay_2:
 permission: chat.custom_command_delay_module.permission_delay_2
 delay: 2
 permission_delay_3:
 permission: chat.custom_command_delay_module.permission_delay_3
 delay: 0
 message:
 access_denied:
 time_color:
 number: AQUA
 abbreviation: RED
 text: "&cНа эту команду действует &lиндивидуальная&r&c задержка на выполнение, до след. выполнения осталось %delay%"

 # Пример модуля на блокировку сообщений содержащих плохие слова.
 bad_word_module:
 chat_module_type: BAD_WORD

 # Путь до файла/места хранения плохих слов в папке плагина (не "plugins", а "plugins/mcChat/N", где N и есть путь до файла).
 #
 # По умолчанию будет распакован файл по умолчанию который хранит в себе
 # плохие слова в формате, где каждая новая строка это плохое слово, например:
 # плохое слово 1
 # плохое слово 2
 #
 # Файл можно редактировать добавляя или удаляя плохие слова.
 #
 # Примечание:
 # Регистр (верхний нижний не важен) - "Жопа" и "жопа" не важен, дадут один и тот же результат.
 # Наличие пробелов - "Ж о п а" и "жопа" не важно, даст один и тот же результат.
 # Наличие переносов "\r", табуляции "\t" - "жо\rп\tа" и "жопа" не важно, даст один и тот же результат.
 # Наличие кодов цвета (HEX тоже) "жоп &fа" не важно, даст один и тот же результат.
 bad_words_txt_file: "bad_words.txt"

 # Путь до файла/места хранения хороших слов в папке плагина (не "plugins", а "plugins/mcChat/N", где N и есть путь до файла).
 #
 # По умолчанию будет распакован файл по умолчанию который хранит в себе
 # хорошие слова в формате, где каждая новая строка это хорошее слово, например:
 # хорошее слово 1
 # хорошее слово 2
 #
 # Файл можно редактировать добавля