CustomCommandRose v.2.3.1 by hedger // WOT id: tehHedger
  Мод "Кастомизируемая роза команд"

________________________________________________________________________________
        0. ЧТО ЭТО?

  Это мод, позволяющий настраивать стандартную розу команд. Изменённые сообщения
видны другим игрокам!

  Возможности данного мода:
  * Редактирование команд в меню
     - Поддерживаются макросы, подробнее в разделе 3
     - Можно указать, в общий чат отправлять фразу, или только своей команде
  * Возможность настроить разделы меню для каждого типа техники по отдельности
  * Подвешивание команд на комбинации горячих клавиш для вызова в обход меню
  * Автоматическое "прокликивание" указанных квадратов мини-карты
  * Совмещение встроенных команд (Назад, Перезаряжаюсь) и своего сообщения
  * Отдельный раздел меню с командами, привязанными к текущей карте
  * Можно настроить команды для каждого танка в отдельности

  Стандартные команды, совмещённые с хоткеями F2-F8, продолжают работать как
раньше.

  Багрепорты и пожелания отправляйте через ПМ на форуме или в игре (tehHedger).
  Новые версии появляются тут:
    http://rghost.ru/users/Hedger/releases/CustomCommandRose

  Отдельное спасибо mooseyaka за помощь в разработке и тестировании.

________________________________________________________________________________
        1. О ФАЙЛЕ С НАСТРОЙКАМИ

  Файл с конфигурацией называется RadialMenu.xml и лежит по пути
    res_mods\<версия>\scripts\client\gui\Scaleform\

  ВНИМАНИЕ!
  Через стандартный Блокнот конфиг лучше не редактировать, он ломается.
  Подойдёт WordPad, Notepad++, Sublime Text 2, PSPad или другой редактор
простого текста.

  В файле содержится несколько блоков команд:
    TankMenu    - базовая настройка разделов меню;
    MapCommands - команды, загружаемые в зависимости от текущей карты;

    SPGMenu, AT-SPGMenu, lightTankMenu, heavyTankMenu, mediumTankMenu
                - опциональные разделы, позволяющие использовать раздельные
                  конфигурации разделов меню при игре на разных типах техники;

    HotkeyOnlyCommands - дополнительные команды, вызываемые по горячим клавишам.
    TankSpecificCommands - команды, специфичные для конкретного танка или
      нескольких танков.

  В разделах TankMenu и относящихся к видам техники предусмотрены следующие
секции:
    CommonCommands - общие команды, когда прицел ни на кого не наведён;
    TeamCommands   - сообщения своим (когда прицел на союзном танке);
    EnemyCommands  - аналогично для противников.

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

  В блоке <MapMenuKey> указан код кнопки, нажатие которой при вызове меню
приведёт к отображению команд, привязанных к текущей карте.

________________________________________________________________________________
        2. ПРИОРИТЕТ НАСТРОЕК

  При построение меню происходит загрузка наиболее подходящих для текущего танка
команд для каждого из разделов CommonCommands, TeamCommands, EnemyCommands.

  Наивысший приоритет при построении меню имеют настройки указанных выше блоков
из раздела  <TankSpecificCommands>, если они определены для текущего танка.

  Если особых настроек там не найдено, то происходит загрузка раздела,
соответствующего классу техники (SPGMenu, AT-SPGMenu, heavyTankMenu, ...)

  Если же и там не найдена уточняющая конфигурация, то загружаются основные
настройки из раздела TankMenu.

________________________________________________________________________________
        2. НАСТРОЙКА ПОД ОТДЕЛЬНЫЕ ТАНКИ

  В разделе TankSpecificCommands можно либо настроить секции, которые будут
загружаться при игре на этом танке, либо указать другой блок из данного раздела,
из которого следует брать команды.

    Пример:
    <AMX_50_100>
      <Alias>AMX_13_90</Alias>
    </AMX_50_100>

    <AMX_13_90>
      <CommonCommands>...</CommonCommands>
    </AMX_13_90>

  При такой настройке, у танков AMX 50 100 и AMX 13 90 будет одинаковая
