LastStudio Wiki

#Глобальное обновление

#Folia

  • Поддержка Folia. Диапозон поддерживаемых версий: 1.21 - 26.3.
  • Сброс шахты идёт по чанкам: каждая часть выполняется в потоке региона своего чанка (за шаг до 10 000 блоков или 10 мс).
  • Все задачи идут через планировщик библиотеки LLib: таймеры - глобальный, база данные - асинхронно, действия - в потоке игрока, телепорт - teleportAsync.
  • Голограммы создаются и обновляются в потоке региона своей точки.

#Статистика добычи

  • Счёт добытых блоков: всего и по материалам. Приращения копятся в памяти и пишутся в базу пачкой (по умолчанию раз в 5 с, асинхронно). При ошибке возвращаются в очередь, при выключении плагина — последняя синхронная запись.
  • Команды: /lm stats [игрок] [материал], /lm top [материал] [страница]. Права: lastmines.stats, lastmines.stats.others, lastmines.top (stats и top доступны без lastmines.admin).
  • Плейсхолдеры: %lm_top_<N>_name%, %lm_top_<N>_value% (и с материалом), %lm_blocks_total%, %lm_blocks_<материал>%, %lm_rank%, %lm_rank_<материал>%. Те же значения как %lastmines_top_…% / %lastmines_stats_…%. Читают только память, базу не трогают. Пустое место в топе: - и 0.

#База данных

  • Плагин получил поддержку баз данных, для её быстрой работы и меж-серверности.
  • Файл sql.yml: Memory, H2, SQLite, MySQL, MariaDB, PostgreSQL (пул HikariCP, драйверы подгружаются сами). Версия схемы хранится в базе, добавлены индексы для топа. В общей базе нескольких серверов данные суммируются.

#Синтаксис sql.yml файла:

yaml
driver: H2
table_prefix: 'lastmines'

h2:
  name: 'LastMines' # <name>.db

sqlite:
  name: 'LastMines' # <name>.db

mysql:
  host: 'localhost' # IP:PORT - если не указан PORT то будет по умолчанию 3306
  name: 'lastmines'
  user: 'Last'
  pass: 'LastStudio'

mariadb:
  host: 'localhost' # IP:PORT - если не указан PORT то будет по умолчанию 3306
  name: 'lastmines'
  user: 'Last'
  pass: 'LastStudio'

postgresql:
  host: 'localhost' # IP:PORT - если не указан PORT то будет по умолчанию 5432
  name: 'lastmines'
  user: 'Last'
  pass: 'LastStudio'

# Статистика добычи / Mining statistics
stats:
  enable: true
  flush_interval: 5s    # как часто отправлять накопленное в бд
  top_refresh: 45s      # как часто обновлять кэш топа
  top_size: 100         # сколько позиций топа держать в кэше

#Действия

  • Все типы действий берутся из LLib: message, title, actionbar, sound, console, player, vault, playerpoints, give, particle и другие.
  • Строка разбирается один раз при загрузке конфига; ошибка в одной строке не мешает остальным.
  • Новая запись [тип] [когда] [кому] [chance:N] значение:
    • когда: [update], [update:N], а также новые [break] и [break:МАТЕРИАЛ] (при добыче блока)
    • кому: [all], [mine], [radius:N], новое [self] (игроку, сломавшему блок; для [break] — по умолчанию)
    • шанс: [chance:N]
  • Подстановки: %player%, %breaker%, %material%, %mine% и PlaceholderAPI.
  • [console], [broadcast] и *_all выполняются один раз от консоли (раньше - по разу на игрока, а без игроков не выполнялись).
  • Право lastmines.edit.commands для добавления [console] и [player] через меню. Сделано для безопасности.

#Режимы и команда копирования

  • ALL_BLOCKS рабочий режим: Не будет хватать нужных блоков - автошахта сразу же перезаполняется и работает без таймера.
  • Сброс по проценту (reset_percent: N): осталось ≤ N% блоков - шахта сразу перезаполняется. Работает в любом режиме.
  • /lm copy <шахта> <новая> (право lastmines.copy): копирует все настройки автошахты и делает её копию, кроме области, точки телепорта, голограммы и статистики. Копия создаётся остановленной и без области.
  • Шахта может существовать без области (positions отсутствует) - такая шахта не сбрасывается.

#Исправления

  • Версия сервера вида 26.2.build.7-beta не распознавалась (предупреждение и пропуск проверки версии).
  • Проверка обновлений говорила «вышла новая версия», даже если у вас версия новее; ошибка проверки молча терялась.
  • Сообщение «Шахта с ID %mine% уже существует» показывало %mine% вместо названия (/lm create).
Сделано с Last