#Действия
Всё о действиях в автошахтах...
#Синтаксис
actions:
- '[тип] [chance:N] <...>'
Теги «когда» ([update], [update:N], [break], [break:МАТЕРИАЛ], [every:N]) и «кому» ([all], [mine], [radius:N], [self]) можно ставить в любом месте строки. [chance:N] — только сразу после [тип].
#Где используются
Раздел actions: в файле шахты mines/<название>.yml. Также действия можно добавлять и удалять в меню настройки шахты (раздел «Действия»). Добавлять [console] и [player] через меню может только игрок с правом lastmines.edit.commands.
#Описание
Сообщения, actionbar, title, звуки, команды, деньги и другие действия, которые плагин выполняет при сбросе шахты, до сброса, при добыче блока или постоянно каждые N секунд - без единой строчки кода, всё настраивается в конфиге. Все типы действий берутся из библиотеки LLib. Строка разбирается один раз при загрузке конфига, ошибка в одной строке не мешает остальным.
#Когда выполняется действие
| Тег | Когда срабатывает |
|---|---|
[update] |
после сброса шахты |
[update:N] |
за N секунд до сброса |
[break] |
при добыче любого блока в шахте |
[break:МАТЕРИАЛ] |
при добыче указанного блока, например [break:DIAMOND_ORE] |
[every:N] |
постоянно, каждые N секунд |
#Кому выполняется действие
| Тег | Кому |
|---|---|
[all] |
всем игрокам онлайн (по умолчанию) |
[mine] |
игрокам внутри шахты |
[radius:N] |
игрокам в N блоках от границы шахты (внутри шахты тоже) |
[self] |
игроку, сломавшему блок (по умолчанию для [break]) |
#Шанс
actions:
- '[message] [break:DIAMOND_ORE] [chance:10] &bВам повезло!'
[chance:N] — действие сработает в N% случаев.
#Типы действий
Основные типы, доступные в плагине. Полный список — в README библиотеки LLib.
#Message
actions:
- '[message] [<событие>] <текст>'
Сообщение игрокам. В этом действии поддерживается \n символ, который перемещает текст в следующую строку. Есть примеры ниже
#ActionBar
actions:
- '[actionbar] [<событие>] <текст>'
- '[every:N] [actionbar] [<кому>] <текст>'
Actionbar сообщение игрокам. Чтобы текст в actionbar обновлялся и всегда отображался, используйте [every:N]: действие повторяется каждые N секунд. Например, [every:1] [actionbar] [mine] ... обновляет текст каждую секунду у игроков внутри шахты, а [every:1] [actionbar] [radius:7] ... — у игроков в 7 блоках от её границы.
Старая запись [actionbar] <секунды> <true/false> <текст> продолжает работать: true повторяет действие каждые N секунд, false показывает его N секунд. В такой записи тег [radius:N] стоит сразу после типа, а [chance:N] и [update:N] не поддерживаются.
#Title
actions:
- '[title] [<событие>] "<title>\n<subtitle>" <in;stay;keep (default 20;40;20)>'
Title сообщение игрокам
#Sound
actions:
- '[sound] [<событие>] <name> [volume (default 1.0)] [pitch (default 1.0)]'
Звук игрокам
#Console и Player
actions:
- '[console] [<событие>] <команда>'
- '[player] [<событие>] <команда>'
Команда от имени консоли или игрока. [console] выполняется один раз от консоли, даже если игроков нет онлайн. Добавление через меню требует права lastmines.edit.commands.
#Vault и PlayerPoints
actions:
- '[vault] [break:DIAMOND_ORE] give 50'
- '[playerpoints] [break] give 1'
Начиная с 0.5 версии в плагине доступны валюты из популярных плагинов Vault и PlayerPoints: give - выдать, take - забрать, set - установить. Работают, только если установлен соответствующий плагин. Если у игрока не хватает денег, take не выполняется.
#Подстановки
%player%, %breaker% (кто сломал блок), %material%, %mine%, {BLOCKS_LEFT}, {BLOCKS_MAX}, %time%, %time_detail%, %rarity_current% (или %rarity:this%), %rarity_next% (или %rarity:next%), а также любые плейсхолдеры PlaceholderAPI.
#Примеры
#Сообщения до обновления и после
actions:
- '[message] [update:15] &fАвтоШахта обновится через 15 секунд'
- '[message] [update:10] &fАвтоШахта обновится через 10 секунд'
- '[message] [update:5] &fАвтоШахта обновится через 5 секунд'
- '[message] [update:3] &fАвтоШахта обновится через 3 секунды'
- '[message] [update:2] &fАвтоШахта обновится через 2 секунды'
- '[message] [update:1] &fАвтоШахта обновится через 1 секунду'
- '[message] [update] &fАвтоШахта обновилась!'
- '[message] [update] &f \n&fТекущая редкость: %rarity:this%\n&fСледующая редкость: %rarity:next%'
#Звуки до обновления и после
actions:
- '[sound] [update:15] ui.button.click 0.8 1'
- '[sound] [update:10] ui.button.click 0.8 1.0'
- '[sound] [update:5] ui.button.click 0.8 1.0'
- '[sound] [update:3] ui.button.click 0.8 1.0'
- '[sound] [update:2] ui.button.click 0.8 1.0'
- '[sound] [update:1] ui.button.click 0.8 1.0'
- '[sound] [update] entity.villager.yes 0.8 0.5'
#Таймер в actionbar внутри шахты и рядом с ней
actions:
- '[every:1] [actionbar] [mine] &fДо обновления шахты: &c%time_detail%'
- '[every:1] [actionbar] [radius:7] &fДо обновления шахты: &c%time_detail%'
#Награда и команда при добыче
actions:
- '[vault] [break:DIAMOND_ORE] [chance:10] give 50'
- '[message] [break:DIAMOND_ORE] [chance:10] &bВам повезло!'
- '[console] [update] [chance:10] say Шахта %mine% обновилась'