Ru:

Аддон показывает расположение камней, необходимых для получения вехи по квесту "Путь твоего класса", а также некоторых других игровых объектов.

Камни и игровые объекты отображаются на карте мира и на обоих миникартах.

Начиная с версии 1.0 совместно со встроенной в игру миникартой полностью заменяет дополненный аддон MinimapSla, размещенный в профильной теме официального форума.

Начиная с версии 1.6 дублирует функционал аддона SearchCrown.

Начиная с версии 2.3 дублирует функционал аддона HerbMap.

Автоперемещение:

Автоперемещение не работает в связи с хотфиксом 5.0.00.66 [25.03.14].

Установка:

1. Скачиваем архив с аддоном Cartographer_2.5.pak для любой версии игрового клиента.
2. Удаляем предыдущие версии аддона (в том числе Crystals.pak, Cartographer.pak) из директории игры Allods Online\data\Mods\Addons\.
3. Копируем (распаковывать не требуется) скачанный архив в директорию игры Allods Online\data\Mods\Addons

Настройка:

В аддоне присутствует окно настроек, позволяющее указывать, объекты какого типа вы хотите видеть на карте.

Настройки являются независимыми для каждого персонажа.

Окно настроек вызывается чат-командой /cart

Так же можно частично отключить аддон: метки объектов при этом показываться не будут, все манипуляции пользователя с картой, требующие смены расположения показанных обектов (например, изменение масштаба), будут игнорироваться, таймер будет отключен, но окно настроек будет доступно. Данная возможность будет полезна при массовых сражениях.

По умолчанию аддон показывает все известные ему объекты:

• Астральный лазурит
• Астральный хризолит
• Астральный топаз
• Сундуки с сокровищами
• Вход в пещеру Тка-Рика (доступно автоперемещение)
• Вход в Город Демонов
• Входы на Арены
• Межевые камни
• Корабельные причалы
• Торговцы миррой
• Места добычи трав и руды
• Телепорты на карте НИИ МАНАНАЗЭМ
• Силайа на Кольце Дракона
• Служители Времени на Кирахе
• Первый Скиталец во времени (синие песочные часы)
• Вторая Скитальца во времени (красные песочные часы)
• Заблудившийся во времени Саранг Ма (фиолетовые песочные часы)
• Боссы (красные короны)

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

Настройки применяются сразу после их изменения.

Нажатие на кнопку "Сохранить" сохраняет изменения в игровые настройки аватара, которые будут загружены при следующем запуске игры.

Нажатие на кнопку "Отменить измененное" сбрасывает все не сохраненные настройки.

Объекты пользователя:

Аддон позволяет добавлять на карту свои объекты. База объектов пользователя сохраняется в глобальных настройках, таким образом они будут доступны на всех перерождениях и альтернативных персонажах.

Оконный интерфейс базы пользовательских объектов вызывается чат-командой /cdb

Любое из 3 окон интерфейса можно перемещать или растягивать. Кроме того все 3 окна могут перемещаться одновременно за заголовок.

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

Для добавления меток на карту Астрала необходимо воспользоваться дополнительной панелью, отображаемой поверх карты Астрала. Для этого просто перетащите мышью (Drag'n'Drop) иконку объекта в то место на карте, куда хотите добавить свою метку. Для выбора иконки просто щелкните по ней левой кнопкой мыши. Сама панель также передвигается за рамку.

Для объектов можно задавать иконку метки на карте, название для отображения в списке объектов и описание, которое будет использоваться во всплывающей подсказке. Все изменения применяются сразу. Это относится и к панелям текстового ввода. Нажатие на Enter и Esc при активной панели текстового ввода трактуется одинаково и приводит только к потере фокуса ввода.

Нажатие на кнопку "Сохранить" сохраняет все изменения.

Нажатие на кнопку "Отменить измененное" сбрасывает все не сохраненные изменения; в том числе будут удалены добавленные, но еще не сохраненные объекты, а также восстановлены случайно удаленные объекты (если еще не успели нажать на "Сохранить").

Кроме этого базу данных можно выгрузить в файл mods.txt, создав резервную копию всех объектов.

Обмен координатами:

Аддон позволяет отправлять координаты и параметры своих объектов другим игрокам-пользователям аддона, используя игровой чат.

Отправка и получение координат осуществляется только для чата гильдии, офицеров, группы, рейда и через шёпот.

Порядок действий:

1. В окне со списком объектов выделить объект, координаты которого хотите кому-либо отправить.
2. Открыть окно ввода сообщения чата и выбрать нужный чат.
3. Нажать на кнопку "Отправить объект в чат". Если кнопка не активна, значит не все условия были выполнены.
4. В окне ввода сообщения появится запрос на ввод клавиши Enter. Нажмите её.
5. В чате появится специальным образом составленное сообщение, которое будет распознано аддоном, установленным у других пользователей.

Внимание: Приём объектов осуществляется постоянно вне зависимости от того, включен ли аддон в настройках или нет. Каждый принятый объект сохраняется в базе объектов автоматически (открывать интерфейс и нажимать на кнопку "Сохранить" не требуется). Это позволит не потерять объекты, полученные во время отсутствия за компьютером, если клиент игры завершится с ошибкой.

Дополнение общедоступных координат:

