LastStudio Wiki

#Действия

Всё о действиях в автошахтах...

#Синтаксис

yaml
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])

#Шанс

yaml
actions:
  - '[message] [break:DIAMOND_ORE] [chance:10] &bВам повезло!'

[chance:N] — действие сработает в N% случаев.

#Типы действий

Основные типы, доступные в плагине. Полный список — в README библиотеки LLib.

#Message

yaml
actions:
  - '[message] [<событие>] <текст>'

Сообщение игрокам. В этом действии поддерживается \n символ, который перемещает текст в следующую строку. Есть примеры ниже

#ActionBar

yaml
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

yaml
actions:
  - '[title] [<событие>] "<title>\n<subtitle>" <in;stay;keep (default 20;40;20)>'

Title сообщение игрокам

#Sound

yaml
actions:
  - '[sound] [<событие>] <name> [volume (default 1.0)] [pitch (default 1.0)]'

Звук игрокам

#Console и Player

yaml
actions:
  - '[console] [<событие>] <команда>'
  - '[player] [<событие>] <команда>'

Команда от имени консоли или игрока. [console] выполняется один раз от консоли, даже если игроков нет онлайн. Добавление через меню требует права lastmines.edit.commands.

#Vault и PlayerPoints

yaml
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.

#Примеры

#Сообщения до обновления и после

yaml
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%'

#Звуки до обновления и после

yaml
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 внутри шахты и рядом с ней

yaml
actions:
  - '[every:1] [actionbar] [mine] &fДо обновления шахты: &c%time_detail%'
  - '[every:1] [actionbar] [radius:7] &fДо обновления шахты: &c%time_detail%'

#Награда и команда при добыче

yaml
actions:
  - '[vault] [break:DIAMOND_ORE] [chance:10] give 50'
  - '[message] [break:DIAMOND_ORE] [chance:10] &bВам повезло!'
  - '[console] [update] [chance:10] say Шахта %mine% обновилась'
Сделано с Last