Bears Decor Tool
Если вы когда-нибудь пытались поставить декоративный стул ровно по центру комнаты или повернуть вазу на пару градусов, вы знаете, насколько это раздражает. Мышь в House Editor двигает предмет слишком грубо, а стандартные средства не дают нужной аккуратности. Именно эту проблему решает Bears Decor Tool — маленький аддон, который превращает стрелки клавиатуры в инструмент микро-подстройки декора.
Bears Decor Tool для World of Warcraft не пытается быть универсальным комбайном для домов. У него узкая, но очень конкретная задача: дать вам контроль над каждым шагом перемещения, поворота и масштабирования выбранного предмета. И, что важно, он не тянет за собой никаких сторонних зависимостей — только собственный код и встроенные библиотеки.
Что такое Bears Decor Tool и зачем он нужен
Аддон использует механику Expert Decor, встроенную в систему жилья. Когда вы находитесь в режиме Expert Decor и у вас выбран предмет, Bears Decor Tool активирует функцию C_HousingExpertMode.SetPrecisionIncrementingActive на заданное число кадров, а затем выключает её. Каждое нажатие клавиши — это короткий импульс, который сдвигает декор на минимальное расстояние, определяемое самой игрой.
Звучит технически, но на практике всё просто: вы жмёте стрелку, предмет двигается крошечными шажками. Чем больше кадров в импульсе, тем крупнее шаг. Никаких абсолютных координат — публичный API их не отдаёт, поэтому значения в слайдерах измеряются в кадрах, а не в метрах или градусах.
Поддерживаемые версии World of Warcraft
Здесь важно быть предельно честными: Bears Decor Tool работает только в Retail World of Warcraft, начиная с патча 12.1.5 (Midnight). В TOC прописан интерфейс 120105. Если ваш клиент сообщает другую версию, номер можно обновить вручную через команду /dump select(4, GetBuildInfo()).
Classic, TBC, WotLK, Cataclysm и MoP не поддерживаются — система жилья и API Expert Decor существуют только в актуальном клиенте. Так что если вы ищете аддон для классических серверов, это не тот случай. Зато для тех, кто обустраивает дом в Retail, инструмент закрывает реальную боль.
Требования для запуска
- Retail World of Warcraft: Midnight, патч 12.1.5 или новее.
- Наличие дома и доступ к House Editor.
- Активный режим Expert Decor.
- Выбранный предмет декора.
Как установить Bears Decor Tool
Установка предельно простая, но есть один нюанс: папка должна называться строго Bears_Decor_Tool, чтобы совпадать с файлом Bears_Decor_Tool.toc. Если вы копируете файлы вручную, положите их в World of Warcraft\_retail_\Interface\AddOns\Bears_Decor_Tool и выполните /reload в игре.
Для разработчиков удобнее сделать junction или клонировать репозиторий прямо в папку AddOns. После этого достаточно перезагрузить интерфейс, и аддон готов к работе. Если же вы предпочитаете не возиться с путями и вручную перекладывать файлы, лаунчер foxygame.net позволяет поставить Bears Decor Tool в один клик и сам подхватывает обновления, избавляя от ручной проверки версий.
Как пользоваться аддоном
Войдите в дом, откройте House Editor и переключитесь в Expert Decor. Выберите предмет декора. Дальше можно нажимать стрелки или вводить команды. Например, /bdt pulse forward 3 сдвинет предмет вперёд на три кадра. Команда /bdt stop мгновенно останавливает все импульсы, а /bdt status покажет состояние API, режима редактора и активных импульсов.
Окно аддона открывается командой /bdt или кнопкой на миникарте. Кнопку можно перетаскивать, её позиция сохраняется между сессиями. В окне четыре слайдера — по одному на каждое направление: влево/вправо, вверх/вниз, вперёд/назад и поворот/масштаб. Все значения по умолчанию равны 3 и сохраняются между сессиями.
Горячие клавиши и удержание
В режиме Expert Decor аддон назначает оверрайд-биндинги: стрелки двигают декор, Page Up и Page Down — вверх и вниз. Ваши сохранённые раскладки при этом не меняются. Быстрое нажатие — один шаг, удержание дольше 0,3 секунды — непрерывное движение до отпускания (с предохранителем на 10 секунд).
В подрежимах Rotate и Scale стрелки переключаются на поворот и масштаб. Золотые стрелки на гизмо — это мышиное управление самой игры, и аддон не может через них двигать декор. Для точного поворота используйте клавиши влево/вправо.
Команды и тонкая настройка
Все команды начинаются с /bdt. Вот основные:
- /bdt on и /bdt off — включить и выключить подстройку (сохраняется между сессиями).
- /bdt steps <n> — задать шаг поворота и масштаба от 1 до 10.
- /bdt commit — вызвать CommitDecorMovement() для выбранного предмета.
- /bdt resetsnap — вернуть настройки снапа перетаскивания к документированным значениям.
- /bdt reset — сбросить SavedVariables.
- /bdt debug и /bdt help — отладка и справка.
Парсер команд использует явный белый список типов, произвольные строки отклоняются, а loadstring на пользовательском вводе не применяется. Импульсы ограничены 60 кадрами и автоматически останавливаются через три секунды — предохранители на случай, если что-то пойдёт не так.
Ограничения, о которых стоит знать
Bears Decor Tool работает только с относительной подстройкой. Абсолютных координат, точного считывания трансформаций и гарантированных расстояний здесь нет — GetSelectedDecorInfo() просто не отдаёт трансформацию. Количество кадров не равно фиксированному числу градусов, поэтому на разных частотах кадров шаг может ощущаться по-разному.
Одновременно активен только один тип инкремента, мультиосевое и диагональное движение не реализовано. API жилья новое и может меняться между патчами, так что после крупных обновлений стоит проверять работоспособность. Аддон не связан с Blizzard Entertainment, а локализация покрывает только элементы управления шагом — остальные строки откатываются на английский.
Итог
Bears Decor Tool — это узконаправленный, но по-настоящему полезный инструмент для тех, кто относится к обустройству дома серьёзно. Он не заменяет мышь и не даёт магии абсолютного позиционирования, зато превращает грубое перетаскивание в контролируемую микро-подстройку. Если вы обустраиваете дом в Retail и вам не хватает точности — скачать Bears Decor Tool стоит хотя бы для того, чтобы попробовать. Установка занимает минуту, а результат заметен с первого же нажатия стрелки.