mcAirDrop - Аир дропы

# Плагин: mcAirDrop (Воздужные дропы)
# Версия: 1.8+
#
# Описание:
# Плагин добавляет спавн воздушных дропов (сундуков с лутом).
#
# Зависимости: (плагины без которых этот работать не будет)
# - UtilM ссылка на исходный ресурс
# - DecentHolograms https://www.spigotmc.org/resources/decentholograms-1-8-1-19-4-papi-support-no-dependencies.96927 (опционально на выбор)
# - HolographicDisplays https://dev.bukkit.org/projects/holographic-displays (опционально на выбор)
# - WorldEdit https://dev.bukkit.org/projects/worldedit (необходим по умолчанию, не нужен в случае если нет воздушных дропов типа SCHEMATIC)
# - https://dev.bukkit.org/projects/worldguard (необходим по умолчанию, не нужен в случае если нет необходимости создавать регионы с флагами на месте воздушных дропов)
#
# Плейсхоледры:
# %mcairdrop_airdrop_spawner_id_N_display_name% - Название спавнера воздушных дропов, где N это ID такого спавнера.
# %mcairdrop_airdrop_spawner_id_N_time_left_to_spawn% - Время до след. спавна дропа спавнером воздушных дропов, где N это ID такого спавнера. (Конфигурируемый "airdrop_spawner_list.N.time_left_to_spawn_formatter").

message:
 # Поддерживается вывод сообщений в мультистрочном формате.
 reload_success:
 - "&aПлагин перезагружен!"
 permission_denied: "&cОтказано в доступе."
 loot_with_specified_id_does_not_exist: "&cЛута с таким ID не сущетсвует."
 airdrop_spawned: "&r%airdrop_spawner_display_name%&r&e заспавнил воздушный дроп &r%airdrop_display_name%&r&e на координатах X:&b%x%&e, Y:&b%y%&e, Z:&b%z%&e."
 you_cant_build_there: "&cНельзя ставить/ломать блоки на месте появления воздушного дропа."
 there_are_no_airdrops_right_now: "&eСейчас нет ни одного активного воздушного дропа."
 list_of_gps_airdrops: "&b%list_index_number%&e. &eВоздушный дроп: &r%airdrop_display_name%&r&e находится на коордитанатах X:&b%x%&e, Y:&b%y%&e, Z:&b%z%&e."
 there_are_no_airdrop_spawners_right_now: "&cНет ни одного спавнера воздушных дропов, чтобы узнать время до их срабатывания."
 list_of_delay_airdrop_spawners:
 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: YELLOW
 message: "&b%list_index_number%&e. &eСпавнер: &r%airdrop_spawner_display_name%&r&e сбросит воздушный дроп через: %airdrop_spawner_time_left_to_spawn%"
 airdrop_chest_can_not_be_opened_now:
 time_color:
 number: AQUA
 abbreviation: RED
 message: "&cСундук можно будет октрыть через %airdrop_chest_time_left_to_open%"
 airdrop_spawner_with_specified_id_does_not_exist: "&cСпавнера воздушных дропов с таким ID не сущетсвует."

 # Оставьте поле пустым, чтобы не отправлять это сообщение в чат.
 # Например: airdrop_spawner_could_not_spawn_because_online_is_low: ""
 airdrop_spawner_could_not_spawn_because_online_is_low: "&6Спавнер &r%airdrop_spawner_display_name%&r&6 не смог сбросить воздушный дроп, потому что мало игроков (&b%current_online%&6), а нужно как минимум &b%required_online%&6."
 this_command_is_only_available_in_game: "&cЭта команда доступна только в игре."
 performed: "&aВыполнено!"
 help:
 - '&e/airdrop spawner &b(ID спавнера) &erespawn &7- мгновенно вызвать срабатывание спавнера (текущий дроп, если есть будет задеспавнен)'
 - '&e/airdrop delay &7- показать время до след. воздушных дропов'
 - '&e/airdrop gps &7- показать координаты активных воздушных дропов'
 - '&e/airdrop edit loot &b(ID лута) &7- меню редактора лута'
 - '&e/airdrop reload &7- перезагрузить плагин'
 - '&e/airdrop help &7- показать список команд'

permission:
 reload: airdrop.reload # Разрешение на перезагрузку этого плагина.
 delay: airdrop.delay # Разрешение на использование команды "/airdrop delay".
 gps: airdrop.gps # Разрешение на использование команды "/airdrop gps".
 spawner_respawn: airdrop.spawner_respawn # Разрешение на использование команды "/airdrop spawner (ID спавнера) respawn".

