Решает самое больное место в разработке аддонов - создание его графического интерфейса. Исходный код редактора открыт и доступен на github. Он разработан на C# в Microsoft Visual Studio 2022. Призываем помочь с развитием программы.
Использование
Делайте бэкапы своих аддонов!
При первом открытии аддона в логе снизу выведется список ошибок, если они есть. Эти ошибки нужно устранить вручную. Обычно это ссылки на несуществующие файлы или нарушение разметки XML. Эти файлы редактор не смог обработать и мог удалить ссылки на такие файлы, либо мог прочитать не все свойства правильно из этих файлов. Сохранять аддон через редактор в таком случае категорически не рекомендуется. Сначала устраните ошибки, затем откройте аддон заново и убедитесь, что лог пустой.
Дерево виджетов
Виджеты основанные на прототипах выделены жирным цветом. Сам прототип и его свойства можно найти в окне свойств виджета, см. (Header) -> Prototype.
Зеленым цветом выделены виджеты, которые указаны внутри прототипа, а не в самом виджете, см. (Header) -> Prototype -> Children.
Курсивом и в квадратных скобках выделены виджеты, которые найдены не в свойстве Children, а в любых других (например, скроллбары, слайдеры указываются в отдельных свойствах).
Если виджет не имеет имени, вместо его названия будет написан тип виджета.
Окно свойств
В окне свойств можно редактировать почти любые свойства любого типа вложенные на любую глубину, кроме:
ВНИМАНИЕ! Редактор не поддерживает именованные поля, которые можно связать с любым свойством в прототипе и затем задать их значения в хеадере наследника. Если вы пользуетесь такими переменными, то редактор не сможет загрузить и сохранить эту информацию.
Файлы xdb следующих типов не будут затронуты при сохранении: UITextureElement, UISingleTexture, UITexture, DecalTemplate, FMODProject, VisObjectTemplate, UISingleTexture. Вы можете указывать ссылки на файлы этого типа, видеть какие-то свойства, но при сохранении файлы эти файлы не будут перезаписаны. Такое поведение объясняется тем, что эти файлы не должны редактироваться вручную, а должны создаваться через специальные программы.
Из менее известного не поддерживается styleSheets у класса UIAddon, это массив WidgetCss но вряд ли вы знали о его существовании. Пример игрового WidgetCss от старой версии игры можно найти здесь.
Почти все свойства виджетов могут быть пустыми, т.е. не заданы вообще. Точно также, как в xdb-файле вы можете что-то не написать, оставив свойство не заданным. Тогда используется значение из прототипа (или если и там не задано, то в прототипе прототипа и т д.), а если такое не найдено, то значение по умолчанию.
Также редактор не поддерживает отмену действий 🙂
Ссылки href
Все ссылки (href) в редакторе указываются не относительно конкретного файла виджета, а относительно директории аддона, учитывайте это. При сохранении ссылки снова конвертируются в локальные для каждого файла.
В любом поле со ссылкой можно нажать на кнопку "..." и выбрать нужный файл.
Также можно напрямую вставить в текстовое поле полный путь до файла, либо путь относительно директории аддона и нажать Enter. Этим же способом можно вставить ссылку на внутриигровой ресурс, она должна начинаться с символа "/", например, "/Interface/...". Но редактор не может открыть внутриигровые xdb-файлы, поэтому никак не сможет нормально отобразить внутриигровые виджеты, текстурные слои и т.п.
Чтобы удалить ссылку нужно выделить всё в текстовом поле, нажать Del и Enter.
Не забывайте, что если два виджета в дереве виджетов загружаются из одного и того же файла, то это один и тот же объект. Меняя свойства одного такого виджета, вы меняете свойства другого. Особо внимательными стоит быть с редактированием прототипов.
Имеется одна "фича". Если вы удалите где-то ссылку на любой xdb-файл, то он вместе с текущими значениями свойств всё равно останется в памяти, так как эта же ссылка может быть указана где-то еще. Двже если вы удалите все ссылки, то файл не удалится из памяти пока вы не откроете другой (или этот же заново) проект или не перезапустите редактор. Т.е. если снова указать ссылку на этот файл, то он не загрузится заново из файла с неизменёнными свойствами, а будет получен из памяти с изменёнными (если вы их меняли, конечно).
Окно графического редактора
С зажатой ПКМ можно перемещать камеру. Колёсиком зумить. Нажатие колёсика сбрасывает камеру в начальное состояние.
На данный момент поддерживаются далеко не все свойства и отрисовка виджетов может быть не совсем корректной. Не работает даже самый обычный clipContent. Что работает:
Позиционирование виджетов: работает всё кроме WIDGET_SIZING_INTERNAL, в этом случае размер виджета считается как 45x15. Прототипы учитываются Текстуры виджетов: работает отрисовка только WidgetLayerSimpleTexture и WidgetLayerTiledTexture. Не до конца доделана отрисовка WidgetLayerAnimatedTexture, не работает scaling и отрисовка нескольких текстур, если массив frames содержит более одного элемента. Для обычных виджетов отрисовываются только BackLayer и FrontLayer, для кнопок только LayerHighlight и все State. Никакие маски не работают. Из BlendEffect поддерживается только BLEND_EFFECT_ALPHABLND и BLEND_EFFECT_ADD, BLEND_EFFECT_HIGHLIGHT отрисовывается как BLEND_EFFECT_ADD, всё остальное отрисовывается как BLEND_EFFECT_ALPHABLND. Прототипы самих виджетов учитываются при отрисовке, протипы текстурных слоёв и т.п. - нет. Слои WidgetLayerTiledTexture могут отображаться не так, как в игре. Редактор никак не использует поля MiddleX и MiddleY в Layout, а просто считает за середины всё что осталось после вычета боковых или верхних-нижних частей. Плюс может тайлить любые мелкие текстуры бесконечное число раз, в игре это не так.
Комментарии разработчика игры UIAddon о тайловых текстурах:
Вот набор правил которым очень желательно следовать при работе с ними (работать будет и при нарушении этих правил, но хорошо оптимизирована только эта ветка кода)
Если у текстуры LeftX и RightX (TopY и BottomY) нули, то размер виджета с этой текстурой по X (Y) никогда не должен быть 0 Если MiddleX (MiddleY) нуль то RightX (BottomY) должны быть ноль MiddleX и MiddleY должны быть либо 0 либо 2^N (N>=5) Не стоит делать tlled текстуру у которой ненулевые только Middle и при этом тип SCALED - это эмулирует simple текстуру через tiled Не стоит делать tiled текстуру у которой оба Middle нулевые - это эмулирует simple текстуру через tiled Общее
Чтобы любой аддон запускался и работал корректно, кодировки файлов должны быть следующими:
Файлы XDB - UTF-8 (стандартный без спецификаций BOM) Файлы TXT - UTF-16 LE (Unicode Little Endian) Файлы LUA - ANSI (Windows-1251 для русской версии игры) Всегда проверяйте это, когда сохраняете или создаёте файлы вручную. В любом текстовом редакторе кодировка обычно показана в нижнем правом углу окна.
Примечания
"Аллоды Онлайн" является зарегистрированным товарным знаком и принадлежит правообладателям. В редакторе в качестве примеров и шаблонов в ознакомительных целях могут использоваться текстуры и/или их элементы принадлежащие ASTRUM LLC.
Использованные библиотеки:
Monogame DockPanelSuite SixLabors.ImageSharp