настройка общего меню, отличающаяся от всех других танков.


  Также, можно объединять конфигурацию для несколько танков в одну группу, и
сослаться на неё в настройках каждого из них.

    Пример:
    <AMX_50_100>
      <Alias>AutoloaderTank</Alias>
    </AMX_50_100>

    <AMX_13_90>
      <Alias>AutoloaderTank</Alias>
    </AMX_13_90>

    <AutoloaderTank>
      <CommonCommands>...</CommonCommands>
      <TeamCommands>...</TeamCommands>
    </AutoloaderTank>

  Список названий танков - http://pastebin.com/eMWtuLuG
  ВНИМАНИЕ! Названия чувствительны к регистру.

________________________________________________________________________________
        3. НАСТРОЙКА ПОД РАЗЛИЧНЫЕ КАРТЫ

Команды, привязанные к карте, размещаются в разделе MapCommands. Они
автоматически загружаются при попадании на конкретную карту. Этот режим меню
вызывается нажатием кнопки меню карты (по дефолту левый альт) + кнопки показа
радиального меню (по дефолту z).

В этом разделе размещаются секции с именем, соответствующим игровым названиям
карт. Имя карты пишется с префиксом "Map_", т.е. под Малиновку (02_malinovka)
имя секции "Map_02_malinovka".
ВНИМАНИЕ! Горячие клавиши для команд в данной секции не обрабатываются.

Полный список карт в 0.8.3:
      01_karelia 02_malinovka 03_campania 04_himmelsdorf 05_prohorovka 06_ensk
      07_lakeville 08_ruinberg 10_hills 11_murovanka 13_erlenberg
      14_siegfried_line 15_komarin 17_munchen 18_cliff 19_monastery 22_slough
      23_westfeld 28_desert 29_el_hallouf 31_airfield 33_fjord
      34_Redshire 35_steppes 36_fishing_bay 37_caucasus 38_mannerheim_line
      39_crimea 42_north_america 44_north_america 45_north_america 47_canada_a
      51_asia

Также есть секция Map_Default, которая грузится при отсутствии конфига под
данную карту.  Её можно рассматривать как дополнение общего раздела меню.

________________________________________________________________________________
        4. ФОРМАТ КОМАНД

Каждая команда определяется следующим образом:

    <Command>
      // Краткое название, выводимое в меню
      <Title>КД</Title>

      // Иконка для меню (см. список ниже)
      <Icon>Reload</Icon>

      // Текст, выводимый в чат (поддерживаются макросы)
      <Text>Ухожу на КД (%(ownPos)s), осталось %(reload)s сек.</Text>

      // Режим чата, Team(командный канал), All(общий канал).
      <ChatMode>Team</ChatMode>

      <!- - Ниже идут опциональные поля - ->

      // Команда из списка дефолтных, с отображением иконки на миникарте
      <Command>RELOADINGGUN</Command>

      //Вариации команд (поддерживаются макросы)
      <Variants>
        <Variant>Список</Variant>
        <Variant>из нескольких строк,</Variant>
        <Variant>одна из которых подставляется в макрос %(randpart)s</Variant>
        <Variant>Строка выбирается случайно</Variant>
      </Variants>

      //Выключение рандомного выбора фраз из блока <Variants>
      //При такой записи в команде варианты идут последовательно
      <NoRandomChoice>1</NoRandomChoice>

      // Список квадратов для "прокликивания"
      <Ping>B7 D9</Ping>

      // Сочетание клавиш для отдачи команды без вызова радиального меню
      <Hotkey>KEY_LALT+KEY_R</Hotkey>

      //Задержка до следующей отправки команды, в целых секундах.
      <Cooldown>4</Cooldown>
   </Command>

Допустимые имена иконок:
[ 'Attack', 'Yes', 'Helpme', 'Backtobase', 'No', 'Reload',
  'Followme', 'Turnback', 'Helpmeex', 'Stop', 'Support', 'AttackSPG' ]

