LastStudio Wiki

#База данных

Добавлено в глобальном обновлении 0.5 версии.

База нужна для статистики добычи (команды /lm stats и /lm top, плейсхолдеры %lm_*%). Настройки шахт, действия, голограммы и всё остальное лежат в mines/*.yml и в базе не хранятся.

#Файл sql.yml

yaml
driver: H2               # Memory, H2, SQLite, MySQL, MariaDB, PostgreSQL
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'

stats:
  enable: true
  flush_interval: 5s
  top_refresh: 45s
  top_size: 100

#Driver

yaml
driver: H2

Тип базы. Для одного сервера хватит H2 или SQLite (файл <name>.db в папке плагина). MySQL, MariaDB и PostgreSQL нужны, если несколько серверов должны вести общую статистику. Memory хранит всё только в памяти и после перезапуска стирает. Драйверы подгружаются сами, подключения идут через пул HikariCP.

#Table prefix

yaml
table_prefix: 'lastmines'

Префикс названий таблиц. Удобно, когда в одной базе живут несколько плагинов.

#Что хранится

Плагин сам создаёт три таблицы:

Таблица Поля Что хранит
<prefix>_players uuid, name, total игрок, его последний ник и общее число добытых блоков
<prefix>_blocks uuid, material, amount сколько блоков каждого материала добыл игрок
<prefix>_meta k, v служебные данные: версия схемы (schema)

Для быстрого топа созданы индексы по total и по (material, amount). Версия схемы записана в базе, поэтому будущие обновления смогут менять таблицы без потери данных.

#Как пишутся данные

yaml
stats:
  enable: true
  flush_interval: 5s
  • Каждый добытый блок учитывается только в памяти, база при этом не нагружается.
  • Раз в flush_interval накопленное уходит в базу одной пачкой, асинхронно.
  • Если запись не удалась, приращения возвращаются в очередь и уходят со следующей пачкой.
  • При выключении плагина делается последняя синхронная запись.
  • Данные суммируются: если несколько серверов пишут в одну базу, значения складываются, а не затираются.

#Как читаются данные

yaml
stats:
  top_refresh: 45s
  top_size: 100
  • Топ обновляется раз в top_refresh и хранится в памяти (top_size позиций).
  • Плейсхолдеры %lm_*% и %lastmines_*% читают только память и базу не трогают, поэтому скорборды и табло не создают нагрузки.
  • Пустое место в топе показывается как - и 0.

#Отключение

yaml
stats:
  enable: false

Подключение к базе не создаётся, статистика не ведётся, плейсхолдеры статистики не подставляются. В консоли пишется, что статистика выключена. Если driver указан неверно, статистика тоже выключается, а в консоль выводится ошибка.

#Что считается

В статистику попадают только блоки, добытые игроками. Блоки, которые ставит сам сброс шахты, не считаются. Блоки, которые игрок сам поставил в шахте и сломал обратно, тоже не считаются.

Сделано с Last