Slashuur

473 6 января

LibDnD

Официальная версия LibDnD для аддонов. Рекомендуется разработчикам аддонов использовать данную версию LibDnD в своих аддонах.
В ближайшем будущем планируется добавления новых плюшек, в т.ч. перенос некоторых плюшек из других аддонов.
Если требуется какой-то особенный дополнительный функционал, или кто-то готов поделиться своим, то можно об этом попросить на странице разработки LibDnD.
HOW-TO: LibDnD.lua - Библиотека Drag&Drop
Простейший пример использования LibDnD
Файл LibDnD.lua нужно включить в AddonDesc.(UIAddon).xdb, в секции <ScriptFileRefs>:
<ScriptFileRefs> <Item href="LibDnD.lua" /> ... </ScriptFileRefs> DnD.Init() - Инициализирует виджет для Drag&Drop. Это нужно только один раз, во время инициализации аддона, или позже, когда угодно. Повторные вызовы для того же самого виджета на данный момент нежелательны.
Пример:
DnD.Init( wtMainPanel ) Всё, Drag&Drop УЖЕ работает 🙂
Функция DnD.Init()
Синтаксис:
DnD.Init( wtMovable, wtReacting, fUseCfg, fLockedToScreenArea, Padding, KbFlag, Cursor ) Обязательные параметры:
wtMovable - ссылка на Widget.
Виджет, КОТОРЫЙ нужно перемещать. Необязательные параметры (могут быть nil, или их можно вообще не писать):
wtReacting - ссылка на Widget (nil = wtMovable).
Виджет, на который привязывается реакция, т.е. виджет, ЗА КОТОРЫЙ будет перетаскиваться wtMovable. Это может быть сам wtMovable, то есть сама перетаскиваемая панель, но НЕ обязательно (!), это может быть что угодно, например, ЗАГОЛОВОК ОКНА, "дочерний" по отношению к ОКНУ wtMovable. Если не указан - виджет wtMovable перемещается сам за себя.
fUseCfg - true/false (nil = false).
Сохранять ли позицию виджета в конфиг-файл User.cfg. Если да, то сохранит в таблице с именем "DnD:<путь к виджету wtMovable в иерархии>", в секции, названной по имени аддона. Рекомендуется, чтобы все родительские виджеты wtMovable имели осмысленные, не динамические, уникальные имена.
fLockedToParentArea - true/false (nil = true).
Если true, то передвигаемый виджет нельзя даже частично утащить за края родительского окна (чаще всего ими являются края экрана). Таким образом он всегда будет находиться целиком на экране (если не переопределено в параметре Padding, см. ниже). А если false, то его можно утащить полностью, точно так же, как можно утаскивать окна в ОС Microsuxx Windows.
Padding - число или таблица из 4 чисел {Верхний,Правый,Нижний,Левый} (nil = {0,0,0,0}).
Если fLockedToParentArea=true, то действует Padding. Если хотите, чтобы за край окна всё-таки можно было частично утащить wtMovable на какую-то глубину, то можете заполнить таблицу. Например, это сделано в аддонах "PhanTime" и "HonorInfo", где по краям панели имеется "тень" толщиной 8 пикселей. Там эта таблица заполнена отрицательными числами, вот так: {-8,-8,-8,-8}. В случае передачи числа в качестве параметра, оно будет использовано в качестве глубины по всем направлениям.
KbFlag - флаги управляющих клавиш KBF_*.
Если надо, чтобы wtMovable двигался только при нажатии клавиш Shift, Ctrl или Alt, передаем здесь соответствующие флаги KBF_*: nil - нажатие любой из перечисленных клавиш не имеет никакого эффекта. KBF_NONE - Перетаскивание только при не нажатых клавишах KBF_SHIFT - Перетаскивание только при нажатой "Shift" KBF_ALT - Перетаскивание только при нажатой "Alt" KBF_CTRL - Перетаскивание только при нажатой "Ctrl" KBF_ANY - Перетаскивание только при любой нажатой клавиши из перечисленных
Cursor - строка/false (nil = "drag").
Стиль курсора, который будет устанавливаться при перетаскивании. nil/true - используется курсор по умолчанию: "drag". false - курсор не меняется при перетаскивании. Примеры использования DnD.Init()
Виджет Окно (wtWindow), которое можно таскать за виджет Заголовок-окна (wtTitle), являющийся дочерним виджетом Окна:
DnD.Init( wtWindow, wtTitle ) Виджет таскается сам по себе, И его позиция сохраняется между игровыми сессиями (создаёт секцию по названию аддона в файле User.cfg):
DnD.Init( wtPanel, wtPanel, true ) или:
DnD.Init( wtPanel, nil, true ) Виджет не сохраняет позицию между игровыми сессиями, и его можно утащить почти полностью за край экрана:
DnD.Init( wtPanel, nil, false, true ) Позицию в конфиг не сохраняет, но за то, "тень" по краям текстуры фона окна аддона, имеющая
толщину 8 пикселей со всех сторон, будет красиво задвигаться за край экрана (так сделано в аддонах "PhanTime" и "HonorInfo"):
DnD.Init( wtMainPanel, nil, nil, nil, {-8,-8,-8,-8} ) или:
DnD.Init( wtMainPanel, nil, nil, nil, -8 ) Делаем сразу три разных виджета передвигаемыми в одном аддоне:
DnD.Init( wtTrayButton ) DnD.Init( wtMainWindow ) DnD.Init( wtConfigWindow ) Делаем передвигаемую wtMainPanel и все её дочерние виджеты в пределах родителя с учетом рамки в 4 пикселя при нажатой клавише Ctrl, с сохранением всех позиций в User.cfg:
DnD.Init( wtMainPanel, nil, true ) for _,wtChild in pairs( wtMainPanel:GetNamedChildren() ) do DnD.Init( wtChild, nil, true, nil, 4, KBF_CTRL ) end Функция DnD.Enable()
Синтаксис:
DnD.Enable( wtWidget, fEnable ) wtWidget - ссылка на Widget.
Это может быть wtReacting или wtMovable, не важно, т.к. оба варианта работают.
fEnable - true/false.
Если true, то виджет будет реагировать на Drag&Drop, а если false, то Drag&Drop виджета будет запрещён (то есть, виджет будет "пристёгнут", и будет игнорировать все попытки перетаскивания). Этой функцией пользоваться НЕ обязательно, т.к. все виджеты, зарегистрированные в системе функцией DnD.Init(), по умолчанию, АКТИВНЫ. Но если возникнет необходимость "пристегнуть" такой виджет, то функция DnD.Enable() существует именно для этого. Она меняет статус виждета, перманентно разрешающий или запрещающий его Drag&Drop. "Пристегнуть" виджет можно командой DnD.Enable( ВашВиждет, false ), и он будет игнорировать все попытки перетаскивания. Если позже вам потребуется снова разблокировать его (снова сделать перетаскиваемым), то сделайте это командой DnD.Enable( ВашВиждет, true ).
Функция DnD.Enable() может потребоваться вам, например, если вы захотите сделать в своём аддоне полноценную поддержку событий аддона AddonManager.
Подробнее об этом написано здесь: Поддержка событий AddonManager в других аддонах
Функция DnD.IsDragging()
Синтаксис:
DnD.IsDragging() Если в вашем аддоне есть перетаскиваемые кнопки (такие есть, например, в аддонах "DarkDPSMeter" и "GuildGui1b"), то вам пригодится функция DnD.IsDragging(). Чтобы при перетаскивании такой кнопки, ИЗБЕЖАТЬ нажатие на неё, вставьте такую строку в начало кода реакции на нажатие кнопки:
if DnD.IsDragging() then return end Функция DnD.Remove()
Синтаксис:
DnD.Remove( wtWidget ) wtWidget - ссылка на Widget.
Виджет, который нужно разрегистрировать в системе DnD, чтобы его можно было безопасно уничтожить с помощью DestroyWidget. Передавать надо именно тот виджет, который собираетесь уничтожать.
На данный момент не проверяет, зарегистрированы ли в системе дочерние по отношению к wtWidget виджеты, поэтому, если вы их регистрировали, то необходимо вызывать DnD.Remove и для них.
Пример: for _,wtChild in pairs( wtMainPanel:GetNamedChildren() ) do DnD.Remove( wtChild ) end DnD.Remove( wtMainPanel ) wtMainPanel:DestroyWidget() Бонус: функции GetConfig() и SetConfig()
Примеры:
Получить весь конфиг аддона в виде ТАБЛИЦЫ (если он есть в User.cfg), или nil (если его там нет):
Config = GetConfig() Получить из конфига значение переменной Name (если она есть) или nil (если её там нет).
Имя переменной может быть строкой или числом, а значение - чем угодно, хоть таблицей.
MyOption = GetConfig( Name ) Сохранить в конфиг-файл переменную Name со значением Value.
Те же условия для имени и значения, что описаны в предыдущем примере.
SetConfig( Name, Value ) Если передать только ОДИН параметр, но ТАБЛИЦУ, то все её переменные будут аккуратно добавлены (merged) в конфиг аддона. Именно добавлены. То есть, тупой перезаписи одной таблицы поверх другой эта функция НЕ делает.
SetConfig( { ["A"] =5, [100] ={1,10,100}, ["Yes"] =true } ) Этим двум функциям НЕ нужно указывать название секции, т.к. они всегда пользуются секцией, названной именем аддона.

