WeeklyTime (Викли Тайм)

Плагин для серверов Майнкрафт, который учитывает наигранное время игроков и отправляет статистику администраторам через Telegram-бота. Он подходит для серверов, где нужно смотреть общий рейтинг или время конкретного игрока за выбранный период.

Возможности

• Время сессий хранится в SQLite и сохраняется при выходе игрока, а также через заданный промежуток.
• Бот показывает статистику за текущую неделю, месяц, всё время или произвольный период от 1 до 365 дней.
• Работает в личных чатах, группах и супергруппах Telegram; доступ разрешается всем чатам либо спискам разрешённых и запрещённых чатов.
• Использовать бота могут только Telegram ID, указанные в настройках.
• История привязана к UUID, поэтому сохраняется после смены ника.
• Для трёх первых мест можно включить эмодзи, а большие списки игроков разбиваются на несколько сообщений.
• Есть русский язык: в плагин включён файл messages-ru.yml.

Команды

Команды Telegram-бота:

• /time week — время за текущую неделю.
• /time month — время за текущий месяц.
• /time alltime — время за всё время.
• /time <days> — статистика за указанное число дней.
• /player <name> [days] — время одного игрока.
• /reset [days] — сбросить данные; требует /confirm или /cancel.
• /stats — статистика плагина.
• /reload — перезагрузить конфигурацию.
• /help — список команд.

В игре доступны:

• /weeklytime help
• /weeklytime reload
• /weeklytime stats

Права

• weeklytime.admin — перезагрузка конфигурации и просмотр статистики базы данных; по умолчанию доступно операторам.

Настройка

В plugins/WeeklyTime/config.yml укажите токен в telegram.bot-token и Telegram ID администраторов в telegram.admins. Основные параметры:

• locale — язык сообщений, для русского укажите ru.
• tracking.save-interval-minutes — частота сохранения времени.
• tracking.disabled-worlds — миры, где время не учитывается.
• tracking.timezone — часовой пояс для недельных и месячных периодов.
• tracking.keep-records-days — срок хранения старых записей.
• output — формат времени, минимальное отображаемое время и размер списка в сообщении.

Требования

Работает на Bukkit-серверах, включая Paper, Spigot, Purpur, Pufferfish и Leaves; на Fabric и Quilt — через Banner или CardBoard. Отдельные зависимости не нужны: SQLite и работа с Telegram API уже включены. Совместим с Folia.