# Список типов блоков на которых не должен спавниться воздушный дроп.
# Используйте материалы версии ядра на котором запускаете плагин (по умолничаю: 1.8.8).
# Списки всех материалов для каждой версии:
# https://helpch.at/docs/1.8.8/org/bukkit/Material.html
# https://helpch.at/docs/x.x.x/org/bukkit/Material.html
# ...
disable_spawn_on_block_list:
 - WATER
 - STATIONARY_WATER
 - LAVA
 - STATIONARY_LAVA

# Максимальное число попыток определения места спавна воздушного дропа (сундука с лутом).
# Эта опция предотвращает зависание плагина в бесконечном поиске места для спавна в таких случаях как:
# - пустой мир, не на что поставить сундук
# - радиус спавнера воздушного дропа внутри региона/привата
find_potential_chest_location_max_attempts: 32

# Звук открытия сундука.
# Используйте звуки версии ядра на котором запускаете плагин (по умолничаю: 1.8.8).
# Списки всех звуков для каждой версии:
# https://helpch.at/docs/1.8.8/org/bukkit/Sound.html
# https://helpch.at/docs/x.x.x/org/bukkit/Sound.html
# ...
chest_open_sound:
 sound: BLOCK_CHEST_OPEN
 sound_category: MASTER # 1.12+
 volume: 1.0 # Громкость (от 0.0 до 2.0).
 pitch: 1.0 # Искажение (от 0.0 до 2.0).

# Звук закрытия сундука.
chest_close_sound:
 sound: BLOCK_CHEST_CLOSE
 sound_category: MASTER
 volume: 1.0
 pitch: 1.0

# Список плейсхолдеров в рамках самого плагина (не PAPI).
placeholder:
 is_airdrop_can_be_opened: "&aможно открыть"

lootitem_list: # Список лут-предметов.
 lootitem_1: # ID лут-проекта.
 material: WOOL # Тип материала предмета.
 # Используйте материалы версии ядра на котором запускаете плагин (по умолничаю: 1.8.8).
 # Списки всех материалов для каждой версии:
 # https://helpch.at/docs/1.8.8/org/bukkit/Material.html
 # https://helpch.at/docs/x.x.x/org/bukkit/Material.html
 # ...
 data: 14 # (Опционально) Дата материала, удалите эту строку и дата учитываться не будет.
 min_amount: 1 # Минимальное число в стаке.
 max_amount: 64 # Максимальное число в стаке.
 chance_to_spawn: 100 # (Процентов) Шанс спавна этого предмета от 0 до 100 (включительно) процентов.
 lootitem_2:
 material: IRON_INGOT
 min_amount: 1
 max_amount: 32
 chance_to_spawn: 75
 lootitem_3:
 material: DIAMOND
 min_amount: 1
 max_amount: 16
 chance_to_spawn: 25

loot_list: # Список лутов.
 loot_1: # ID лута.
 lootitem_id_list: # Список ID лут-предметов.
 - lootitem_1
 - lootitem_2
 - lootitem_3

 # (Процентов) Шанс спавна каждого лут-предмета добавленного через внутриигровое меню от 0 до 100 (включительно) процентов.
 #
 # Примечание:
 # Кроме секции "lootitem_id_list" существует возможность добавить спавнящиеся в сундуке воздушного дропа
 # предметы через внутриигровую команду /airdrop edit loot (ID лута), но там нельзя указать шансы спавна.
 # Эта опция устанавливает шанс спавна для каждого такого предмета без лишних сложностей.
 in_game_gui_each_lootitem_chance_to_spawn: 50

 loot_2:
 lootitem_id_list:
 - lootitem_3
 overridden_chance_to_spawn_for_every_item: 100