hal.dll

5 743 26 апреля, 2023

AlloderUpdater - автообновление аддонов

Возможности
Установка, обновление и удаление аддонов (после авторизации): в том числе и для платных аддонов. Отслеживание обновлений аддонов и уведомление о них. Самостоятельно обновит себя в случае выхода новой версии. Выгрузка на сервер данных, собираемых аддоном UpdaterHelper (автоматически ставится при установке программы) - курс кри для ф2п, время появления Уро-Бороса (для работы мониторинга серверов). При первом запуске может потребоваться задать соответствия с некоторыми аддонами, которые программа не сможет распознать самостоятельно.
Установка
Windows требует подписи программ именными сертификатами. Поскольку такой сертификат стоит достаточно дорого, мы не захотели его покупать. Без сертификата установка со стороны Windows несколько осложняется, а именно:
после запуска установщика жмем "Установить" - "Подробнее" - "Выполнить в любом случае"

Требования
Windows 7 х64 и новее. Microsoft .NET Desktop Runtime 6.0 (если отсутствует - программа установит его самостоятельно).

Lafayette

70 747 27 марта, 2023

Определитель ключа для привязки аддонов

Касается только игроков оф.серверов.
Аддон необходим для получения ключа, используемого в привязке платных аддонов к аккаунту.
Скачиваем и ставим аддон. Заходим в игру, включаем его, копируем ключ. Вставляем ключ в поле "ID игрового аккаунта" в настройках сайта. Готово! Теперь можно скачивать аддоны, и они будут работать на всех персонажах на привязанном аккаунте. Подробности, вопросы и ответы
Only for players from official server.
Addon needed for receiving special key of your game account, which uses in binding paid addons to game account.
Download and install addon.
Log in to game, enable addon, copy key.
Paste it in the field "Game account ID" in profile settings.
Done! Now you can download paid addons and they will work for all characters from binded game account.
Details, questions and answers

