Playtime Rewards (Плейтайм ривордс, playtime-ranks)

Мод для Майнкрафт на Fabric для серверов, который превращает время в игре в систему рангов и наград. Он подходит для выживания с друзьями и долгих миров: учитывает активность игроков, выдаёт предметы за достигнутые ступени и может синхронизировать группы с LuckPerms. Мод устанавливается только на сервер — игрокам клиентский мод не нужен.

Возможности

• Считает каждую секунду, проведённую игроком на сервере, и при первом входе переносит уже накопленное игровое время из статистики Майнкрафт.
• Хранит прогресс по UUID, поэтому смена ника не сбрасывает время, ранг и полученные награды.
• Позволяет создать любое число рангов с требуемым временем в секундах, отдельной иконкой, префиксом и набором предметов.
• Выдаёт награды из ванильных и модовых предметов. Если инвентарь заполнен, лишние предметы выпадают рядом с игроком.
• Не помечает награду как полученную до успешной выдачи, не дублирует уже выданные предметы и позволяет повторно получить пропущенные.
• Добавляет меню профиля с текущим и следующим рангом, процентом прогресса, оставшимся временем, местом в таблице лидеров и кнопкой получения наград.
• Добавляет меню рангов, страницы с составом наград и таблицу лидеров. Таблицу можно сортировать по времени, рангу, онлайн-игрокам или алфавиту; в ней остаются и офлайн-игроки.
• Интерфейсы защищены: из их ячеек нельзя забрать предметы или случайно переместить туда вещи из инвентаря.

Как пользоваться

Игроки могут открыть профиль и меню прогресса командами:

• /playtime или /playtime me — личный профиль.
• /playtime text — текстовая сводка вместо меню.
• /playtime ranks — список рангов и наград.
• /playtime top — таблица лидеров в меню.
• /playtime top text — текстовая таблица лидеров.
• /playtime refresh — обновить время, ранг, синхронизацию LuckPerms и сохранённый прогресс.
• /playtime claim — получить заработанные, но ещё не выданные награды.

Операторы могут управлять временем и прогрессом игроков:

• /playtime admin set <player> <time> — задать время.
• /playtime admin add <player> <time> — добавить время.
• /playtime admin remove <player> <time> — отнять время.
• /playtime admin reset <player> — сбросить прогресс и историю полученных наград.
• /playtime admin reload — перезагрузить поддерживаемые настройки.

Для времени подходят значения вроде 3600, 6h, 30m, 2d12h и 1d6h30m.

Настройки

Основной файл находится по пути <world>/config/playtime-rewards/config.json, а данные игроков — в <world>/config/playtime-rewards/players.tsv.

В config.json настраиваются ранги, их время, награды, иконки, заголовки и текст меню. Для предметов используются идентификаторы, например minecraft:diamond или идентификатор предмета из другого мода. У ранга можно указать displayItem: он служит только иконкой в меню и не выдаётся игроку.

Текст интерфейса поддерживает цветовые коды &6, &a, форматирование &l и шестнадцатеричные цвета вида &#fbbf24. В сообщениях доступны подстановки, включая {player}, {playtime}, {rank}, {nextRank}, {remaining}, {progress}, {position}, {page} и {pages}.

Требования и совместимость

Нужны Fabric Loader, Fabric API и Java. Мод работает на стороне сервера.

LuckPerms подключается по желанию: мод создаёт и назначает группы, удаляет только прежние группы времени из собственной настройки и не затрагивает группы персонала, доната или другие сторонние группы. Чтобы префиксы отображались в чате, табе или над ником, понадобится совместимый мод форматирования.

Одна из стандартных наград использует предмет goml:withered_claim_anchor; для неё требуется Get Off My Lawn. Этот предмет можно заменить в настройках на любой другой ванильный или модовый предмет.