SpeedrunUtils

SpeedrunUtils

Мод для Minecraft на Fabric для управления спидранами со встроенным таймером, механикой слепоты и отслеживанием забегов.

Примечание: Мод всё ещё в разработке и (по большей части) сгенерирован ИИ.

Примечание: Мод предназначен для установки только на сервер, но может быть установлен и на клиент (не тестировалось).

Требования

• Minecraft 1.21.11
• Fabric Loader >= 0.18.4
• Fabric API
• Java 21+

Установка

1. Установи Fabric Loader
2. Установи Fabric API
3. Помести JAR мода в папку mods

Возможности

Ход игры

1. Запуск сервера: Все игроки заходят с эффектом слепоты
2. Начало забега: Любой игрок вводит /startrun, чтобы запустить обратный отсчёт
3. Спидран: Игроки проходят игру, пока идёт таймер
4. Завершение: Таймер автоматически останавливается, когда игрок выходит через портал Края после победы над Ender Dragon

Автоматические функции

• Слепота при входе: Игроки автоматически получают слепоту при входе до начала забега или во время паузы
• Заморозка времени: Время заморожено до начала забега и во время пауз и размораживается при старте/возобновлении забега
• Заморозка игроков: Игроки полностью заморожены на месте (движение и взаимодействия) до начала забега и во время пауз с помощью заморозки на основе пакетов, которая блокирует все действия клиента, включая ломание блоков, установку блоков, атаку и движение
• Отображение таймера: Панель действий показывает прошедшее время внизу экрана, обновляясь 20 раз в секунду (каждый тик)
• Сплиты: Автоматически записывает ключевые вехи, транслирует их в чат и показывает на боковой панели счёта во время забега
• Автоопределение завершения: Забег автоматически завершается, когда Ender Dragon побеждён и игрок телепортируется через портал Края обратно в Верхний мир (после экрана титров)

• Отслеживание забегов: Все забеги записываются в speedruns.txt с:

  • Датой и временем
  • Именами игроков
  • Итоговым временем (в формате ЧЧ:ММ:СС.ммм или ММ:СС.ммм)
  • Статусом завершения
  • Сплитами (когда записаны)

Сплиты

Сплиты записываются автоматически, пока забег RUNNING. Каждый сплит:

• Транслируется всем игрокам как сообщение в чате
• Добавляется на боковую панель счёта под названием Speedrun Splits
• Отображается рядом с таймером как последний сплит на панели действий
• Сохраняется в разделе Splits: в speedruns.txt при сохранении забега

Текущий список сплитов

• First Iron: Получить достижение "Acquire Hardware" (переплавить/получить железный слиток)
• Entered Nether: Первый вход игрока в Nether во время забега
• Entered Nether Fortress: Получить достижение "A Terrible Fortress" (войти в крепость Nether)
• First Blaze Rod: Первый огненный стержень, добытый любым игроком во время забега
• Blaze Rods Done: Общее количество огненных стержней на сервере у всех онлайн-игроков достигает 7
• First Ender Pearl: Первый эндер-жемчуг, добытый любым игроком во время забега
• Ender Pearls Done: Общее количество эндер-жемчугов на сервере у всех онлайн-игроков достигает 14
• First Ender Eye: Первый раз, когда создаётся Око Эндера
• Stronghold Found: Получить достижение "Eye Spy" (войти в крепость)
• Entered End: Первый вход игрока в Край во время забега

Команды

/startrun

• Уровень разрешений: 0 (все игроки)
• Описание: Запускает спидран с 3-секундным обратным отсчётом

• Поведение:

  • Можно выполнить только один раз за спидран (до начала забега)
  • Показывает 3-секундный обратный отсчёт всем игрокам
  • Снимает эффект слепоты со всех игроков
  • Размораживает время
  • Запускает таймер на панели счёта
  • Проигрывает звуковые эффекты для обратного отсчёта и старта

/pauserun

• Уровень прав: 0 (все игроки)
• Описание: Приостанавливает текущий спидран

• Поведение:

  • Останавливает таймер
  • Замораживает время
  • Накладывает слепоту на всех игроков
  • Показывает «Run already paused!», если забег уже приостановлен

/resumerun

• Уровень прав: 0 (все игроки)
• Описание: Возобновляет приостановленный спидран

• Поведение:

  • Продолжает таймер
  • Размораживает время
  • Снимает слепоту со всех игроков
  • Показывает сообщение об ошибке, если забег не приостановлен

/stoprun

• Уровень прав: 0 (все игроки)
• Описание: Останавливает текущий спидран и сбрасывает таймер

• Поведение:

  • Останавливает забег (если он активен)
  • Сбрасывает таймер
  • Размораживает время
  • Снимает слепоту со всех игроков (на случай, если забег был приостановлен)
  • Объявляет: «Run stopped. Timer cleared.»

/newrun

• Уровень прав: 0 (все игроки)
• Описание: Сохраняет текущий забег и готовится к новому спидранy

• Поведение:

  • Останавливает забег (если он активен)
  • Сохраняет данные текущего забега в speedruns.txt в корне сервера
  • Записывает: метку времени, имена игроков, время и статус завершения
  • Сбрасывает состояние забега
  • Замораживает время
  • Накладывает слепоту на всех игроков
  • Уведомляет игроков о перезапуске сервера для регенерации мира