HMI Item Positioner - позиционер предметов

HMI Item Positioner - utility-ресурспак для Minecraft Java, предназначенный для настройки предметов в связке с Hold My Items. Он показывает редактор прямо в игре и позволяет подбирать координаты, поворот, режим отображения руки и параметры частиц без бесконечного перебора значений вручную.

Проект особенно полезен авторам HMI-совместимых ресурспаков. Вместо того чтобы менять числа в скрипте, перезапускать мир и снова проверять результат, можно сразу двигать предмет по осям X, Y и Z, переключать режимы редактора и переносить готовые значения в HMI-скрипт.

Что делает HMI Item Positioner

Ресурспак добавляет игровой редактор для нескольких типов объектов:

• предмета;
• руки игрока;
• руки в относительном режиме;
• частицы;
• pivot point, то есть точки вращения объекта.

Позиционирование выполняется прямо во время игры. Это заметно ускоряет настройку кастомных моделей, предметов в руке и визуальных эффектов, которые работают через Hold My Items. Сам Minecraft при этом не получает новые блоки, предметы или механики выживания: HMI Item Positioner создан именно как инструмент для визуальной настройки.

Горячие клавиши по умолчанию

Клавиши можно изменить в файле assets/minecraft/holdmyitems/item_addon.lua внутри ресурспака. По умолчанию используются такие команды:

• Y, H - перемещение по оси X;
• U, J - перемещение по оси Y;
• I, K - перемещение по оси Z;
• R - переключение вращения и пространства отображения частиц;
• N - замедление перемещения;
• C - точная подстройка позиции, или nudge;
• X - сброс позиции редактируемого объекта;
• M - переход к следующему режиму редактора: предмет, рука, относительная рука, частица;
• UNBOUND - переход к предыдущему режиму редактора, если назначить клавишу вручную;
• Z - включение или отключение всего редактора.

Последняя функция особенно удобна, когда нужно быстро проверить обычный вид ресурспака без удаления файлов или перезапуска Minecraft. В версии 2.1 появился общий переключатель, который отключает весь позиционер одной клавишей.

Дополнительные параметры

В конфигурации доступны настройки, которые влияют на удобство редактирования:

• Volume - размер области или объём редактируемого объекта;
• slowMovementShouldToggle - определяет, работает ли замедленное перемещение как переключатель или только пока удерживается клавиша;
• nudgeShouldToggle - аналогичная настройка для режима точной подстройки.

Режим Nudge пригодится, когда объект уже почти стоит правильно, но его нужно сдвинуть на небольшой шаг. Это удобнее, чем постоянно работать крупным перемещением и пытаться поймать нужное положение.

Как пользоваться позиционером

1. Установите Hold My Items и подключите HMI Item Positioner как ресурспак.
2. Откройте мир Minecraft с HMI-совместимым ресурспаком.
3. Включите редактор клавишей Z.
4. Выберите нужный режим через M.
5. Настройте координаты по трём осям, поворот и дополнительные параметры.
6. При необходимости используйте N для медленного перемещения или C для точной подстройки.
7. Перенесите полученные значения в HMI-скрипт.

По сути, проект превращает настройку HMI-предметов из ручного подбора в нормальный визуальный процесс. Особенно хорошо это ощущается при работе с несколькими предметами, нестандартными позами рук и частицами, где даже небольшая ошибка координат сразу заметна на экране.

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

• Minecraft Java Edition 1.21.9-1.21.11;
• клиентский мод Hold My Items для Fabric;
• HMI-совместимый ресурспак для редактирования;
• отдельный загрузчик для самого HMI Item Positioner не заявлен, поскольку это ресурспак-утилита.

HMI Item Positioner не является самостоятельным модом для Forge или NeoForge. Его основная рабочая связка рассчитана на Fabric-клиент и Hold My Items. Если редактор не появляется, сначала проверьте, что установлен совместимый вариант HMI и активирован сам ресурспак.

Что изменилось в последних версиях

• Версия 1.2 добавила позиционирование частиц и исправила работу с pivot point.
• Версия 2.1 получила общий переключатель редактора, позволяющий включать и отключать весь инструмент одной клавишей.

Проект помечен как Utility и распространяется по лицензии LGPL-3.0-only. Он не добавляет контент в выживание и не меняет баланс игры, а решает конкретную техническую задачу - точную настройку отображения предметов, рук и частиц в экосистеме Hold My Items.