mcTops - Топы и лидерборды с наградами за место

# Плагин: mcTops (Топы)
# Версия: 1.8+
#
# Описание:
# Плагин добавляет топы на базе PlaceholderAPI.
#
# Зависимости: (плагины без которых этот работать не будет)
# - UtilM ссылка на исходный ресурс
# - PlaceholderAPI https://www.spigotmc.org/resources/placeholderapi.6245/
#
# Опциональные зависимости: (плагины без которых не будет полного функционала, но работать будет)
# - Vault https://www.spigotmc.org/resources/vault.34315/
# - PlayerPoints https://www.spigotmc.org/resources/playerpoints.80745/
#
# Плейсхоледры:
# %mctops_placeholder_tracker_id_N1_leaderboard_position_N2_player_name% - Никнейм игрока в лидерборде на позиции N2 трекера плейсхолдера с ID N1.
# %mctops_placeholder_tracker_id_N1_leaderboard_position_N2_score% - Счёт игрока в лидерборде на позиции N2 трекера плейсхолдера с ID N1.
# %mctops_placeholder_tracker_id_N_leaderboard_time_to_update% - Строка обратного отсчета до обновления лидерборда трекера плейсхолдера с ID N.
# %mctops_placeholder_tracker_id_N_leaderboard_time_to_reward% - Строка обратного отсчета до выдачи награды лидерборда трекера плейсхолдера с ID N.
# %mctops_placeholder_tracker_id_N_leaderboard_last_update% - Строка даты последнего обновления лидерборда трекера плейсхолдера с ID N.
# %mctops_placeholder_tracker_id_N_leaderboard_player_position% - Строка даты последнего обновления лидерборда трекера плейсхолдера с ID N.
#
# Примеры использования плейсхолдеров по умолчанию:
# 1. Пример первых трёх мест топа по балансу Vault.
# &e1. &b%mctops_placeholder_tracker_id_placeholder_tracker_1_leaderboard_position_1_player_name% &7- &e%mctops_placeholder_tracker_id_placeholder_tracker_1_leaderboard_position_1_score%
# &e2. &b%mctops_placeholder_tracker_id_placeholder_tracker_1_leaderboard_position_2_player_name% &7- &e%mctops_placeholder_tracker_id_placeholder_tracker_1_leaderboard_position_2_score%
# &e3. &b%mctops_placeholder_tracker_id_placeholder_tracker_1_leaderboard_position_3_player_name% &7- &e%mctops_placeholder_tracker_id_placeholder_tracker_1_leaderboard_position_3_score%
#
# 2. Пример первых трёх мест топа по PlayerPoints за последний час.
# &e1. &b%mctops_placeholder_tracker_id_placeholder_tracker_2_leaderboard_position_1_player_name% &7- &e%mctops_placeholder_tracker_id_placeholder_tracker_2_leaderboard_position_1_score%
# &e2. &b%mctops_placeholder_tracker_id_placeholder_tracker_2_leaderboard_position_2_player_name% &7- &e%mctops_placeholder_tracker_id_placeholder_tracker_2_leaderboard_position_2_score%
# &e3. &b%mctops_placeholder_tracker_id_placeholder_tracker_2_leaderboard_position_3_player_name% &7- &e%mctops_placeholder_tracker_id_placeholder_tracker_2_leaderboard_position_3_score%

message:
 # Поддерживается вывод сообщений в мультистрочном формате.
 reload_success:
 - "&aПлагин перезагружен!"
 permission_denied: "&cОтказано в доступе."

 help:
 - "&e/mctops reload &7- перезагрузить плагин"
 - "&e/mctops help &7- показать список команд"

permission:
 reload: tag.reload # Разрешение на перезагрузку этого плагина.

# Конфигурация базы данных.
#
# Примечание:
# Раскомментируйте нужный вариант, но закомментируйте все не нужные.
# По умолчаницию раскомментирован "Пример конфигурации если база данных H2 (просто локальный файл).", а
# все остальные закомментированы.
#
# Доступные типы баз данных на данный момент:
# - H2
# - MYSQL
database:
 # Пример конфигурации если база данных H2 (просто локальный файл).
 type: H2

 # Пример конфигурации если база данных это MySQL сервер.
 # type: MYSQL
 # database: "database"
 # host: "127.0.0.1"
 # port: 3306
 # username: "username"
 # password: "password"

# Конфигурация наград.
reward_module:
 # Оставьте секцию пустой 'reward_list: {}' чтобы наград не было.
 reward_list:
 reward_1: # ID награды.
 display_name: "&aНаграда 1" # Название награды.
 command_list: # Команды награды (учитывайте, игрок %player% может быть оффлайн).
 - "minecraft:tell %player% команда 1 награды 1 за позицию %leaderboard_position% со счётом %score%!"
 - "minecraft:tell %player% команда 2 награды 1 за позицию %leaderboard_position% со счётом %score%!"
 reward_2:
 display_name: "&bНаграда 2"
 command_list:
 - "minecraft:tell %player% команда 1 награды 2 за позицию %leaderboard_position% со счётом %score%!"
 - "minecraft:tell %player% команда 2 награды 2 за позицию %leaderboard_position% со счётом %score%!"

