MacTime (Мактайм)

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

Возможности

• Просмотр статистики через команду и графическое меню со списком игроков; данные в меню могут обновляться через заданный интервал.
• Сортировка игроков по группам LuckPerms и отображение их префиксов.
• Сохранение еженедельной статистики в файл с сортировкой по алфавиту, времени или группе.
• Хранение данных в SQLite либо MySQL.
• Отправка в Discord Webhook событий входа, выхода, начала и окончания AFK, еженедельной статистики и выгруженных данных игрока.
• Поддержка PlaceholderAPI: %mactime_current%, %mactime_daily%, %mactime_weekly%, %mactime_monthly%, %mactime_yearly%, %mactime_alltime%, %mactime_afktime% и %mactime_lastonline%. Чтобы получить значение другого игрока, добавьте его имя в конец, например %mactime_daily_notch%; суффикс _raw возвращает время в секундах.

Команды

• /ontime — показать свою статистику времени онлайн.
• /ontime <username> — посмотреть статистику указанного игрока.
• /mactime help — открыть справку.
• /mactime gui [groupname:online:offline:other] — открыть меню со статистикой; можно отобрать игроков конкретной группы LuckPerms, только игроков онлайн, офлайн либо бывших участников отслеживаемых групп.
• /mactime reload [config:messages] — перезагрузить config.yml, messages.yml или оба файла.
• /mactime reset <player:group> <groupname:username> — сбросить статистику игрока или группы LuckPerms.
• /mactime export <all:player> [username] — выгрузить статистику игрока или всех отслеживаемых игроков в Webhook Discord.

Права

• mactime.* — все права плагина.
• ontime.track — учитывать время игрока онлайн.
• mactime.admin — доступ к команде /mactime.
• mactime.command.* — доступ ко всем подкомандам /mactime.
• mactime.command.help, mactime.command.reload, mactime.command.export, mactime.command.reset, mactime.command.gui — доступ к соответствующим подкомандам.
• ontime.own — просмотр своей статистики через /ontime.
• ontime.own.* — все показатели собственной статистики; отдельно доступны ontime.own.afk, ontime.own.daily, ontime.own.weekly, ontime.own.monthly, ontime.own.yearly, ontime.own.alltime.
• ontime.others — просмотр статистики другого игрока через /ontime <username>.
• ontime.others.* — все показатели другого игрока; отдельно доступны ontime.others.afk, ontime.others.daily, ontime.others.weekly, ontime.others.monthly, ontime.others.yearly, ontime.others.alltime.

Настройка

Тексты сообщений и цвета меняются в messages.yml, включая HEX-цвета. В config.yml задаются подключение к MySQL, часовой пояс в other.timezone, день и порядок еженедельного сохранения статистики, интервал обновления меню в gui.update-interval и группы LuckPerms в luckperms.whitelisted-groups.

В разделе webhook указываются адрес Webhook Discord и отдельные уведомления о входе, выходе и AFK. Параметр afk-checker.enabled включает учёт времени AFK, а reset.delete-data-on-reset позволяет полностью удалять данные при сбросе. Параметр other.remove-if-no-perm удаляет статистику игрока при следующем входе, если у него больше нет права ontime.track.

Требования

Для учёта AFK нужен EssentialsX. LuckPerms требуется для сортировки по группам и префиксов в меню, PlaceholderAPI — для использования плейсхолдеров. Плагин поддерживает MySQL и Folia.