ElytraUtils

ElytraUtils

Компаньон-мод для Fabric, который превращает HUD CoordinatesDisplay в полноценную приборную панель полёта на элитрах — индикатор пространственного положения в стиле истребителя, предсказание урона от удара, дальность планирования и предупреждение о прочности в духе «bingo fuel», и всё это выведено из реальной физики полёта Minecraft, а не из прикидок на глаз.

Приборный HUD полёта

Во время планирования в центре экрана появляется индикатор пространственного положения — настоящий HUD, а не текстовая строка:

• Лестница тангажа — ступени набора/пикирования относительно горизонта (с шагом 10°), с зелёными/красными скобками-ориентирами на выведенном идеальном угле подъёма на ракете (-34°) и пороге предупреждения о пикировании (+30°).
• Визир — неподвижный маркер ватерлинии, показывающий, куда реально направлен нос.
• Маркер траектории — небольшой плавающий прицел, показывающий, куда вы на самом деле летите (вектор скорости), независимо от того, куда смотрите. Разрыв между ним и визиром — это ваш угол атаки.
• Индикатор угла атаки — компактная вертикальная шкала, напрямую показывающая угол атаки, с флагом STALL, привязанным к реальному порогу воздушной скорости (~0.35 блока/тик), а не к придуманному углу.
• Шкала азимута — полоса компасного курса в верхней части.
• Шкала воздушной скорости — горизонтальная скорость в блоках/секунду.
• Шкала высоты — барометрическая высота (BALT) на прокручиваемой шкале, с окошком радиовысоты (RALT) под ней, которое показывает «нет захвата» вместо выдуманного числа, когда лучу не от чего отразиться.

Каждая ступень, скобка и порог на индикаторе берутся из той же декомпилированной и симулированной ванильной физики, что и текстовый HUD ниже — если нужны выводы, смотрите agents.md.

Весь индикатор плавно затухает — а не резко обрезается — приближаясь к настраиваемой «высоте иммерсивного HUD», так что он читается как ограниченное стекло настоящего HUD, а не закрашивает весь экран. Масштаб, цвет (с альфой, для прозрачности в стиле яркости HUD) и каждый отдельный элемент независимо настраиваются или отключаются, а индикатор работает независимо от текстового HUD ниже — отключите любой из них, не затрагивая другой.

Приборы также можно придерживать, пока вы действительно не наберёте высоту: Min Radar Altitude скрывает их ниже заданной высоты AGL по рейкасту (радару), чтобы они не засоряли экран прямо при взлёте или посадке. С включённым Sticky Enable, как только вы подниметесь выше этой высоты за полёт, индикатор остаётся включённым, даже если вы снова опуститесь ниже — например, пролетите над верхушками деревьев после набора высоты — пока вы не приземлитесь и не взлетите снова.

Горячие клавиши

Две горячие клавиши, по умолчанию не назначены (назначьте их в Options → Controls → ElytraUtils):

• Toggle Immersive HUD — переключает Show Flight Instruments.
• Toggle Text HUD — переключает Show Elytra Overlay.

Обе просто переключают ту же настройку, которой управляет экран конфигурации — они не меняют, когда индикатору разрешено показываться (по-прежнему ограничено падением в полёте, или наличием элитр с ракетами для текстового HUD). Если нажать одну из них, когда это условие сейчас не выполнено (так что на экране иначе ничего бы не изменилось), затухающее сообщение в центре экрана всё равно это подтвердит: зелёное «... Enabled» или красное «... Disabled», отражая то, в какую сторону оно только что переключилось.

Строка текстового HUD

Во время планирования — или стоя на земле с элитрами и ракетами в руках (до запуска) — к оверлею CoordinatesDisplay добавляются дополнительные строки:

Elytra  -18.4°  ✓ GLIDE  Vy -0.18  H 1.24
  Impact H:2.5❤ V:0.0❤
  Range 342 blocks
  Time to ground ~1:12

Строка полёта

Индикатор status с вычисленными оптимальными углами:

Стрелки градиента (▲ нос вверх / ▼ нос вниз / ● в цель) подсказывают, в какую сторону корректировать к оптимальному углу для этого режима. Те же вычисленные из физики цвета и пороги управляют HUD-прибором полёта выше.

Строка удара

Прогнозируемый урон в сердцах, если ты врежешься во что-то прямо сейчас, с учётом твоих реальных зачарований на броне:

• H — урон от удара в горизонтальную стену (снижается Protection).
• V — урон от вертикального удара о землю (снижается Protection и Feather Falling — Feather Falling корректно не снижает удар о стену).

Дальность и время до земли

Расстояние и время до встречи с землёй при текущем угле планирования, с использованием настроенного режима альтиметра (см. ниже). Оба скрываются, когда ты не снижаешься.

Время до земли рассчитывается точно с двумя фазами, а не наивной линейной экстраполяцией: если твоя elytra сломается от потери прочности раньше, чем ты иначе приземлился бы, оно симулирует реальную физику свободного падения после поломки для оставшейся дистанции, вместо того чтобы делать вид, что скорость планирования сохраняется до самой земли. Когда прочность действительно становится ограничивающим фактором, число мигает красным по тому же таймеру, что и Master Caution — так что отключение баннера Master Caution не лишает тебя предупреждения, оно просто переезжает в эту строку.

Master Caution