Допустимые имена команд:
[ 'ATTACK', 'ATTACKENEMY', 'BACKTOBASE', 'FOLLOWME', 'HELPME', 'HELPMEEX',
  'NEGATIVE', 'POSITIVE', 'RELOADINGGUN' 'STOP', 'SUPPORTMEWITHFIRE', 'TURNBACK']

Поддерживаемые в тексте сообщения макросы:
   %(name)s         - имя игрока, на чей танк наведён прицел
   %(vehicle)s      - название типа техники
   %(clan)s         - название клана
   %(viewPos)s      - квадрат, в который направлена камера
   %(ownPos)s       - квадрат, в котором находится свой танк
   %(randpart)s     - случайная строка из списка в тэге <Variants/>
   %(reload)s       - оставшееся время перезарядки орудия, в секундах
   %(ammo)s         - число неистраченных снарядов в барабане
   %(ownVehicle)s   - свой танк.

Поддерживаемые макросы статистики:
  %(winrate)s%%     - общий процент побед
  %(eff)s           - РЭ по wot-news
  %(kbattles)s      - число боёв, в тысячах
  %(avglvl)s        - средний уровень танков
  %(twr)s           - TWR
  %(tankDamage)s    - средний дамаг на танке, обычно отдаётся XVM'ом некорректно
  %(tankWinrate)s%% - процент побед по танку

  Макросы "%(vehicle)s", "%(clan)s", "%(name)s", "%(winrate)s%%", "%(eff)s",
"%(kbattles)s", "%(avglvl)s", "%(twr)s", "%(tankDamage)s", "%(tankWinrate)s%%"
при отсутствии цели соответствуют игроку.

Список имён кнопок для горячих клавиш - http://pastebin.com/5GKk9jBX

________________________________________________________________________________
        3. CHANGELOG

v.1.0
  * Первый релиз.

v.2.0
  * Полная переработка конфига
  + Возможность обращаться к мёртвым танкам
  + Конфигурация под арту
  + Новые макросы с названием клана и направлением камеры
  ~ Улучшения стабильности при кривом конфиге

v.2.1
  + Раздел под текущую карту

v.2.1.1
  ~ Обновлены хоткеи под 0.8.2 (привет, двигатели Кнопки!)

v.2.2.0
  + Новые макросы:
    + Макрос с позицией своего танка
    + Макрос случайной подстановки части фразы
  + Поддержка "прокликивания" карты из команды
  + Выдача встроенных команд через меню, с отображением иконки команды на карте
  + Экспериментальная поддержка "горячих" клавиш
  ~ Исправлена команда атаки для артиллерии

v.2.2.1
  + Макросы со временем перезарядки и числом снарядов в барабане
  + Возможность "пинговать" квадраты по макросам
  ~ Исправлено поведение дефолтной секции для карт
  ~ Улучшена стабильность обработчика горячих клавиш

v.2.2.2
  + Добавлена секция с командами, назначаемыми на горячие кнопки
  ~ Исправлена обработка горячих кнопок и их сочетаний при активном окне чата

v.2.3
  ~ Исправлена обработка хоткеев для артиллерии
  ~ Макросы %(vehicle)s, %(clan)s, %(name)s при отсутствии цели соответствуют игроку
  ~ Загрузка Map_Default при наличии пустой секции под текущую карту
  + Поддержка макросов в подставляемых элементах фразы
  + Возможность указывать более 6 команд в каждом разделе. Седьмая и далее вызываются по хоткеям
  + Интеграция с XVM для загрузки статистики игроков. Требует xvm-stat 1.3.0 и старше
  + Возможность задания отдельных конфигураций меню под конкретные танки
  + Поддержка алиасов в названиях групп конфигураций для разделения настроек между танками
  + Горячая перезагрузка конфига в бою (правый ctrl+F11)
  + Отладочный вывод сообщений в реплеях
  + Макрос с названием собственного танка %(ownVehicle)s
  + Защита от повторения выбора одной подстановки два раза подряд
  + Настраиваемая задержка до повторной выдачи одного сообщения (по умолчанию 1 секунда)
  + Последовательный проход по вариантам подстановки

v.2.3.1
  ~ Совместимость с 0.8.5 CT1