# Босс-бар оставшегося времени жизни текущего воздушного дропа.
# Если одновременно существует несколько воздушных дропов, будет
# показано несколько босс-баров, кроме случаев когда в этом дропе
# не указан ID босс-бара.
#
# Примечание:
# Работает на версии 1.12 и выше. На версиях ниже ничего не произойдет.
bossbar_list: # Список босс-баров.
 bossbar_1: # ID босс-бара.

 # Цвет полоски.
 # Используйте цвета полоски версии ядра на котором запускаете плагин (по умолничаю: 1.12.2).
 # Списки всех цветов полосок для каждой версии:
 # https://helpch.at/docs/1.12.2/org/bukkit/boss/BarColor.html
 # https://helpch.at/docs/x.x.x/org/bukkit/boss/BarColor.html
 # ...
 barcolor: BLUE

 # Стиль полоски.
 # Используйте цвета полоски версии ядра на котором запускаете плагин (по умолничаю: 1.12.2).
 # Списки всех цветов полосок для каждой версии:
 # https://helpch.at/docs/1.12.2/org/bukkit/boss/BarStyle.html
 # https://helpch.at/docs/x.x.x/org/bukkit/boss/BarStyle.html
 # ...
 barstyle: SOLID

 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: YELLOW

 # Заголовок босс-бара (PAPI и HEX цвета поддерживаются как и везде).
 placeholderable_title: "&eВоз. Дроп: &r%airdrop_display_name% &eМесто: X:&b%x%&e, Y:&b%y%&e, Z:&b%z%&e. Деспавн: %airdrop_time_left_to_live%&e Открыть: %airdrop_time_left_to_open%"

airdrop_chest_list: # Список типов сундков воздушных дропов.
 airdrop_chest_1: # ID сундука воздушного дропа.
 # Тип: DEFAULT
 # Поведение: спавнит обычный сундук который не имеет задержки
 # на открытие и не меняется в зависимости от текущей файзы.
 type: DEFAULT

 airdrop_chest_2:
 # Тип: OPEN_DELAY_AFTER_SPAWN
 # Поведение: спавнит сундук и сразу накладывает на него задержку
 # на открытие, позволяет указать внешний виду блока сундука.
 type: OPEN_DELAY_AFTER_SPAWN

 # (Сек.) Задержка после которой можно будет открыть сундук или сундуки (в случае с .schematic) этого воздушного дропа.
 #
 # Применичание:
 # Это время учитывается как "внутри" времени существования а не добавляется к нему, если
 # время существования воздушного дропа 300 сек., а время через которое его можно будет
 # открыть 10 сек., то он все равно просуществует 300 сек., а первые 10 сек. его будет нельзя открыть.
 time_to_open: 10

 phase: # Фазы сундука этого типа.
 spawned: # Заспавнен.
 block_look: # Внешний вид.
 material: WOOL # Материал блока.
 data: 14 # Дата блока (опционально).
 delayed: # Действует задержка.
 block_look:
 material: WOOL
 data: 14
 openable: # Можно открывать.
 block_look:
 material: CHEST

 airdrop_chest_3:
 # Тип: OPEN_DELAY_AFTER_FIRST_CLICK
 # Поведение: спавнит сундук и накладывает задержку только после первой
 # попытки открыть его, позволяет указать внешний виду блока сундука.
 type: OPEN_DELAY_AFTER_FIRST_CLICK
 time_to_open: 5
 phase:
 spawned:
 block_look:
 material: CHEST
 delayed:
 block_look:
 material: WOOL
 data: 14
 openable:
 block_look:
 material: CHEST

 # Звук первой попытки открытия сундука.
 sound:
 open_delay_started:
 sound: BLOCK_ENCHANTMENT_TABLE_USE
 sound_category: MASTER
 volume: 1.0
 pitch: 1.0

 # Сообщение которое будет получено игроком при первой попытке открытия сундука.
 message:
 open_delay_started: "&dСундук начал пробуждение ожидайте..."

airdrop_addon_list: # Спсиок аддонов воздушных дропов.
 airdrop_addon_1: # ID аддона воздушного дропа.
 # Тип аддона воздушного дропа.
 # METEOR_RAIN - спавнит в радиусе воздушного дропа метеоритный
 # дождь. Заканчивается с деспавном воздушного дропа.
 type: METEOR_RAIN

 # (Блоков) Радиус появления метеоритов по осям XZ.
 radius: 10

 # (Блоков) Минимальная высота появления метеорита относительно высоты места появления воздушного дропа, ось Y.
 min_fireball_spawn_height_increment_relative_to_center_block: 5

 # (Блоков) Максимальная высота появления метеорита относительно высоты места появления воздушного дропа, ось Y.
 max_fireball_spawn_height_increment_relative_to_center_block: 15

 # (Целое число градусов, не ниже 1 и не больше 45)
 # Угол падения метеоритов.
 degrees: 30

 # (Тиков, 20 тиков = 1 сек.) Минимальная задежка до появления след. метеорита.
 # A.
 min_random_spawn_meteor_delay_ticks: 10

 # (Тиков, 20 тиков = 1 сек.) Максимальная задежка до появления след. метеорита.
 # B.
 max_random_spawn_meteor_delay_ticks: 30

 # Пояснение:
 # Временная линия: (задержк