Lafayette

37 911 11 июня, 2016

интерфейс

ItemsInCheckroom

Аддон-заплатка. Активирует функции гардероба.
Если у вас в гардеробе имеется костюм, то при наведении такого же в сумке или у НПС появляется надпись "Предмет уже есть в гардеробе" а сам костюм будет выделен красным цветом. Однако эта функция игры срабатывает только если вы открыли "Гардероб". До этого функция может срабатывать частично (например только подкрашивание) или вообще не срабатывать. Видимо чтобы игра погружалась при заходе а не висла при учете 1000+ костюмов
Аддон заходит в гардероб спустя пару секунд после загрузки персонажа и активирует функционал игры.
Внимание!!! Функция не срабатывает на некоторые окрасы, упакованные костюмы и наборы костюмов
Стоит отметить, что аддоны типа PetsSearch2 подкрашивают костюмы; аддон PetsCouture также как этот активирует функцию.
для PetsSearch2 при первом появлении на Айрине позволяет использовать функцию одевания "Маски Вольной Птицы". Иначе с только установленным PetsSearch2 (без этого аддона) придется пройтись до смены зон на Айрине чтобы маска оделась

Аддоны по теме: PetsSearch2 PetsCouture
Другие аддоны можно посмотреть по https://alloder.pro/profile/687-worm/content/?type=downloads_file

Войти

Дайджесты за январь-февраль

Мониторинг серверов и редактор аддонов

Подсказки из игры на вашем сайте

Апдейтер аддонов

Аддоны

587 файлов

Программы

Популярные файлы

Неделя

Месяц

Год

Всё время

Фильтрация

Премии за аддоны

Доступные подписки

Текущие цели пожертвования

Рекомендуем к использованию

Сообщения

Статистика Загрузок

Важная информация