- Документация
- https://modrinth.com/plugin/playtimemanager
PlayTimeManager — серверный плагин для отслеживания активности игроков, отображения накопленного времени и выполнения связанных с ним действий. Изначальный сценарий проекта — автоматически реагировать на достижение временного порога, например участвовать в повышении игрока через LuckPerms.
Проект относится к управлению, хранению данных, служебным инструментам, игровой механике, оптимизации и технологиям. Он устанавливается только на сервер: клиентская сторона не поддерживается, серверная обязательна.
Плагин не ограничивается простым счётчиком времени подключения. В официальном описании перечислены автоматические награды, статистика, рейтинги, временные цели и серии входов.
Подтверждённые сценарии применения:
• повышение после достижения заданного времени;
• выдача привилегий постоянным игрокам;
• показ статистики вовлечённости;
• рейтинг по игровому времени;
• награды за последовательные ежедневные входы;
• использование временных целей в системе прогресса.
Конкретные пороги, команды и награды в предоставленной основе не заданы. Их необходимо определять в конфигурации конкретного сервера.
PlayTimeManager заявлен как трекер активности. Поддержка определения AFK позволяет исключать простой из учитываемого времени, что особенно важно при выдаче рангов и наград.
Администратору следует заранее решить, какой показатель используется в правилах: общее время, активное время, серия входов или иной доступный формат. Точные условия распознавания AFK в основе не раскрыты, поэтому нельзя утверждать, какие действия игрока сбрасывают состояние без проверки рабочих файлов выбранной версии.
Проект создавался для автоматического выполнения задачи после достижения нужного количества времени. В качестве примера названо повышение через LuckPerms; среди сценариев также указаны VIP-награды и продвижение сотрудников.
Безопасная схема внедрения:
• выбрать учитываемый показатель;
• определить понятный временной порог;
• назначить действие;
• исключить нежелательную повторную выдачу;
• проверить результат на тестовом игроке;
• опубликовать правила подсчёта.
Синтаксис действий в фактической основе не приведён, поэтому неподтверждённые команды здесь не добавляются.
Плагин поддерживает динамические таблицы лидеров. Значения времени могут отображаться в годах, месяцах, неделях, днях, часах, минутах, секундах и «днях Minecraft», определённых как двадцатиминутные циклы.
Также заявлены:
• настраиваемые сообщения, форматирование и GUI;
• шестнадцатеричные цвета и прежние стили оформления;
• локализация сообщений для игроков;
• PlaceholderAPI для передачи значений совместимым компонентам.
Наличие настройки не означает, что готовый дизайн под конкретный сервер включён заранее.
Поддерживаются SQLite, PostgreSQL, MySQL и MariaDB. Заявлена миграция между типами баз, а для доступа к данным описаны кэширование и облегчённая работа. Числовых нагрузочных тестов и гарантированных пределов онлайна в основе нет.
Перед сменой хранилища следует:
• создать резервную копию;
• зафиксировать версию плагина;
• проверить доступ к целевой базе;
• выполнить перенос на тестовой копии;
• сравнить несколько записей;
• сохранить исходные данные до завершения проверки.
Структура таблиц и реквизиты подключения в предоставленном материале не описаны.
Подтверждены интеграции с PlaceholderAPI и LuckPerms. Первая предназначена для вывода данных в совместимых интерфейсах, вторая используется в сценариях изменения прав и групп. Также заявлена работа на серверах с online- и offline-режимом аутентификации.
Отдельно отмечена vanish-aware логика, не позволяющая собственным функциям плагина раскрывать скрытого игрока. Конкретный список совместимых vanish-решений не приведён.
Обязательные project dependencies в метаданных не указаны. Это не противоречит интеграциям: они расширяют возможности, но не названы обязательными для базовой загрузки.
Подтверждены платформы Paper и Purpur. Список версий Minecraft охватывает 1.19, все перечисленные ветки 1.19.x и 1.20.x, последовательность 1.21–1.21.11, а также 26.1, 26.1.1, 26.1.2 и 26.2.
Номер в общем перечне подтверждает заявленную совместимость ресурса, но не одинаковый набор функций во всех версиях. После установки или обновления нужно проверять журнал запуска и работу используемых интеграций.
Стандартная процедура выглядит так:
• остановить совместимый Paper- или Purpur-сервер;
• поместить JAR в папку plugins;
• запустить сервер для создания рабочих файлов;
• выбрать способ хранения данных;
• настроить отображение времени и необходимые действия;
• проверить учёт активного и AFK-времени;
• протестировать интеграции до включения наград.
Официальный текст отсылает за командами, разрешениями, placeholders и пошаговыми материалами к отдельному руководству, но их значения в фактической основе не перечислены.
Предоставлены два JAR:
• PlayTimeManager-3.6.5.jar — версия 3.6.5, 7 214 108 байт; SHA-512 fa902c1617625b7e254d12091228dfa922b74b8fb1a5a093dd17ab9c3e942b305a885dff6af5d3bca4c136cb7820b7b84e5fcdeaeef311c4fb604709fc132389; SHA-1 ffea58a901d745e4375f85c3ff7a11117d81eff6;
• PlayTimeManager-3.6.4.jar — версия 3.6.4, 7 195 682 байта; SHA-512 f80e083b5afcfe7798e12e5e6acf26b0e82dbec5069123f650990b392bcd186512725e35e84c291b016d50d77effd3f5d93bad09455012ce9dce2e7449a0a923; SHA-1 a6c362a3fe6a8d32c6632d620283cf32b4cc41d1.
Заявленное автоматическое обновление с сохранением настроек не отменяет резервного копирования JAR, конфигурации и базы перед переходом на новую версию.
PlayTimeManager распространяется по GPL-3.0-or-later. При изменении и распространении следует соблюдать условия этой лицензии.
Клиентский компонент не предусмотрен. Вся логика учёта, хранения и наград работает на сервере. Игроки подключаются обычным клиентом, если иные требования не возникают из состава самого сервера.
JAR получены по официальному HTTPS, локально сверены с опубликованными хешами и прошли статическую проверку структуры и путей. Динамический запуск не выполнялся. Подтверждены целостность экземпляров и базовая статическая проверка, но не работа с конкретной базой, настройками или интеграциями.
Для приёмочной проверки полезно:
• записать исходное время тестового игрока;
• сравнить активную сессию и AFK-период;
• проверить повторный вход;
• убедиться, что скрытый игрок не раскрывается;
• протестировать копирование и восстановление базы;
• проверить одну безопасную награду;
• сверить формат времени в интерфейсе.
Нет. Клиентская сторона не поддерживается, JAR размещается на сервере.
Да. Подтверждены PostgreSQL, MySQL и MariaDB; для локального хранения указана SQLite.
Заявлено исключение простоя из учёта. Конкретные правила определения AFK в основе не раскрыты.
Нет обязательных project dependencies в выбранных метаданных. Эти проекты указаны как интеграции, необходимость которых зависит от сценария.
Нет. Выполнялись загрузка по HTTPS, сверка хешей и статическая проверка архива.
Проект относится к управлению, хранению данных, служебным инструментам, игровой механике, оптимизации и технологиям. Он устанавливается только на сервер: клиентская сторона не поддерживается, серверная обязательна.
Назначение PlayTimeManager
Плагин не ограничивается простым счётчиком времени подключения. В официальном описании перечислены автоматические награды, статистика, рейтинги, временные цели и серии входов.
Подтверждённые сценарии применения:
• повышение после достижения заданного времени;
• выдача привилегий постоянным игрокам;
• показ статистики вовлечённости;
• рейтинг по игровому времени;
• награды за последовательные ежедневные входы;
• использование временных целей в системе прогресса.
Конкретные пороги, команды и награды в предоставленной основе не заданы. Их необходимо определять в конфигурации конкретного сервера.
Скриншоты и внешний вид
Учёт активности и AFK
PlayTimeManager заявлен как трекер активности. Поддержка определения AFK позволяет исключать простой из учитываемого времени, что особенно важно при выдаче рангов и наград.
Администратору следует заранее решить, какой показатель используется в правилах: общее время, активное время, серия входов или иной доступный формат. Точные условия распознавания AFK в основе не раскрыты, поэтому нельзя утверждать, какие действия игрока сбрасывают состояние без проверки рабочих файлов выбранной версии.
Автоматические действия
Проект создавался для автоматического выполнения задачи после достижения нужного количества времени. В качестве примера названо повышение через LuckPerms; среди сценариев также указаны VIP-награды и продвижение сотрудников.
Безопасная схема внедрения:
• выбрать учитываемый показатель;
• определить понятный временной порог;
• назначить действие;
• исключить нежелательную повторную выдачу;
• проверить результат на тестовом игроке;
• опубликовать правила подсчёта.
Синтаксис действий в фактической основе не приведён, поэтому неподтверждённые команды здесь не добавляются.
Рейтинги и форматы времени
Плагин поддерживает динамические таблицы лидеров. Значения времени могут отображаться в годах, месяцах, неделях, днях, часах, минутах, секундах и «днях Minecraft», определённых как двадцатиминутные циклы.
Также заявлены:
• настраиваемые сообщения, форматирование и GUI;
• шестнадцатеричные цвета и прежние стили оформления;
• локализация сообщений для игроков;
• PlaceholderAPI для передачи значений совместимым компонентам.
Наличие настройки не означает, что готовый дизайн под конкретный сервер включён заранее.
Хранение данных и кэширование
Поддерживаются SQLite, PostgreSQL, MySQL и MariaDB. Заявлена миграция между типами баз, а для доступа к данным описаны кэширование и облегчённая работа. Числовых нагрузочных тестов и гарантированных пределов онлайна в основе нет.
Перед сменой хранилища следует:
• создать резервную копию;
• зафиксировать версию плагина;
• проверить доступ к целевой базе;
• выполнить перенос на тестовой копии;
• сравнить несколько записей;
• сохранить исходные данные до завершения проверки.
Структура таблиц и реквизиты подключения в предоставленном материале не описаны.
Интеграции и режимы сервера
Подтверждены интеграции с PlaceholderAPI и LuckPerms. Первая предназначена для вывода данных в совместимых интерфейсах, вторая используется в сценариях изменения прав и групп. Также заявлена работа на серверах с online- и offline-режимом аутентификации.
Отдельно отмечена vanish-aware логика, не позволяющая собственным функциям плагина раскрывать скрытого игрока. Конкретный список совместимых vanish-решений не приведён.
Обязательные project dependencies в метаданных не указаны. Это не противоречит интеграциям: они расширяют возможности, но не названы обязательными для базовой загрузки.
Совместимость
Подтверждены платформы Paper и Purpur. Список версий Minecraft охватывает 1.19, все перечисленные ветки 1.19.x и 1.20.x, последовательность 1.21–1.21.11, а также 26.1, 26.1.1, 26.1.2 и 26.2.
Номер в общем перечне подтверждает заявленную совместимость ресурса, но не одинаковый набор функций во всех версиях. После установки или обновления нужно проверять журнал запуска и работу используемых интеграций.
Установка
Стандартная процедура выглядит так:
• остановить совместимый Paper- или Purpur-сервер;
• поместить JAR в папку plugins;
• запустить сервер для создания рабочих файлов;
• выбрать способ хранения данных;
• настроить отображение времени и необходимые действия;
• проверить учёт активного и AFK-времени;
• протестировать интеграции до включения наград.
Официальный текст отсылает за командами, разрешениями, placeholders и пошаговыми материалами к отдельному руководству, но их значения в фактической основе не перечислены.
Файлы и версии
Предоставлены два JAR:
• PlayTimeManager-3.6.5.jar — версия 3.6.5, 7 214 108 байт; SHA-512 fa902c1617625b7e254d12091228dfa922b74b8fb1a5a093dd17ab9c3e942b305a885dff6af5d3bca4c136cb7820b7b84e5fcdeaeef311c4fb604709fc132389; SHA-1 ffea58a901d745e4375f85c3ff7a11117d81eff6;
• PlayTimeManager-3.6.4.jar — версия 3.6.4, 7 195 682 байта; SHA-512 f80e083b5afcfe7798e12e5e6acf26b0e82dbec5069123f650990b392bcd186512725e35e84c291b016d50d77effd3f5d93bad09455012ce9dce2e7449a0a923; SHA-1 a6c362a3fe6a8d32c6632d620283cf32b4cc41d1.
Заявленное автоматическое обновление с сохранением настроек не отменяет резервного копирования JAR, конфигурации и базы перед переходом на новую версию.
Лицензия и модель сторон
PlayTimeManager распространяется по GPL-3.0-or-later. При изменении и распространении следует соблюдать условия этой лицензии.
Клиентский компонент не предусмотрен. Вся логика учёта, хранения и наград работает на сервере. Игроки подключаются обычным клиентом, если иные требования не возникают из состава самого сервера.
Проверка файлов и ограничения
JAR получены по официальному HTTPS, локально сверены с опубликованными хешами и прошли статическую проверку структуры и путей. Динамический запуск не выполнялся. Подтверждены целостность экземпляров и базовая статическая проверка, но не работа с конкретной базой, настройками или интеграциями.
Для приёмочной проверки полезно:
• записать исходное время тестового игрока;
• сравнить активную сессию и AFK-период;
• проверить повторный вход;
• убедиться, что скрытый игрок не раскрывается;
• протестировать копирование и восстановление базы;
• проверить одну безопасную награду;
• сверить формат времени в интерфейсе.
FAQ
Требуется ли установка на клиент?
Нет. Клиентская сторона не поддерживается, JAR размещается на сервере.
Можно ли использовать внешнюю базу?
Да. Подтверждены PostgreSQL, MySQL и MariaDB; для локального хранения указана SQLite.
Учитывает ли плагин AFK?
Заявлено исключение простоя из учёта. Конкретные правила определения AFK в основе не раскрыты.
Обязательны ли LuckPerms и PlaceholderAPI?
Нет обязательных project dependencies в выбранных метаданных. Эти проекты указаны как интеграции, необходимость которых зависит от сценария.
Проводился ли динамический тест?
Нет. Выполнялись загрузка по HTTPS, сверка хешей и статическая проверка архива.