Любой желающий может помочь автору аддона, прислав координаты неизвестных точек респа камней.

Для этого необходимо включить соответствующую опции в окне настроек (команда /cart в окне чата), встать прямо в то место, где находится камень, и сделать скриншот.

По клавише PrintScreen аддон запишет координаты аватара в файл Allods Online\Personal\Logs\mods.txt.

Их надо извлечь и прислать (желательно вместе со скриншотом) либо на форум поддержки, либо в личные сообщения автору.

==================================================================================================

En:

Addon shows some known game objects on the World Map and both square and circle Minimaps:

• Respawn places of astral stones needed for a Ruby
• Treasures
• Milestones
• Tka-Rik cave entrance
• Gorluxor's Tower entrance
• Arena entrances
• Myrrh vendors
• Ship portals
• Herb
• Ore
• Elite bosses
• Soliskar at Dragon Ring
• Time travelers at Kirah
• Time servants at Kirah
• Teleporters at ZIT Headquarters

Installation:

1. Download archive with add-on Cartographer_2.5.pak
2. Remove older versions of add-on (Crystals.pak as well) from the game add-ons directory Allods Online\data\Mods\Addons\
3. Move downloaded archive to the game add-ons directory Allods Online\data\Mods\Addons\

Automove:

Automove is not working due to 5.0.00.66 game hotfix.

User objects:

Add-on allows to show user defined marks on maps.

To see user objects database interface issue the following chat command: /cdb

Sharing coordinates:

You can share your mark with your buddies using game chat.

1. Open user objects interface, select any mark in the list.
2. Open chat text input window.
3. Set its mode to desired (whisper, guild, officers, party or raid).
4. You should see "Send object to chat" button active now.
5. Push it.
6. You will see "Object is ready. Press <Enter> now." message in chat input window.
7. Press <Enter>.
8. You will see special message is sent to recipient(s).
9. The recipient(s) should, of course, have this addon installed to receive your mark.

Setup:

Setup objects that you would like to see using add-on settings window.

To see it just issue the following chat command: /cart

All settings are applied immediately.

==================================================================================================

Официальная версия 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 )

Обязательные параметры:

1. wtMovable - ссылка на Widget.
   Виджет, КОТОРЫЙ нужно перемещать.

Необязательные параметры (могут быть nil, или их можно вообще не писать):

1. wtReacting - ссылка на Widget (nil = wtMovable).
   Виджет, на который привязывается реакция, т.е. виджет, ЗА КОТОРЫЙ будет перетаскиваться wtMovable. Это может быть сам wtMovable, то есть сама перетаскиваемая панель, но НЕ обязательно (!), это может быть что угодно, например, ЗАГОЛОВОК ОКНА, "дочерний" по отношению к ОКНУ wtMovable. Если не указан - виджет wtMovable перемещается сам за себя.
    
2. fUseCfg - true/false (nil = false).
   Сохранять ли позицию виджета в конфиг-файл User.cfg. Если да, то сохранит в таблице с именем "DnD:<путь к виджету wtMovable в иерархии>", в секции, названной по имени аддона. Рекомендуется, чтобы все родительские виджеты wtMovable имели осмысленные, не динамические, уникальные имена.
    
3. fLockedToParentArea - true/false (nil = true).
   Если true, то передвигаемый виджет нельзя даже частично утащить за края родительского окна (чаще всего ими являются края экрана). Таким образом он всегда будет находиться целиком на экране (если не переопределено в параметре Padding, см. ниже). А если false, то его можно утащить полностью, точно так же, как можно утаскивать окна в ОС Microsuxx Windows.
    
4. Padding - число или таблица из 4 чисел {Верхний,Правый,Нижний,Левый} (nil = {0,0,0,0}).
   Если fLockedToParentArea=true, то действует Padding. Если хотите, чтобы за край окна всё-таки можно было частично утащить wtMovable на какую-то глубину, то можете заполнить таблицу. Например, это сделано в аддонах "PhanTime" и "HonorInfo", где по краям панели имеется "тень" толщиной 8 пикселей. Там эта таблица заполнена отрицательными числами, вот так: {-8,-8,-8,-8}. В случае передачи числа в качестве параметра, оно будет использовано в качестве глубины по всем направлениям.
    
5. KbFlag - флаги управляющих клавиш KBF_*.
   Если надо, чтобы wtMovable двигался только при нажатии клавиш Shift, Ctrl или Alt, передаем здесь соответствующие флаги KBF_*:
   • nil - нажатие любой из перечисленных клавиш не имеет никакого эффекта.
   • KBF_NONE - Перетаскивание только при не нажатых клавишах
   • KBF_SHIFT - Перетаскивание только при нажатой "Shift"
   • KBF_ALT - Перетаскивание только при нажатой "Alt"
   • KBF_CTRL - Перетаскивание только при нажатой "Ctrl"
   • KBF_ANY - Перетаскивание только при любой нажатой клавиши из перечисленных
      
6. 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 )

1. wtWidget - ссылка на Widget.
   Это может быть wtReacting или wtMovable, не важно, т.к. оба варианта работают.
    
2. 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 )

1. 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 } )

Этим двум функциям НЕ нужно указывать название секции, т.к. они всегда пользуются секцией, названной именем аддона.