TimeManager

TimeManager - серверный плагин для управления временем в Minecraft. Он позволяет отдельно настроить часы каждого мира: ускорить или замедлить сутки, остановить время либо привязать его к реальному времени. Это полезно для RPG-серверов и мини-игр, где общий ванильный цикл дня и ночи не подходит под темп игрового процесса. Игроки могут узнавать время и дату командой /now, а администраторы - задавать расписание команд и правила сна.

Плагин предназначен для серверов на Bukkit API и совместим с Bukkit, Spigot, Paper и Purpur. В описании версии 1.8.2 указана поддержка Minecraft 1.8.8-1.20.4, но сведения о более поздних версиях отличаются: актуальное описание проекта указывает на ветку 2.1.0 и широкий диапазон версий Paper. Перед установкой проверьте, подходит ли выбранный JAR к версии ядра сервера.

Время отдельно для каждого мира

Для каждого мира можно задать начальное время и множитель скорости от 0.0 до 10.0. Нулевое значение замораживает часы, значение меньше 1.0 замедляет течение времени, а большее - ускоряет. Можно установить обычную скорость 1.0 или выбрать режим реального времени (24.0 или realtime) с часовым смещением.

Дневной и ночной циклы настраиваются независимо. Например, день можно оставить обычным, а ночь ускорить, чтобы игроки меньше ждали рассвета. Для RPG это способ задать собственный ритм суток, а в мини-играх - подстроить освещение и продолжительность раундов под правила карты.

При запуске сервера и перезагрузке TimeManager обновляет список миров и синхронизирует таймеры. Режим старта выбирается отдельно: использовать обычную синхронизацию, вернуть время к заданному значению или продолжить с момента, на котором мир остановился перед выключением сервера. Команда /tm resync позволяет повторно синхронизировать один мир или все сразу.

Сон и личное время игрока

Сон можно разрешить, запретить или связать между мирами. Режим linked пригодится, если несколько миров должны вместе переходить к следующему дню после сна. Если мир работает по реальному времени, сон по умолчанию нужно отключить, чтобы игровой цикл не расходился с часами.

Также можно задать отдельное время или смещение для конкретного игрока. Это меняет отображаемое на его клиенте время, не останавливая общий таймер мира. Сбросить настройку можно аргументом reset для личного времени или значением 0 для смещения.

Отображение времени и даты

Команда /now выводит настроенное сообщение в чат, титрах или ActionBar. Формат можно локализовать через lang.yml: при включенной мультиязычности язык сообщения подбирается по локали игрока, если она есть в файле. Для Незера и Края можно задать отдельные тексты. В YAML-файлах поддерживаются шестнадцатеричные цвета.

Плейсхолдеры можно использовать в сообщениях, командах и расписании, а также в книгах, чате и на табличках. При подключении PlaceholderAPI или MVdWPlaceholderAPI их можно выводить и через соответствующий плагин. Названия плейсхолдеров чувствительны к регистру.

Основные плейсхолдеры:

• {tm_player} - имя игрока.
• {tm_world} - название мира.
• {tm_tick} - текущий игровой тик.
• {tm_time12} и {tm_time24} - время в формате 12 или 24 часа.
• {tm_hours12}, {tm_hours24}, {tm_minutes}, {tm_seconds} - часы, минуты и секунды отдельными значениями.
• {tm_ampm} - AM или PM.
• {tm_daypart} - название одной из четырёх частей дня на выбранном языке.
• {tm_currentday} - номер текущего дня.
• {tm_elapseddays} - число прошедших дней.
• {tm_weekday} - номер дня недели от 1 до 7.
• {tm_yearweek} - номер недели года от 1 до 52.
• {tm_week} - число прошедших недель.
• {tm_monthname} - название месяца из lang.yml.
• {tm_dd}, {tm_mm}, {tm_yy}, {tm_yyyy} - день, месяц и год в числовом формате.

В свежей ветке проекта также заявлены сезоны и связанные с ними плейсхолдеры. GUI и сезонная система появились в версии 2.0.0; версия 2.1.0 расширила поддержку старых версий. Доступность этих возможностей зависит от установленной версии плагина.

