Timer & Clock

Плагин добавляет в интерфейс сервера (HUD) функционал таймеров и часов, поддерживая как глобальные настройки для всех игроков, так и персонализированные таймеры. Инструмент включает в себя визуальный редактор дизайна с поддержкой градиентов и анимаций, а также систему автоматизации, позволяющую останавливать время при достижении определённых целей или событий.

Функционал таймеров и часов

Плагин позволяет добавить таймер прямо в интерфейс игрока (HUD) для остановки времени или отображения текущего времени (игрового или реального). Администратор имеет полный контроль над таймером, включая кастомизацию дизайна и настройку автоматизированных действий. Ключевая особенность — возможность привязать остановку времени к определённым событиям, например, убийству Эндер-дракона, или автоматически переключить режим игры на зрительский (spectator) после смерти игрока.

Управление и команды

Все команды, за исключением настроек конфигурации, выполняются через префикс /timer для глобального таймера или /ptimer для личного. Глобальный таймер можно возобновить командой /timer resume, а личный таймер игрока — приостановить через /ptimer pause. Для изменения настроек и дизайна используется команда setup, а сброс времени до нуля осуществляется командой reset. Доступ к этим функциям регулируется правами доступа: родительское разрешение mutils.command.timer для глобальных команд и mutils.command.ptimer для персональных.

Создание и обмен дизайнами

Инструмент предоставляет полноценный создатель дизайнов внутри простого графического интерфейса. Пользователи могут создавать отдельные дизайны для состояний «ожидание» и «работа», использовать плейсхолдеры для значений времени, а также настраивать префиксы, суффиксы и правила скрытия для каждого плейсхолдера. Поддерживаются пользовательские анимации, включая градиенты и стилизацию Adventure MiniMessage. Все созданные дизайны сохраняются в отдельном JSON-файле. Лучшие работы можно публиковать в глобальной библиотеке дизайнов для обмена с сообществом (функция недоступна в режиме BETA).

Интеграция API

Плагин реализует публичный API, написанный на Kotlin, который разработчики могут использовать для манипуляций или внедрения логики в таймер. Библиотека доступна на Maven Central, поэтому установка не требует дополнительных репозиториев. Для подключения достаточно добавить зависимость implementation("de.miraculixx:timer-api:1.1.2") в свой проект. Документация API представлена в формате JavaDocs. Подробная информация доступна в официальном репозитории GitHub проекта.

Конфигурация и настройки

Настройки плагина управляются через команды с префиксом /timer config. Доступные действия включают перезагрузку конфигурации (reload), сброс к значениям по умолчанию (reset) и сохранение изменений (save). Также игроки могут переключать язык интерфейса командой language. Эти функции требуют права доступа mutils.command.timer-config. При работе с плагин может взаимодействовать с серверами MUtils.net для проверки версий (обычно при запуске) и доступа к библиотеке дизайнов (только при ручном запросе). В режиме BETA доступ к библиотеке отключён.

Приватность и совместимость

При обмене данными с внешними серверами IP-адрес сервера передаётся, но не сохраняется. Для загрузки или скачивания дизайнов из публичной библиотеки требуется аутентификация аккаунта. Плагин разработан для серверных платформ Paper и Purpur и совместим с версиями игры от 1.20.5 до 26.2. Клиентская версия плагина не поддерживается.