placeholder_tracker_module:

 # Маркер этого сервера (уникальная произвольная строка).
 # Например в случае если этот плагин используется на 2-х серверах одновременно, то они оба
 # будут вести запись в 1 базу данных, и чтобы понимать чьи данные чьи и нужен такой маркер.
 # Если он будет повторяться, то представим, что на сервере "A" у игрока баланс $100, а на
 # сервере "B" $500, оба плагина будут поочерёдно перезаписывать это значение и как итог на
 # одном из серверов топ будет показывать что у игрока например $100, а не $500.
 server_name: "server_1"

 # (Сек.) Интервал записи в базу данных из которых будут формироваться лидерборды.
 update_interval_seconds: 30

 placeholder_tracker_list: # Список трекеров плейсхолдеров.
 placeholder_tracker_1: # ID трекера плейсхолдера.

 # Тип трекера.
 #
 # Доступные типы:
 # ALL_TIME - Обычный лидерборд с топами за всё время игры.
 # PERIOD - Например лидерборд за неделю или месяц.
 type: ALL_TIME

 # Плейсхолдер числа из которого будет формироваться лидерборд.
 # В данном примере это баланс Vault https://www.spigotmc.org/resources/vault.34315/
 target_placeholder_string: "%vault_eco_balance%"

 leaderboard_max_positions: 10 # Число позиций в лидерборде.
 leaderboard_player_name_placeholder: "&7пусто" # Никнейм пустого места в лидерборде.
 leaderboard_score_placeholder: "&e0" # Счтёт пустого места в лидерборде.
 leaderboard_update_interval_seconds: 60 # (Сек.) Интервал обновления лидерборда.

 # Конфигурация визуализации плейсхолдера времени до начала сражения.
 leaderboard_time_to_update_formatter:
 string: "&fДо обновления: %formatted_seconds%" # Формат плейсхолдера.

 # Цвет цифр.
 # Полный список цветов можно найти по адресу: https://hub.spigotmc.org/javadocs/spigot/org/bukkit/ChatColor.html.
 number_color: GREEN
 abbreviation_color: WHITE # Цвет аббревиатур (час. мин. сек. и тд.).

 leaderboard_last_update_formatter:
 string: "&fОбновлено: &a%date%" # Формат плейсхолдера.
 date_format: "EEEE, dd MMM yyyy" # Формат времени. Полный список форматов времени можно найти по адресу: https://docs.oracle.com/javase/7/docs/api/java/text/SimpleDateFormat.html.

 leaderboard_reward_interval_seconds: 60 # (Сек.) Интервал выдачи награды.

 # Конфигурация визуализации плейсхолдера времени до начала сражения.
 leaderboard_time_to_reward_formatter:
 string: "&fДо награды: %formatted_seconds%" # Формат плейсхолдера.
 number_color: GOLD
 abbreviation_color: WHITE

 # Конфигурация призовых мест.
 reward_place_module:
 # Оставьте секцию пустой 'reward_place_list: {}' чтобы наград за призовые места не было.
 reward_place_list:
 reward_place_1: # ID призового места.
 leaderboard_position: 1 # Позиция в лидерборде.
 reward_id_list: # Список ID наград из секции 'reward_module.reward_list'.
 - "reward_1"
 message: # Конфигурация сообщений.
 winner: # Конфигурация сообщения о выдаче награды игроку занявшему это 1-ое место.
 reward_display_name_delimiter: "&e, " # Конфигурация разделителя названий наград (если в списке 'reward_id_list' их задано несколько).
 text: "&eИгрок &b%player% &eзанял &61 &eместо в топе по балансу и получил награды: &r%combined_reward_display_name%&r&e!" # Текст сообщения.
 reward_place_2:
 leaderboard_position: 2
 reward_id_list:
 - "reward_2"
 message:
 winner:
 reward_display_name_delimiter: "&e, "
 text: "&eИгрок &b%player% &eзанял &62 &eместо в топе по балансу и получил награды: &r%combined_reward_display_name%&r&e!"

 # Конфигурация сообщений-напоминаний.
 reminder_message_module:
 # Оставьте секцию пустой 'reminder_message_list: {}' чтобы не отправлять сообщения-напоминания.
 reminder_message_list:
 reminder_message_1: # ID сообщения-напоминания.
 text: "&eОсталось всего &b30 &eсек. до определения призовых мест топа по балансу, &6торопись&e!"
 s