#База данных
Добавлено в глобальном обновлении 0.5 версии.
База нужна для статистики добычи (команды /lm stats и /lm top, плейсхолдеры %lm_*%). Настройки шахт, действия, голограммы и всё остальное лежат в mines/*.yml и в базе не хранятся.
#Файл sql.yml
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
driver: H2
Тип базы. Для одного сервера хватит H2 или SQLite (файл <name>.db в папке плагина). MySQL, MariaDB и PostgreSQL нужны, если несколько серверов должны вести общую статистику. Memory хранит всё только в памяти и после перезапуска стирает. Драйверы подгружаются сами, подключения идут через пул HikariCP.
#Table prefix
table_prefix: 'lastmines'
Префикс названий таблиц. Удобно, когда в одной базе живут несколько плагинов.
#Что хранится
Плагин сам создаёт три таблицы:
| Таблица | Поля | Что хранит |
|---|---|---|
<prefix>_players |
uuid, name, total |
игрок, его последний ник и общее число добытых блоков |
<prefix>_blocks |
uuid, material, amount |
сколько блоков каждого материала добыл игрок |
<prefix>_meta |
k, v |
служебные данные: версия схемы (schema) |
Для быстрого топа созданы индексы по total и по (material, amount). Версия схемы записана в базе, поэтому будущие обновления смогут менять таблицы без потери данных.
#Как пишутся данные
stats:
enable: true
flush_interval: 5s
- Каждый добытый блок учитывается только в памяти, база при этом не нагружается.
- Раз в
flush_intervalнакопленное уходит в базу одной пачкой, асинхронно. - Если запись не удалась, приращения возвращаются в очередь и уходят со следующей пачкой.
- При выключении плагина делается последняя синхронная запись.
- Данные суммируются: если несколько серверов пишут в одну базу, значения складываются, а не затираются.
#Как читаются данные
stats:
top_refresh: 45s
top_size: 100
- Топ обновляется раз в
top_refreshи хранится в памяти (top_sizeпозиций). - Плейсхолдеры
%lm_*%и%lastmines_*%читают только память и базу не трогают, поэтому скорборды и табло не создают нагрузки. - Пустое место в топе показывается как
-и0.
#Отключение
stats:
enable: false
Подключение к базе не создаётся, статистика не ведётся, плейсхолдеры статистики не подставляются. В консоли пишется, что статистика выключена. Если driver указан неверно, статистика тоже выключается, а в консоль выводится ошибка.
#Что считается
В статистику попадают только блоки, добытые игроками. Блоки, которые ставит сам сброс шахты, не считаются. Блоки, которые игрок сам поставил в шахте и сломал обратно, тоже не считаются.