Медленно мигающее (безопасное для эпилепсии 1 Гц) предупреждение ELYTRA DESTRUCTION IMMINENT по центру экрана, которое срабатывает, когда твоя elytra сломается от потери прочности до того, как ты достигнешь земли — то есть ты упадёшь насмерть в середине полёта. Это сравнение времени со временем в стиле «bingo fuel», так что его не обмануть всплесками скорости от ракет.

Настройка

Настраивается в игре через ModMenu (опционально) или редактированием config/coordinatesdisplay_elytrautils.json. Экран в игре группирует настройки под заголовками, соответствующими разделам ниже.

Общие

Master Caution

Альтиметр

Привязанная к измерению точка отсчёта — это не просто плоский уровень моря везде:

• Overworld — ванильный уровень моря (63).
• Nether — уровень лавового моря, пока ты ниже потолка из бедрока; как только ты летишь над крышей (Y > 127), точка отсчёта переключается на саму крышу, поскольку лава далеко внизу там не имеет значения.
• End — здесь нет осмысленного «уровня моря» (значение генерации мира — это просто параметр формирования шума, а не поверхность), поэтому отслеживается высота того острова, над которым ты последний раз реально пролетал, а не фиксированное число.

Строки HUD

Полётные приборы

Требования

• Minecraft 1.21.11, Fabric Loader 0.19.2+
• CoordinatesDisplay 19.x
• BoxLib 20.x (собственная зависимость CoordinatesDisplay)
• Fabric API
• ModMenu — опционально, только для экрана настроек в игре

Сборка и деплой для разработки

./gradlew build          # -> build/libs/coordinatesdisplay-elytrautils-fabric-<version>.jar

cp .env.example .env, отредактируйте пути, затем используйте задачу редактора «Build & Deploy to Dev Instance», чтобы собрать и скопировать jar прямо в папку mods/ вашего инстанса PrismLauncher.

Публикация

./scripts/release.sh 1.0.0

Создаёт релиз на GitHub; также публикует на Modrinth/CurseForge, если заданы переменные репозитория MODRINTH_PROJECT_ID / CURSEFORGE_PROJECT_ID.

Создано на основе modrinth-curseforge-repo-template. См. agents.md для архитектуры и соглашений. Настраиваемая «высота иммерсивного HUD», так что это выглядит как ограниченное стекло настоящего HUD, а не закрашивает весь экран. Масштаб, цвет (с альфой, для управления прозрачностью в стиле яркости HUD) и каждый отдельный элемент настраиваются или переключаются независимо, а дисплей работает независимо от текстового HUD ниже — отключите любой из них, не затрагивая другой.

Строка текстового HUD

Во время планирования — или стоя на земле с надетой Elytra и ракетами в руке (перед запуском) — к оверлею CoordinatesDisplay добавляются дополнительные строки:

Elytra  -18.4°  ✓ GLIDE  Vy -0.18  H 1.24
  Impact H:2.5❤ V:0.0❤
  Range 342 blocks
  Time to ground ~1:12

Строка полёта

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

Градиентные стрелки (▲ кабрирование / ▼ пикирование / ● на цели) подсказывают, в какую сторону корректировать к оптимальному углу для этого режима. Те же выведенные из физики цвета и пороги управляют полётным HUD-инструментарием выше.

Строка удара

Прогнозируемый урон в сердцах, если ты ударишься обо что-то прямо сейчас, с учётом твоих реальных зачарований на броне:

• H — урон от удара о горизонтальную стену (снижается Защитой).
• V — урон от вертикального удара о землю (снижается Защитой и Защитой от падения — Защита от падения корректно не снижает удары о стены).

Дистанция и время до земли

Расстояние и время до встречи с землёй при текущем угле планирования, с использованием настроенного режима альтиметра (см. ниже). Оба скрываются, когда ты не снижаешься.

Master Caution

Медленно мигающее (безопасно для эпилепсии, 1 Гц) предупреждение ELYTRA DESTRUCTION IMMINENT по центру экрана, которое срабатывает, когда твоя элитра сломается от потери прочности до того, как ты достигнешь земли — то есть ты упадёшь насмерть в полёте. Это сравнение времени со временем в стиле "bingo fuel", так что его не обмануть всплесками скорости от ускорения ракетами.

Настройка

Настраивается в игре через ModMenu (опционально), или отредактируй config/coordinatesdisplay_elytrautils.json.

Требования

• Minecraft 1.21.11, Fabric Loader 0.19.2+
• CoordinatesDisplay 19.x
• BoxLib 20.x (собственная зависимость CoordinatesDisplay)
• Fabric API
• ModMenu — опционально, только для экрана настройки в игре

Сборка и деплой для разработки

./gradlew build          # -> build/libs/coordinatesdisplay-elytrautils-fabric-<version>.jar

cp .env.example .env, отредактируй пути, затем используй задачу редактора "Build & Deploy to Dev Instance", чтобы собрать и скопировать jar прямо в папку mods/ твоего инстанса PrismLauncher.

Публикация

./scripts/release.sh 1.0.0

Создаёт релиз на GitHub; также публикует на Modrinth/CurseForge, когда заданы переменные репозитория
`MODRINTH_PROJECT_ID` / `CURSEFORGE_PROJECT_ID`.

---

Создано на основе [modrinth-curseforge-repo-template](https://github.com/johnseth97/modrinth-curseforge-repo-template).
См. [`agents.md`](agents.md) для описания архитектуры и соглашений.