Плагин для серверов Майнкрафт на Paper, который учитывает время игроков онлайн, показывает общий рейтинг и выдаёт награды за проведённое на сервере время. Подходит для сервера с прогрессией, экономикой, привилегиями или кейсами: награды могут выполнять команды от консоли либо игрока.
Возможности
- Считает только время, пока игрок находится онлайн, и хранит статистику для игроков, уже заходивших на сервер.
- Открывает меню с профилем: общим временем, временем текущей сессии, доступными наградами, сроком до следующей награды и состоянием загрузки данных.
- Показывает рейтинг игроков в меню и в чате через
/ptempo top; число мест настраивается. - Награды сортируются по нужному времени, разбиваются на страницы и имеют фильтры: все, доступные, полученные и заблокированные. Игрок может отдельно включить скрытие уже полученных наград.
- Для каждой награды задаются идентификатор, необходимое время, предмет-значок, имя, описание, текстура головы,
Custom Model Data, команды, сообщение в чат, заголовок, подзаголовок и сообщение над панелью быстрого доступа. - В командах наград метка
{player}подставляет имя получающего игрока. - Защищает выдачу наград от повторного выполнения: состояние сохраняется до каждой команды, а спорные выдачи администратор может подтвердить, продолжить или сбросить.
- Сохраняет данные в SQLite или MySQL. При временной недоступности базы использует локальный журнал
pending-player-saves.datи восстанавливает неподтверждённые сохранения после подключения. - Защищает меню от перемещения предметов, кликов с Shift, перетаскивания, клавиш панели быстрого доступа, обмена со второй рукой и одновременного получения одной награды.
- Поддерживает головы игроков и наград, а также загрузку скинов через сервисы Mojang с кэшем.
Команды
Игрокам доступны:
/ptempo— открыть главное меню./tempojogado— альтернативная команда главного меню./ptempo top— вывести рейтинг в чат.
Команды администратора:
/ptempo reload— проверить и перезагрузить настройки./ptempo open <player>— открыть меню для игрока онлайн./ptempo holograma setи/ptempo holograma update— установить место и обновить голограмму рейтинга./ptempo npc set,/ptempo npc update,/ptempo npc remove— создать, обновить, переместить или удалить NPC./ptempo tempo add <player> <time>— добавить время./ptempo tempo set <player> <time>— установить общее время./ptempo tempo remove <player> <time>— отнять время./ptempo tempo reset <player>— сбросить время игрока./ptempo recompensa reset <player> <id>— сбросить одну награду; вместо<id>можно указатьallдля всех./ptempo recompensa status <player> <id>— проверить состояние выдачи./ptempo recompensa resolve <player> <id> delivered— подтвердить выдачу./ptempo recompensa resolve <player> <id> retry— продолжить выдачу с сохранённого шага./ptempo recompensa resolve <player> <id> reset— удалить запись о выдаче и позволить получить награду заново.
Время в административных командах указывается, например, как 45s, 30m, 2h, 1h30m, 2d или 1d2h30m45s.
Права
ptempo.use— открыть меню и смотреть рейтинг; доступно всем игрокам.ptempo.admin— управлять временем, наградами, NPC, голограммой и перезагрузкой; по умолчанию у операторов.
Настройка
Основные параметры находятся в config.yml: база данных, рейтинг, сообщения, кэш, скины и интеграции. В menus.yml меняются размеры и заголовки меню, слоты, предметы-заполнители, кнопки, внешний вид наград и позиций рейтинга. Награды настраиваются в recompensas.yml.
Для таблиста, чата, скорборда и других совместимых плагинов доступны заполнители PlaceholderAPI: %ptempo_time%, %ptempo_time_short%, %ptempo_seconds%, %ptempo_ready_rewards%, %ptempo_next_reward%, а также рейтинг вида %ptempo_top_1_name% и %ptempo_top_1_time%.
При смене типа базы, файла SQLite, адреса, порта, имени базы, логина или пароля MySQL требуется перезапуск сервера. Не удаляйте pending-player-saves.dat, пока база недоступна: в этом файле могут находиться ещё не подтверждённые сохранения.
Требования
Работает на серверах Paper и требует Java 21. SQLite и MySQL поддерживаются без отдельных драйверов.
Необязательные интеграции:
- PlaceholderAPI — заполнители статистики для других плагинов.
- DecentHolograms — голограмма с рейтингом.
- Citizens — NPC, открывающий меню по клику.
Команды в наградах, связанные с экономикой, кейсами или правами, требуют, чтобы соответствующий плагин был установлен и настроен на сервере.
