Temporal API для Minecraft: полное руководство по библиотеке
Temporal API — это библиотечный мод, который сам по себе не добавляет игроку ничего полезного в инвентарь или мир. Его задача другая: он служит фундаментом для других дополнений, связанных с механикой TARDIS. Если вы разработчик модов или просто любите ставить комплексные сборки с путешествиями во времени, этот мод станет незаметным, но крайне важным звеном в вашей цепочке.
Проще говоря, Temporal API для Minecraft — это набор инструментов, который позволяет другим модам взаимодействовать с TARDIS: регистрировать события, добавлять свои предметы в слоты консоли и управлять логикой полёта. Без него многие продвинутые дополнения просто не запустятся или потеряют часть функционала.
Что именно даёт Temporal API
Мод добавляет две конфигурации, которые могут пригодиться как игрокам, так и создателям модов. Первая — TARDIS base Speed — управляет базовой скоростью в блоках в секунду. Вторая — Hotbar Manual — клиентская настройка: если её включить, игра будет искать мануал во всём хотбаре, а не только в руках. Это мелочь, но она заметно упрощает управление, когда у вас забит инвентарь.
Кроме конфигов, Temporal API добавляет два тега предметов. Тег Sonic предназначен для кастомных предметов, которые можно вставить в Sonic Port. Важный нюанс: чтобы ваш предмет реально что-то делал, нужно использовать SonicPutEvent. Из коробки поддерживаются Temporal Additions (Data Drive) и ASEOHA (Fourteenth's Sonic Screwdriver). Тег Manual управляет тем, какие предметы могут отображать названия кнопок управления. Здесь тоже нативная поддержка Temporal Additions и ASEOHA.
Триггеры достижений
Для любителей коллекционировать ачивки предусмотрены три триггера. Takeoff срабатывает при взлёте и передаёт параметр dimension — измерение, откуда улетела TARDIS. Land срабатывает при посадке и передаёт dimension и crashed — булево значение, показывающее, было ли крушение. FlightEvent передаёт flight_event (реестровый ключ события полёта) и success — булево значение успеха.
События для разработчиков
Основная ценность Temporal API раскрывается в событиях. Реализованы Forge Events, которые делятся на несколько групп.
- ComponentEvent: ComponentChanged — срабатывает, когда игрок меняет предмет в слоте двигателя.
- ControlEvent: ControlHitEvent — когда игрок использует или нажимает кнопку на консоли TARDIS; можно отменить взаимодействие. SonicPutEvent — когда предмет вставляется в Sonic Port; отменяется. SonicTakeEvent — когда предмет забирают из порта; можно запретить удаление.
- FlightEventEvent: StartFlightEvent — при применении случайного события полёта; можно отменить. SuccessFlightEvent и FailFlightEvent — при успешном или провальном завершении события. MinigameStartEvent — когда предмет помещён в слот двигателя и вот-вот запустится мини-игра с проводами; можно отменить.
- TardisEvent: TakeoffEvent и LandEvent — до выполнения кода взлёта и посадки, оба можно отменить. SpeedCalculationEvent — после расчёта скорости в блоках за тик, отменить нельзя. FuelUseCalculationEvent — после расчёта расхода топлива в AU за тик, отменить нельзя. EngineFillEvent — прямо перед получением случайных Leaky Capacitors, можно отменить.
Все эти события открывают огромный простор для кастомизации. Хотите, чтобы ваша TARDIS не могла взлететь при определённых условиях? Отменяйте TakeoffEvent. Нужно добавить свою мини-игру вместо стандартной? Перехватывайте MinigameStartEvent.
Совместимость версий и загрузчик
Temporal API распространяется для загрузчика Forge. Мод ориентирован на версии Minecraft, где активно развиваются TARDIS-дополнения, — в первую очередь это ветки 1.16.5 и 1.18.2, а также более свежие сборки, если автор обновил зависимости. Перед установкой всегда сверяйтесь с описанием конкретной версии: библиотека должна соответствовать и версии игры, и версии основного мода TARDIS.
Если вы не хотите вручную разбираться с зависимостями, обратите внимание на лаунчер foxygame.net: в его каталоге дополнений Temporal API устанавливается в один клик вместе с нужной версией Forge. Лаунчер сам подбирает совместимые сборки и обновляет Temporal API автоматически, так что вам не придётся искать файлы по сторонним сайтам.
Как установить Temporal API
Установка стандартная для библиотечных модов. Сначала убедитесь, что у вас стоит Forge нужной версии. Затем скачайте Temporal API — файл с расширением .jar — и поместите его в папку mods вашего профиля Minecraft. Не забудьте также поставить основной мод TARDIS и те дополнения, которые зависят от этой библиотеки.
После запуска игры проверьте, что мод загрузился: он не появится в творческом инвентаре, но будет виден в списке модов. Если что-то не работает, чаще всего причина в несовпадении версий Forge или отсутствии обязательных зависимостей.
Итог
Temporal API — это типичный «невидимый» мод: игрок его не замечает, но без него рушится половина функционала TARDIS-дополнений. Он даёт разработчикам события, теги и конфиги, а игрокам — стабильную работу любимых сборок. Если вы собираете серьёзный модпак про путешествия во времени, скачать Temporal API стоит в первую очередь, ещё до установки самих дополнений.