Расписание команд

TimeManager умеет запускать команды в заданное время. Расписание настраивается в cmds.yml; в командах можно использовать поддерживаемые плейсхолдеры, кроме {tm_player}. Включение и настройка расписания выполняются через useCmds и команды администратора.

Команды администратора

Плагин заменяет ванильную команду /time. Чтобы изменить время мира, используйте /tm set time - например, с игровыми тиками, частью суток или форматом HH:mm:ss. Доступны и привычные варианты вроде day, noon, night и midnight.

Основные команды:

• /tm checkConfig - сводка настроек config.yml и lang.yml.
• /tm checkSql - проверка адреса и доступности порта MySQL, заданных в конфигурации.
• /tm checkTime [all|server|world] - диагностическая информация о времени сервера и мира.
• /tm now [msg|title|actionbar] [player|all|world] - отправка сообщения о времени выбранным игрокам.
• /tm reload [all|config|lang|cmds] - повторная загрузка YAML-файлов и синхронизация таймеров.
• /tm resync [all|world] - синхронизация таймеров.
• /tm set date [today|yyyy-mm-dd] [all|world] - установка даты. Месяцы соответствуют календарным, кроме февраля, который всегда длится 28 дней; год составляет 365 дней.
• /tm set elapsedDays [число] [all|world] - изменение числа прошедших дней. Значение 0 возвращает отсчёт к первому дню.
• /tm set firstStartTime [default|previous|start] [all|world] - выбор поведения таймера при запуске сервера.
• /tm set playerTime [ticks|daypart|HH:mm:ss|reset] [all|player] - установка или сброс личного времени.
• /tm set playerOffset [-23999..23999] [all|player] - смещение времени игрока относительно мира.
• /tm set refreshRate [ticks] - частота обновления эффекта скорости, от 2 до 20 тиков. Значение по умолчанию - 10; слишком частое обновление может увеличить нагрузку на сервер.
• /tm set sleep [true|false|linked] [all|world] - правила сна для миров.
• /tm set speed [0.0..10.0] [all|world] - скорость времени; также поддерживаются 24.0 и realtime.
• /tm set speedDay [0.0..10.0] [all|world] и /tm set speedNight [0.0..10.0] [all|world] - отдельная скорость дня и ночи.
• /tm set start [ticks|daypart|HH:mm:ss|timeShift] [all|world] - время начала мира. Для режима реального времени можно задать смещение, например +1 или -1.
• /tm set sync [true|false] [all|world] - способ коррекции скорости мира относительно серверного времени.
• /tm set multiLang [true|false] - автоматический выбор языка для /now.
• /tm set defLang [lg_LG] - язык по умолчанию, если локаль игрока не найдена или автоматический перевод выключен.
• /tm set debugMode [true|false] - подробные цветные сообщения в консоли для диагностики.
• /tm set update [none|bukkit|curse|spigot|github] - источник проверки обновлений.
• /tm set useCmds [true|false] - включение расписания из cmds.yml.

Команда игрока: /now <msg|title|actionbar> <world>. Разрешениями можно ограничить доступ к команде, выбору формата сообщения и указанию мира. Для администрирования предусмотрено разрешение timemanager.admin; группа timemanager.now.* включает права timemanager.now.cmd, timemanager.now.display и timemanager.now.world.

Настройка и совместимость

Параметры времени меняются командами или вручную в YAML-файлах с последующей перезагрузкой конфигурации. Для проверки используйте /tm checkConfig и /tm checkTime; если меняли параметры миров вручную, выполните перезагрузку или синхронизацию таймеров.

TimeManager решает именно задачу серверного времени и его отображения. Он не требует, чтобы игроки отдельно настраивали часы: сервер задаёт правила, а плагин показывает выбранное время в чате, титрах, ActionBar и поддерживаемых местах с плейсхолдерами. Для старых версий проверьте совместимость конкретного файла плагина с ядром и используемыми API.