Справочник по Модульной Системе

Тема рабочая, так что будет пополнятся и исправляться. Если у вас возникают вопросы по модульнуй системе спрашивайте в разделе "вопросов и ответов"http://rusmnb.ru/index.php?board=106.0 в соответствующих прикреплённых темах которые наиболее близко подходят к сути вашего вопроса.
В данной теме принимаются сообщения о ошибках в справочнике(кроме грамматических)

СПРАВОЧНИК НЕ ЗАВЕРШЕН. ПО МЕРЕ ВОЗМОЖНОСТИ БУДЕТ ОБНОВЛЯТЬСЯ.

header_operations взят за основу из работы Law

header_operations.py

Операции по работе с глобальной картой

(is_currently_night), - Проверяет что в игре ночь, когда игрок находиться на  глобальной карте

из module_simple_triggers.py
Код: [Выделить]

  # Checking escape chances of prisoners that joined the party recently.
  (6,
   [(gt, "$g_prisoner_recruit_troop_id", 0),
    (gt, "$g_prisoner_recruit_size", 0),
    (gt, "$g_prisoner_recruit_last_time", 0),
    (is_currently_night),
....

Всем известная ситуация, когда ночью некоторое количество завербованных на кануне из пленных рекрутов сбегает из отряда.
В данном случае операция проверки is_currently_night заставляет данный триггер срабатывать только ночью, хотя интервал проверки триггера 6 часов.

(map_free),                    - Проверка в условии триггера сработает только если игрок на глобальной карте и     закрыты все окна

из module_simple_triggers.py

Код: [Выделить]

# Read books if player is resting.
  (1, [(neg|map_free),
       (gt, "$g_player_reading_book", 0),
....Триггер отвечающий за чтение книг. Здесь проверка (neg|map_free), отвечает за то, чтобы книга не читалась, когда игрок находится просто в путешествии (на свободной карте), без этой проверки триггер будет срабатывать просто каждый час

операции для работы с погодой на глоб. карте
(get_global_cloud_amount, <destination>), - вернет в переменную текущую погоду (дождь, снег) на глобалке.
                                                                 значение от 0 до 100.
(set_global_cloud_amount, <value>), - устанавливает значение для погоды от 0 до 100.

- от значения погоды зависит также какой скайбокс для сцен движок будет использовать для определенного значения погоды. примерно можно разбить на четыре значения
sf_clouds_0   = от 0 до 25 - ясная погода
sf_clouds_1   = от 25 до 50 - облачная погода
sf_clouds_2   = от 50 до 75 - легкий моросящий дождь или пред дождевая погода
sf_clouds_3   = от 75 до 100 - дождь.

sf_clouds - флаг скайбокса  в файле Skyboxes.py

в изначально погода установлена на значении 50. саморегуляция происходит в пределах  /- 25 единиц. как происходят скачки погоды и от чего это зависит выяснить так и не удалось.

для работы с туманом
(get_global_haze_amount, <destination>),вернет в переменную значение от 0 до 100
(set_global_haze_amount, <value>), назначает значение от 0 до 100

0 - ясно
100 - густой туман.
туман на карте также скажется в сценах.

(store_current_hours, <destination>), - вернет в переменную сколько часов прошло с начала игры.

из module_simple_triggers.py

Код: [Выделить]

....
(24, #Kingdom ladies send messages
 [ (store_current_hours, ":hours_since_last_visit"),
(troop_get_slot, ":last_visit_hour", ":troop_id", slot_troop_last_talk_time),
(val_sub, ":hours_since_last_visit", ":last_visit_hour"),

(gt, ":hours_since_last_visit", ":longest_time_without_visit"),
....   Триггер отвечает за получение сообщения от дамы сердца с просьбой о визите.
Здесь операция store_current_hours, записывает в переменную ":hours_since_last_visit" текущее время. Далее вычисляется разница между временем последнего визита и текущим временем, и если со времени последней встречи прошло больше времени, чем заданно в переменной ":longest_time_without_visit" (по умолчанию 120 часов), то триггер срабатывает и вы получаете сообщение и квест на посещение дамы

(store_time_of_day, <destination>), - запишет в переменную текущее время суток. значение от 0 до 24

из module_game_menus.py

Код: [Выделить]

("wait_24_hours",[],"Wait until tomorrow.", [
          (assign,"$auto_besiege_town","$g_encountered_party"),
          (assign, "$g_siege_force_wait", 1),
          (store_time_of_day,":cur_time_of_day"),
          (val_add, ":cur_time_of_day", 1),
          (assign, ":time_to_wait", 31),
          (val_sub,":time_to_wait",":cur_time_of_day"),
          (val_mod,":time_to_wait",24),
          (val_add, ":time_to_wait", 1),
          (rest_for_hours_interactive, ":time_to_wait", 5, 1), #rest while attackable
          (assign, "$cant_talk_to_enemy", 0),
          (change_screen_return),
          ]),Этот пункт меню, при осаде позволяет дождаться следующего утра, если по каким то причинам сейчас вы на штурм идти не готовы, хотя все инженерные работы завершены.
Здесь в переменную ":cur_time_of_day" с помощью операции store_time_of_day записывается текущее время суток (количество часов, пошедших с последней полуночи). Далее высчитывается сколько времени осталось до ближайшего рассвета, записывается в переменную ":time_to_wait" и с помощью операции rest_for_hours_interactive игрок ждёт с пятикратным ускорением времени нужное время

(store_current_day, <destination>), - запишет в переменную количество дней прошедшее от начала игры.

из module_dialogs.py

Код: [Выделить]

[anyone|plyr,"lord_talk",[#(troop_slot_eq, "$g_talk_troop", slot_troop_is_prisoner, 0),
                            (neg|troop_slot_ge, "$g_talk_troop", slot_troop_prisoner_of_party, 0),
                            (check_quest_active,"qst_lend_companion"),
                            (quest_slot_eq, "qst_lend_companion", slot_quest_giver_troop, "$g_talk_troop"),
                            (store_current_day, ":cur_day"),
                            (quest_get_slot, ":quest_target_amount", "qst_lend_companion", slot_quest_target_amount),
                            (ge, ":cur_day", ":quest_target_amount"),
                            (quest_get_slot, ":quest_target_troop", "qst_lend_companion", slot_quest_target_troop),
                            (str_store_troop_name,s14,":quest_target_troop"),
                            (troop_get_type, reg3, ":quest_target_troop"),
                            ],
   "I should like {s14} returned to me, {s65}, if you no longer require {reg3?her:his} services.", "lord_lend_companion_end",
   []],Вариант диалога с лордом, если вы по квесту отдали одного из своих компаньонов ему на время.
Здесь операция store_current_day записывает в переменную ":cur_day" количество дней прошедших с начала игры. Далее это число сравнивается с датой возвращения компаньона оговоренной в условиях квеста, и если текущая дата больше, вы можете в диалоге попросить лорда вернуть вашего спутника.

(rest_for_hours, <rest_period>, [time_speed_multiplier], [remain_attackable]),  - операция вынуждает партию игрока стать на отдых на определенный период времени.

из module_game_menus.py

Код: [Выделить]

("village_loot",[], "Plunder the village, then raze it.",
       [
          (call_script, "script_village_set_state", "$current_town", svs_being_raided),
          (party_set_slot, "$current_town", slot_village_raided_by, "p_main_party"),
          (assign,"$g_player_raiding_village","$current_town"),
 
  (try_begin),
    (store_faction_of_party, ":village_faction", "$current_town"),
(store_relation, ":relation", "$players_kingdom", ":village_faction"),
(ge, ":relation", 0),
(call_script, "script_diplomacy_party_attacks_neutral", "p_main_party", "$current_town"),
  (try_end),
 
          (rest_for_hours, 3, 5, 1), #rest while attackable (3 hours will be extended by the trigger)
          (change_screen_return),При посещении деревни, в меню враждебных действий, вариант "Разграбить и сжечь деревню".
Здесь операция rest_for_hours заставляет отряд игрока ждать на глобальной карте 3 часа (<rest_period> = 3), без возможности самостоятельно прекратить это ожидание, с пятикратным ускорением времени ([time_speed_multiplier] = 5) и возможностью, что на игрока может в это время напасть враждебный отряд ([remain_attackable] = 1).

(rest_for_hours_interactive, <rest_period>, [time_speed_multiplier], [remain_attackable]), вынуждает стать на отдых  но с возможностью в любой момент его прервать

из module_game_menus.py

Код: [Выделить]

("start_collecting", [], "Start collecting.",
       [(assign, "$qst_collect_taxes_currently_collecting", 1),
        (try_begin),
          (quest_slot_eq, "qst_collect_taxes", slot_quest_current_state, 0),
          (quest_set_slot, "qst_collect_taxes", slot_quest_current_state, 1),
        (try_end),
        (rest_for_hours_interactive, 1000, 5, 0), #rest while not attackable
        (assign,"$auto_enter_town","$current_town"),
        (assign, "$g_town_visit_after_rest", 1),
        (change_screen_return),
        ]),Пункт в меню, появляющегося в меню города, если игрок получил от лорда квест на сбор налогов, при выборе которого, начинается сам сбор ("начать сбор").
Здесь операция rest_for_hours_interactive заставляет отряд игрока ждать в городе 1000 часов (<rest_period> = 1000), с возможностью самостоятельно прекратить это ожидание, с пятикратным ускорением времени ([time_speed_multiplier] = 5) и в это время на игрока не может напасть враждебный отряд ([remain_attackable] = 0).
Не удивляйтесь такой большой цифре, т.к. за окончание сбора здесь отвечает треггер и 1000 часов просто максимальное допущение

<rest_period>- на какой период времени идет остановка
[time_speed_multiplier]- мультипликатор скорости течения времени. можно ускорить или замедлить.
[remain_attackable] -  1 - отряд игрока может быть атакован враждебным отрядом во время ожидания.
                                 0 - отряд игрока не может быть атакован враждебным отрядом во время ожидания.
                                 Причём при значении 0 отряд игрока визуально пропадает с карты.

Операции блоков и циклов.

(try_begin), - открывает блок кондиции или блок ветвления.

(else_try), - операция ветвления блока, если один из блоков не прошел проверку. проходясь по всем циклам с использованием этой операции движок остановиться на первом верном, остальные не будут даже рассматриваться.

try_end - закрывает блок или цикл

(try_for_range, <destination>, <lower_bound>, <upper_bound>), - открывает цикл по переменной с установленными границами. начиная с нижней границы до верхней, крайняя верхняя позиция не будет использована.
как пример
(try_for_range, ":chislo", 0, 5), - открывается цикл для переменной ":chislo", в которой записаны числа от 0 до 4.

(try_for_range_backwards, <destination>, <lower_bound>, <upper_bound>), - то же самое что и выше только проверять начнет не с нижней границы а с верхней

(try_for_parties, <destination>), - открывает цикл по всем без исключениям партиям на глобалке.
под переменную попадают партии из файла module_party_templates.py и module_parties.py

(try_for_agents, <destination>), открывает цикл по всем без исключения агентам в сцене.
в переменную попадают лошади, боты, игрок, мертвые, раненые.

(call_script, <script_id>, [<script_param>...]), - операция вызова определенного скрипта из файла module_scripts.py.
[<script_param>...] - указывается параметр скрипта для передачи или переноса данных. работает в обоих направлениях - можно в скрипт передать значение для каких то действий, можно извлечь.

store_script_param_1  (store_script_param_1,<destination>) записывает в <destination> первый параметр скрипта.

store_script_param_2   (store_script_param_2,<destination>) записывает в <destination> второй параметр скрипта.

store_script_param    (store_script_param,<destination>,<script_param_no>) записывает в <destination> параметр скрипта номер <script_param_no>. Используется, если скрипт использует более двух параметров.

(set_result_string, <string_id>), - Есть некоторое количество скриптов, которые вызываются движком игры (начинаются с "game_") и которые должны вернуть движку строку. Вот эта операция - для них. Ещё потенциально может применяться для триггеров, но ЕМНИП триггеров, которые хотят получить строку, в игре нет. В остальном эта операция бесполезна, поскольку её результат средствами скриптовой системы прочитать невозможно.
(Lav, )

Следующие операции используются в трригерах и некоторые параметры за декларированы в самих триггерах.
(см. подробнее header_triggers.py)

(store_trigger_param_1, <destination>), - запишет в переменную первое значение триггера

(store_trigger_param_2, <destination>),  - запишет в переменную второе значение триггера

(store_trigger_param_3, <destination>), - запишет в переменную третий параметр триггера.

(get_trigger_object_position, <position_no>), - запишет в переменную позицию стрелкового оружия для которого используется триггер

(set_trigger_result, <value>), - запишет в переменную значение которое будет установлено триггером.

Операции установок и статистики

(is_trial_version),   -  проверяет пробную версию игры без введеного ключа.

(set_player_troop, <troop_id>), - Незаменимая операция, если необходимо подменить игрока на кого-то ещё при выполнении большинства операций change_screen_, т.к в самих этих операциях можно задать только объект (например с кем торговать), в то время как субъект всегда сам игрок, что не всегда удобно.
Главное после всех манипуляций не забыть снова вернуть игрока на место с помощью (set_player_troop, "trp_player"),

(options_get_damage_to_player, <destination>), вернет в переменную процент урона наносимый игроку.
(options_set_damage_to_player, <value>), позволяет вручную независимо от установок назначить урон игроку
(options_get_damage_to_friends, <destination>), - вернет урон наносимый дружественным ботам - в партии игрока и союзникам
(options_set_damage_to_friends, <value>), назначает урон дружественным ботам.
значения которые веренет/можно назначить
0 - 50% урона
1 - 75% урона
2- 100% урона

(options_get_combat_ai, <destination>),- вернет в переменую текущую сложность поведения ИИ на поле боя
(options_set_combat_ai, <value>), - назначает сложность ИИ на поле боя
(options_get_campaign_ai, <destination>), -вернет текущий уровень ИИ для поведения на глобалке.
(options_set_campaign_ai, <value>), -  назначит уровень ИИ поведения на глобалке
значеня-
0 - высокий
1 - средний
2 - низкий

(options_get_combat_speed, <destination>), вернет скорост времени боя
(options_get_combat_speed, <destination>), назначит скорость времени боя
значения
0 - оч медленно
1 медлено
2 средний
3 быстрый
4 оч быстрый

(get_average_game_difficulty, <destination>), - запишет в переменную  общую сложность игры

(get_achievement_stat, <destination>, <achievement_id>, <stat_index>), - записывает индекс для открытия достижения.
само достижение прописано в module_constants.py

(unlock_achievement, <achievement_id>), - открывает достижение.
Что это, как работает. что дает - без малейшего понятия. в файлах встречал но вразумительно и подробно описать не берусь.

(get_player_agent_kill_count, <destination>, [get_wounded]), - операция вернет в переменную общее количество поверженых врагов, если  [get_wounded] - 0. если 1 подсчет только убитых.

(get_player_agent_own_troop_kill_count, <destination>, [get_wounded]),ведет статистику убитых\раненых союзников.
использование параметра [get_wounded] так же как и выше.

Операции с фракциями

(faction_set_slot, <faction_id>, <slot_no>, <value>),  - записывает в слот фракции значение
(faction_get_slot, <destination>, <faction_id>, <slot_no>), - записывает в переменную значение которое находиться в слоте.
(faction_slot_eq, <faction_id>, <slot_no>, <value>), проверяет равен ли слот фракции значению
(faction_slot_ge, <faction_id>, <slot_no>, <value>), проверяет равен/больше слот чем значение.

(faction_get_color, <color>, <faction_id>) записывает в переменную цвет фракции.

(faction_set_color, <faction_id>, <color>), - назначает цвет фракции.
<color> - цвет в кодовом значении.

(faction_set_name, <faction_id>, <string_id>), позволяет переименовать фракцию. Имя должно быть записано в файле Модуль_стрингс. можно также использовать строковые регистры s1 s2 s3 ...
также можно использовать "быстрый стринг"
пример
(faction_set_name, "fac_kingdom, "@ USSR"),
Это можно использовать везде где используются строковые регистры как какие то параметры.

(store_relation, <destination>, <faction_id_1>, <faction_id_2>), запишет в переменную текущий уровень отношений между 2 определенными фракциями. значение имеет диапазон от -100 до 100

Операции для работы с партиями

(hero_can_join, [party_id]), проверяет может ли бот с флагом Hero присоеденится к партии. если [party_id] не указана подразумевает партию игрока

(hero_can_join_as_prisoner, [party_id]), - проверит может ли присоеденится бот с флагом геро в качестве заключенного. работа с ай ди партии та же

(party_can_join), - проверит может ли партия с которой ведет диалог игрок присоеденится к партии игрока

(troops_can_join, <value>), - проверит имеет ли партия игрока достаточно места для присоденения ботов.

(troops_can_join_as_prisoner, <value>), - проверит на наличее места для присоеденения ботов в качестве заключенных.

(party_can_join_party, <joiner_party_id>, <host_party_id>, [flip_prisoners]), проверит может ли <joiner_party_id> присоедениться к партии <host_party_id> в качестве солдат или заключенных.

(main_party_has_troop, <troop_id>), - проверит  имеет ли партия игрока определенного бота.

(party_is_in_town, <party_id>, <town_party_id>), проверяет наличие определенной партии партии в определенном поселении.

(party_is_in_any_town, <party_id>), проверит находиться ли определенная партия в поселении\центре

(party_is_active, <party_id>), - проверяет активна партия или нет     

(party_set_name, <party_id>, <string_no>),  присваивает имя партии

(remove_party, <party_id>),     убирает партию с глобалки движок перестает ее видеть и учитывать.

(enable_party, <party_id>), активирует дезактивированную партию

(disable_party, <party_id>), отключает активную парию. партия включена в учет системой. и при проверке на цикл (try_for_parties, <destination>), попадет в переменную. можно работать как и с включенной партией
но ии партии и игрок ее не видят

(set_spawn_radius, <value>), назначет радиус спауна для партии из модуль_парти_темплс для следующей операции

(spawn_around_party, <party_id>, <party_template_id>), спаунит партию из парти темплс в радиусе назначенном выше вокруг партии из модуль_парти

(set_party_creation_random_limits, <min_value>, <max_value>), назначает число ботов спаунящейся партии из парти темплс в диапазоне от минимального до максимального. предел диапазана от 0 до 100

(party_get_current_terrain, <destination>, <party_id>), запишет в переменную терраин который в днный момент под ногам партии. значение переменной вернет числом из файла header_terrain_types.py
значения
rt_water = 0
rt_mountain = 1
rt_steppe = 2
rt_plain = 3
rt_snow = 4
rt_desert = 5
rt_bridge = 7
rt_river  = 8
rt_mountain_forest = 9
rt_steppe_forest = 10
rt_forest = 11
rt_snow_forest = 12
rt_desert_forest = 13

из скрытых
rt_deep_ocean = 15
(party_relocate_near_party, <party_id>, <target_party_id>, <value_spawn_radius>), телепортирует партию <party_id> в радиусе <value_spawn_radius> от <target_party_id>.

(party_get_position, <position_no>, <party_id>), - запишет координаты партии в позицию. Используйте pos0 для записи точных координат x y z . используеться на глобалке.

(party_set_position, <position_no>, <party_id>), - телепортирует указаную партию на указаную позицию. используеться на глобалке.

(set_camera_follow_party, <party_id>), назначает движение камеры за определенной партией. в нативе используется для движением за партией у которой игрок в плену

(party_attach_to_party, <party_id>, <party_id to attach to>), привязывает  <party_id> к  <party_id to attach to>
эта операция используется, когда отряды лордов ждут в замке или во время битвы, создавая одну коллективную партию из нескольких

(party_detach, <party_id>), "отвязывает" партию от коллектива. 

(party_collect_attachments_to_party, <party_id>, <destination party_id>), - используется для групповой привязки
(бой на карте где только ИИ?)

(party_get_attached_to, <destination>, <party_id>), возвращает в переменной партию к кторой привязаня  <party_id>

(party_get_cur_town, <destination>, <party_id>),[/b] - Эта операция используется, если партия лорда находится в городе, для определения города. То есть, если партия лорда в городе, то в  <destination> записывается ID города из module_parties.py

(party_get_num_attached_parties, <destination>, <party_id>), - возвращает в переменной число привязанных партий

(party_get_attached_party_with_rank, <destination>, <party_id>, <attached_party_no>),- Если к <party_id> приаттачено несколько партий, эта операция получает энную по номеру. Сколько всего партий приаттачено, сообщает предыдущая операция (party_get_num_attached_parties).(Lav, )

(party_set_extra_text, <party_id>, <string>), добавляет текст к тексту в высвечивающимся окне статуса партии
при наведении указателя мыши

(party_get_icon, <destination>, <party_id>), возвращает в переменной  map_icons используемый партией

(party_set_icon, <party_id>, <map_icon_id>), позволяет назначить иконку для партии

(party_set_banner_icon, <party_id>, <map_icon_id>), назначает баннер из мап иконс для партии при указании
<map_icon_id>-0 убирает баннер.

(party_set_extra_icon, <party_id>, <map_icon_id>, <up_down_distance_fixed_point>, <up_down_frequency_fixed_point>, <rotate_frequency_fixed_point>, <fade_in_out_frequency_fixed_point>), добавляет партии дополнительную иконку. параметры позволяют организовать дополнительной иконке некоторую примитивную анимацию: "прыжки" вверх-вниз на определённое расстояние с определённой частотой, вращение с определённой частотой, исчезновение-проявление с определённой частотой.

(party_add_particle_system, <party_id>, <particle_system_id>), добавляет к иконке партии партикл. в родном используется для горящих деревень.

(party_clear_particle_systems, <party_id>), очищает указаную партию от партикла

(party_get_template_id, <destination>, <party_id>), -  в переменной взвращается ай ди партии из парти_темплс
в основном для работы с операциями партий для парти темплс

Код: [Выделить]

(try_for_parties, ":cur_party"),
(party_get_template_id, ":cur_template", ":cur_party"),
(eq, ":cur_template", "pt_village_farmers"),
(party_set_icon, ":cur_party", "icon_что нибудь"),
(try_end),

(party_set_faction, <party_id>, <faction_id>), назначает партии фракцию

(store_faction_of_party, <destination>, <party_id>), записывает в переменную фракцию партии.

(store_random_party_in_range, <destination>, <lower_bound>, <upper_bound>), записывает в переменную случайную партию из диапазана. позволяет выбрать случайно скажем одну деревню из всех имеющихся.

(store_distance_to_party_from_party, <destination>, <party_id>, <party_id>), запишет и вернет в переменной дистанцию между двумя партиями

(store_num_parties_of_template, <destination>, <party_template_id>), - запишет в переменную число партий определенной парти темплс находящихся на глобалке( например число парий лесных бандитов)

(store_random_party_of_template, <destination>, <party_template_id>), вернет случайную партию из однотипных партий из парти_темплс

(store_num_parties_created, <destination>, <party_template_id>), вернет в переменной общее число порожденных партий одного типа

(store_num_parties_destroyed, <destination>, <party_template_id>), вернет общее число деклассированных (убитых, разрушенных) партий одного типа

(store_num_parties_destroyed_by_player, <destination>, <party_template_id>), - вернет число партий одного типа побежденных игроком

(party_get_morale, <destination>, <party_id>), - вернет текущую мораль партии игрока. значение от 0 до 100

(party_set_morale, <party_id>, <value>), задает значение морали . от0 до 100

Следующие операции используются только в файле module_dialogs.py

(party_join), в конце диалога пария присоеденяется к паритии игрока

(party_join_as_prisoner), в конце диалога партия присоеденяется к партии игрока в качестве заключенных

(troop_join, <troop_id>), в конце диалога с этим ботом он присоеденится к партии игрока

(troop_join_as_prisoner, <troop_id>), в конце диалога с эитм ботом он присоеденится к партии игрока в качестве пленника
-------------------------------------------конец операция в модуль_диалог

(add_companion_party, <troop_id_hero>), - добавляет к партии игрока бота с флагом геро

(party_add_members, <party_id>, <troop_id>, <number>), добавляет к партии указанное число ботов
общее число будет записано в reg0

(party_add_prisoners, <party_id>, <troop_id>, <number>), - добавляет указаное число ботв в качестве пленных к партии . число вернется в reg0

(party_add_leader, <party_id>, <troop_id>, [<number>]), добавляет к партии бота и делает его(их) лидером.
(по всей видимости для говорящего бота для диалогов с партиями х.з.)

(party_force_add_members, <party_id>, <troop_id>, <number>), добавит ботов к партии насильно без учета лимита партии.( только героев?)

(party_force_add_prisoners, <party_id>, <troop_id>, <number>),добавит ботов к партии в качестве пленных насильно без учета лимита партии.( только героев?)

(party_add_template, <party_id>, <party_template_id>, [reverse_prisoner_status]), добавлят к партии партию из парти темлс
[reverse_prisoner_status] либо подкрепление либо заключенные.

(distribute_party_among_party_group, <party_to_be_distributed>, <group_root_party>), - распределяет между партиями ИИ после боя заключенных и подкрепление в виде освобожденных ботов

(remove_member_from_party, <troop_id>, [party_id]), удаляет из партии бота с флагом геро. Для партии игрока  [party_id] не указывается

(remove_troops_from_prisoners, <troop_id>, <value>), удаляет заданое число пленных из партии игрока.

(party_remove_members, <party_id>, <troop_id>, <number>), удаляет заданное число ботов одного вида из партии
количество запишется в reg0

(party_remove_prisoners, <party_id>, <troop_id>, <number>),, удаляет заданое количество ботов одного типа из партии . количество сохранится в reg0

(party_clear, <party_id>), - удаляет из партии и солдат и пленных

(add_gold_to_party, <value>, <party_id>), добавляет заданое число денег партии

(party_get_num_companions, <destination>, <party_id>), вернет общее число бойцов в партии включительно лидера

(party_get_num_prisoners, <destination>, <party_id>), - запишет в переменную общее количество пленных в данной партии

(party_count_members_of_type, <destination>, <party_id>, <troop_id>), - вернет общее количество ботов определенного вида

(party_count_prisoners_of_type, <destination>, <party_id>, <troop_id>), вернет общее количество пленных ботов одного типа

(party_get_free_companions_capacity, <destination>, <party_id>), вернет число свободных мест для бойцов в партии

(party_get_free_prisoners_capacity, <destination>, <party_id>), - вернет общее число свободных мест для пленников в партии

(party_get_num_companion_stacks, <destination>, <party_id>), вернет число занятых стэков для типов ботов
включает стеки для героев и игрока
(party_get_num_prisoner_stacks, <destination>, <party_id>), вернет количество занятых  стеков для пленных в партии. включает число для героев   

(party_stack_get_troop_id, <destination>, <party_id>, <stack_no>), запишет определенного бота из определенного стэка в переменную

(party_stack_get_size, <destination>, <party_id>, <stack_no>), запишет число ботов в определенном стэке

(party_stack_get_num_wounded, <destination>, <party_id>, <stack_no>), запишет число раненых ботов в определенном стэке

(party_get_prisoner_stack_troop, <destination>, <party_id>, <stack_no>), запишет определенных ботов из определенного стэка пленных

(party_get_prisoner_stack_size, <destination>, <party_id>, <stack_no>), - запишет число ботов в определенном стэке пленных

(party_prisoner_stack_get_troop_dna, <destination>, <party_id>, <stack_no>), - запишет в переменную
днк юнита находящегося в партии.

(party_stack_get_troop_dna, <destination>, <party_id>, <stack_no>), - запишет в переменную днк юнита
находящегося в партии в качестве заключенного.
Пояснения ДНК от shturmfogel

что такое "dna": на сколько я понял это некое число, на основании которого движок определяет как будет выглядеть  компьютерный болванчик и, возможно, как он будет одет (какие шмотки из имеющихся у него он выберет, чтобы показаться в сцене). Это распространяется на обычных болванчиков, не на NPC.
думаю party_stack_get_troop_dna позволяет получить вид бота, который будет показан в окне партии но не уверен
я использовал dna так: добавление священника в мирную сцену деревни, священник не имеет флага "герой", в модуле тропс это всего один юнит. Однако в сцене конкретной деревни священник будет появлятся всегда с одним лицом и насколько я могу судить в одном и том же наборе одежды, т.е. он как бы там живет и не спаунится по всей кальдарии при появлении ГГ:)

для проверки первый вариант - священник спаунится каждый раз со случайно выбраным лицом:

Код: [Выделить]

(try_begin),
(party_slot_ge,"$current_town",slot_center_has_cerkov,1),
(assign, ":walker_troop_id", "trp_village_priest"),
(store_random_in_range, ":cur_dna", 1, 1000000),
(set_visitor, town_walker_entries_start, ":walker_troop_id",":cur_dna"),
(try_end),

второй вариант - священник при первой встречей с ГГ выбирает случайным образом себе личину и потом в этой сцене появляется только с этим лицом
выбранный dna заносится в слот и при последующих спаунах применяется только этот dna, создается иллюзия, что в каждой деревне индивидуальный болванчик, хотя он один на всех

Код: [Выделить]

(try_begin),
(party_slot_ge,"$current_town",slot_center_has_cerkov,1),
(assign, ":walker_troop_id", "trp_village_priest"),
(store_add,":cur_slot_dna",sa_troop_slot_end,"$current_town"),
(troop_get_slot,":cur_dna",":walker_troop_id",":cur_slot_dna"),
(try_begin),
(eq,":cur_dna",0),
(store_random_in_range, ":cur_dna", 1, 1000000),
(troop_set_slot,":walker_troop_id",":cur_slot_dna",":cur_dna"),
(try_end),
(set_visitor, town_walker_entries_start, ":walker_troop_id",":cur_dna"),
(try_end),

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

(store_party_size, <destination>,[party_id]), запишет общее число бойцов и пленных в партии. без опции парти_ид
по умолчанию партию игрока

(store_num_regular_prisoners, <destination>, <party_id>), запишет в переменную общее количество пленных без учета героев

(party_add_xp_to_stack, <party_id>, <stack_no>, <xp_amount>),позволяет добавить определенное число хр определенному стэку в партии

(party_upgrade_with_xp, <party_id>, <xp_amount>, <upgrade_path>), -распределяет указанное число хр между всеми ботами и делает апгрейд если бот достиг уровня для апгрейда.
значения для апгрейда
0 - случайно
1 - первый путь (апгрейд2 в модуль трупс)
2 - второй путь (апгрейд2 в модуль трупс)

(party_add_xp, <party_id>, <xp_amount>), добавляет хр партии и распределяется между всеми участниками партии

(party_get_skill_level, <destination>, <party_id>, <skill_no>), запишет уровень скилла партии имеющей героя скилл для партии общий.(не личный)

(heal_party, <party_id>), лечит  партии

(party_wound_members, <party_id>, <troop_id>, <number>), - делает ранеными определенное количество ботов одного типа в партии

(party_remove_members_wounded_first, <party_id>, <troop_id>, <number>), удаляет из партии ботов начиная с раненых. общее число запишеться в reg0

(party_quick_attach_to_current_battle, <party_id>, <side>), добавит указаную партию к битве на указаной стороне
значение side
0- союзник
1 враг
(party_get_battle_opponent, <destination>, <party_id>) запишет в переменную противника партии если она ведет бой.

(inflict_casualties_to_party, <parent_party_id>, <damage_amount>, <party_id_to_add_causalties_to>), -авторасчет раненых и убитых ботов для ИИ партий.

Эти операции используются только для ИИ партий

(party_set_marshall, <party_id>, <value>),назначает или очищает партию от звания маршал.
значение или 0(очищает) или 1(назначает).

(party_set_flag, <party_id>, <flag>, <clear_or_set>), задает или убирает определенный флаг из файла header_parties.py (пояснение флагов будет позже в отдельном посте)
<clear_or_set> 0- снимает определенный флаг, 1 - назначает.

(party_set_aggressiveness, <party_id>, <number>), - задает величину агрессивности для партии .
<number> - имеет диапазон от 0 до 15.   15 -максимальное значение агрессивности.
агрессивность влияет на способность партии атаковать другие отряды при наивысшей паритя будет атаковать любой отряд не зависимо от размера атакуемой партии.

(party_set_courage, <party_id>, <number>), - задает кураж (как долго партия будет преследовать другую партию.) значение <number> - от 4 до 15

(party_get_ai_initiative, <destination>, <party_id>), запишет в переменную текущею инициативу партии в диапазоне от 0 до100.

(party_set_ai_initiative, <party_id>, <value>), позволяет назначить инициативу партии в диапазоне от 0 до 100

(party_set_ai_behavior, <party_id>, <ai_bhvr>), назначает ИИ партии поведение.

флаги для ИИ поведения в файле header_parties.py описание будет позже.


(party_set_ai_object, <party_id>, <object_party_id>), при задании линии поведения операцией выше скажем
ai_bhvr_travel_to_party(следовать к партии) - эта операция задает партию которая будет являться целью путешествия .


(party_set_ai_target_position, <party_id>, <position_no>), задает партии движении к определенной позиции
на глобальной карте.  при флаге ai_bhvr_travel_to_point

(party_set_ai_patrol_radius, <party_id>, <radius_in_km>), задает радиус патрулирования партии при при линии поведения заданой флагами
ai_bhvr_patrol_location
ai_bhvr_patrol_party   
значение числовое в км придется вычислять методом тыка или с помощью вот такого триггера
в файл module_triggers.py

Код: [Выделить]

(0.1, 0, 0, [(party_get_position, pos1, "p_main_party"),
        (party_get_position, pos2, "p_Bridge_37"),
      (get_distance_between_positions_in_meters, reg1, pos1, pos2)       
],
[(display_message,"@ {reg1}.",0xFF4040)
]),


(party_ignore_player, <party_id>, <duration_in_hours>), задает партии ИИ игнорирование партии игрока определенное время. <duration_in_hours> - внутри игровое время в часах.

(party_set_bandit_attraction, <party_id>, <attaraction>), не уверен, но по всей видимости задает партии привлекательность для нападения партий с флагом поведения бандит. значение от 0 до 100


(party_get_helpfulness, <destination>, <party_id>),- заисывает полезность партии в значении от 0 до 100
(party_set_helpfulness, <party_id>, <number>), - задает полезность партии от 0 до 10 000 дефлолтное 100. устанавливает уровень стремления помочь союзнику (вступить в уже идущее сражение)


(get_party_ai_behavior, <destination>, <party_id>), возвращает в переменную ai_behavior используемый партией.

(get_party_ai_object, <destination>, <party_id>), возвращает в переменную партию заданную как цель
для  <party_id>

(party_get_ai_target_position, <position_no>, <party_id>), возвращает заданную позицию цель для партии.

 (get_party_ai_current_behavior, <destination>, <party_id>), - вернет в переменную поведение партии
которое было назначено до определенных событий. Как пример возвращение  к действиям партии предшествующим  преследованию ее другой партией.

(get_party_ai_current_object, <destination>, <party_id>), запишет в переменную партию которая сделала сбой поведения  <party_id>.

Операции по работе с Итемом.

(item_set_slot, <item_id>, <slot_no>, <value>), - запишет в слот итема значение

(item_get_slot, <destination>, <item_id>, <slot_no>), запишет в переменную значение из слота итема

(item_slot_eq, <item_id>, <slot_no>, <value>), Проверит равенство значения в слоте итема значению

(item_slot_ge, <item_id>, <slot_no>, <value>),проверит что значение в слоте итема больше или равно значению.

(item_get_type, <destination>, <item_id>), - запишет в переменную тим итема . Типы итема указаны в файле header_items.py и имеют приставку itp_type_ . Значения каждого флага позже

(store_item_value, <destination>, <item_id>), - запишет в переменную номинальную цену которая назначена вещи в файле module_items.py ( без учета модификаторов вещей)

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

(set_price_rate_for_item_type, <item_type_id>, <value_percentage>), назначает цену определенному <item_type_id> - тип итема. Типы итема указаны в файле header_items.py и имеют приставку itp_type_ .

(set_merchandise_modifier_quality, <value>), - значение - процент вероятности появления в продаже у торговца вещей с модификаторами.

(reset_item_probabilities, <value>), - устанавливает предмету частоту встречаемости в продаже  иную, чем диктует параметр abundance. Предполагаю необходимо, чтобы ассортимент торговца отражал обилие товара в деревне или городе (в нативе применяется именно к товарам, не к оружию).

(set_item_probability_in_merchandise, <item_id>, <value>), возвращает предмету исходную частоту встречаемости в продаже. Кстати, предметы в луте тоже формально "продаются".

Операции для работы с Troops (бот)

(troop_has_item_equipped, <troop_id>, <item_id>), - проверит что определенный бот имеет /оборудован
(одет или вооружен) определенным итемом.

(troop_is_mounted, <troop_id>), - проверит что бот имеет флаг tf_mounted (задается в файле  module_troops.py определяет бота как всадника ). Операция не проверит на наличие у заданного бота лошади.
Флаги см. в файле header_troops.py

(troop_is_guarantee_ranged, <troop_id>), - проверит что бот имеет флаг tf_guarantee_ranged (флаг задает
обязательное оборудование бота вещью/оружием. Например если стоит флаг tf_guarantee_helmet - бот обязательно получит шлем при загрузке сцены). Операция не проверит на наличие оборудования которое задано как гарантированное. Флаги см. в файле header_troops.py

(troop_is_guarantee_horse, <troop_id>),- проверит что бот имеет флаг tf_guarantee_horse . не проверяет
на наличие лошади

(troop_is_hero, <troop_id>), - проверит что заданный бот имеет флаг tf_hero . К таким ботам относятся
игрок, Лорды, торговцы, спутники игрока, леди ... смотрите в оригинальной МС в файле module_troops.py  начиная с "tournament_master".

(troop_is_wounded, <troop_id>), - проверит что заданный бот ранен. Операция работает только с ботами имеющими флаг tf_hero.

(player_has_item, <item_id>), проверит что игрок имеет определенный итем. проверит как то что оборудовано
так и то что находится в вещевых слотах.

 (troop_set_slot, <troop_id>, <slot_no>, <value>), - запишет в слот бота значение
(troop_get_slot, <destination>, <troop_id>, <slot_no>), - запишет в переменную значение слота бота
(troop_slot_eq, <troop_id>, <slot_no>, <value>),проверит значение которое находится в слоте равно значению <value>
(troop_slot_ge, <troop_id>, <slot_no>, <value>),проверит что значение в слоте бота больше или равно значению <value>

(troop_set_type, <troop_id>, <gender>), операция задает боту тип из файла module_skins.py.
в оригинале используется два типа  - man (мужчина) и woman (женщина). Назначены они сразу в module_troops.py
флагами tf_male и tf_female.

Позволяет задать новый тип, который предварительно будет создан в  module_skins.py.

(troop_get_type, <destination>, <troop_id>), запишет в переменную тип данного бота. в оригинале запишет
или 0 - tf_male или 1 - tf_female

(troop_set_class, <troop_id>, <value>), - назначает боту класс. К ним относятся
grc_infantry = 0 - пехота
grc_archers  = 1 - стрелки
grc_cavalry  = 2 - кавалерия
grc_heroes   = 3 - класс геро
от 4 до 8 - можно назначить по своим потребностям
grc_everyone = 9  - флаг определяющий все имеющиеся классы. в операции не используется

В <value> можно вписывать как цифру обозначающую класс так и имя флага. записи имеют такой вид
(troop_set_class, "trp_Constable_Hareck", 0), либо  (troop_set_class, "trp_Constable_Hareck",grc_infantry),

(troop_get_class, <destination>, <troop_id>), запишет в переменную класс заданный  определенному боту.
запишет значение от 0 до 8. (9 - не учитывается)

(class_set_name, <sub_class>, <string_id>), - позволяет записать имя для класса для отображения в окне партии.

(add_xp_to_troop, <value>, [troop_id]), - добавляет или убавляет (с знаком -) число хит поинтов (опыта). Операция работает только для игрока (запись без [troop_id]) и ботов с флагом геро.

(add_xp_as_reward, <value>), - Добавляет указанное число хит поинтов игроку.

(troop_get_xp, <destination>, <troop_id>) запишет в переменную имеющееся количество хит поинтов(опыт)

(store_attribute_level, <destination>, <troop_id>, <attribute_id>), запишет в переменную текущий уровень атрибутов.  к атрибутам относятся
ca_strength     = 0   сила
ca_agility      = 1      ловкость
ca_intelligence = 2   интелект
ca_charisma     = 3   харизма

(troop_raise_attribute, <troop_id>, <attribute_id>, <value>), позволяет добавить или отнять количество
очков заданного атрибута. Для уменьшения нужно использовать отрицательное число.
При работе с ботами не имеющими флаг геро изменение будет для всего типа.

(store_skill_level, <destination>, <skill_id>, [troop_id]), - запишет в переменную текущий уровень скилла.
Скиллы смотрите в файле module_skills.py

(troop_raise_skill, <troop_id>, <skill_id>, <value>), изменяет заданный скилл на заданое число.
работает с положительным и отрицательным числом. Для ботов не имеющим флаг геро изменение будет для всего типа.

(store_proficiency_level, <destination>, <troop_id>, <attribute_id>), запишет в переменную текущий уровень заданного  атрибута  владением оружия
атрибуты

wpt_one_handed_weapon = 0  - одноручное оружие
wpt_two_handed_weapon = 1  - двуручное оружие
wpt_polearm           = 2              - полеармы (древковое)
wpt_archery           = 3               - лук
wpt_crossbow          = 4             - арбалет
wpt_throwing          = 5              - метательное
wpt_firearm           = 6                - огнестрел

(troop_raise_proficiency, <troop_id>, <proficiency_no>, <value>),изменяет заданный атрибут владения оружием на заданое число. работает с положительным и отрицательным числом. Для ботов не имеющим флаг геро изменение будет для всего типа.

(troop_raise_proficiency_linear , <troop_id>, <proficiency_no>, <value>), - работает также как операция выше, но позволяет насильно без учета скилла weapon_master добавить или отнять заданное число  от заданного атрибута владением оружием

(troop_add_proficiency_points, <troop_id>, <value>), добавит к  уровню владением оружием которой имеет бот заданное число.

(store_troop_health, <destination>, <troop_id>, [absolute]), -запишет в переменную текущий уровень жизни юнита.
[absolute] значение-
0 - запишет процентное значение.
1 - запишет количество хит поинтов.

(troop_set_health, <troop_id>, <relative health (0-100)>), - добавит юниту жизни в процентном соотношении.

(troop_get_upgrade_troop, <destination>, <troop_id>, <upgrade_path>), - запишет в переменную юнита  которого имеет <troop_id> как путь апгрейда.

например юнит имеет апгрейд (см в модуль_трупс)
upgrade2(troops,"watchman","caravan_guard","mercenary_crossbowman")

<upgrade_path> значение -
0- вернет тот кторый проставлен первым в пути. из примера "caravan_guard"
1 - вернет проставленного вторым. из примера "mercenary_crossbowman"
если юнит не имеет апгрейда вернет -1

(store_character_level, <destination>, [troop_id]), - запишет в переменную текущий уровень развития юнита. по умолчанию используется trp_player

(get_level_boundary, <destination>, <level_no>), - Возвращает, сколько экспы надо для уровня.

(troop_set_auto_equip, <troop_id>, <value>), - автоэкипировка юнита вещами которые он имеет в инвентаре.
<value> - позволяет
0 - запретить автоэкипировку
1 - назначить ее.

(troop_ensure_inventory_space, <troop_id>, <value>), - удаляет из слота, заданого <value>, инвентаря
вещи.

(troop_sort_inventory, <troop_id>), -  сортирует вещи в инвентаре торговца по цене.

(troop_add_merchandise, <troop_id>, <item_type_id>, <value>), - добавляет юниту торговцу вещи
по типам. задается тип итема из хедер_итемс. Добавит вещи только с флагом itp_merchandise

(troop_add_merchandise_with_faction, <troop_id>, <faction_id>, <item_type_id>, <value>), - добавляет вещи торговцу только специфической фракции. принадлежность вещи фракции задается флагом в модуль_итемс.

(troop_add_item, <troop_id>, <item_id>, [modifier]), - добавляет юниту определенную вещь с определенным модификатором.

(troop_remove_item, <troop_id>, <item_id>), - удаляет определенную вещь из инвентаря или экипировки юнита.

(troop_clear_inventory, <troop_id>), - удаляет все вещи из инвентаря юнита. не работает с экипировкой.

(troop_equip_items, <troop_id>), - заставляет пересмотреть юнита свою экипировку и то что есть в инвентаре и заменить вещи на более лучшие по показателям. не совсем корректно работает с оружием.

(troop_inventory_slot_set_item_amount, <troop_id>, <inventory_slot_no>, <value>),  - позволяет добавить юниту вещи имеющие численное количество. например еда, боеприпасы (стрелы болты пули).
Добавляет к экипировке или инвентарю.
<value> - количество.
если к экипировке -
<inventory_slot_no> - используется флаг из хедер_итемс.
ek_item_0 = 0 слот оружия
ek_item_1 = 1 слот оружия
ek_item_2 = 2 слот оружия
ek_item_3 = 3 слот оружия
ek_head   = 4 слот для головного убора
ek_body   = 5 слот брони
ek_foot   = 6 слот для сапог
ek_gloves = 7 слот для перчаток
ek_horse  = 8 слот для лошади
ek_food   = 9 слот для еды.



(troop_inventory_slot_get_item_amount, <destination>, <troop_id>, <inventory_slot_no>), запишет в переменную количество итема находящегося в слоте ek_  или инвентаре

(troop_inventory_slot_get_item_max_amount, <destination>, <troop_id>, <inventory_slot_no>), запишет в переменную максимальное количество которое имеет слот. например если в слоте у юнита 20 стрел из 30,
то в переменную запишет число 30, как максимально возможное которое имеет данный вид боеприпасов.

(troop_add_items, <troop_id>, <item_id>, <number>), - позволяет добавить юниту определенное число заданной вещи.
<number> - количество <item_id>.

(troop_remove_items, <troop_id>, <item_id>, <number>), - удаляет заданное число заданных вещей у юнита. общее количество изъятых вещей поместится в reg0.

(troop_loot_troop, <target_troop>, <source_troop_id>, <probability>), - добавляет с заданной вероятностью <probability> (процент?)  <target_troop> вещи которые есть в инвентаре <source_troop_id>.
у <source_troop_id> вещи не изымаются.

(troop_get_inventory_capacity, <destination>, <troop_id>), - запишет в переменную общее количество
слотов инвентаря и экипировки для данного юнита.

(troop_get_inventory_slot, <destination>, <troop_id>, <inventory_slot_no>), запишет в переменную
ай-ди вещи находящуюся в определенном слоте экипировки или инвентаря.

(troop_get_inventory_slot_modifier, <destination>, <troop_id>, <inventory_slot_no>), - запишет в переменную модификатор вещи находящуюся в определенном слоте экипировки или инвентаря.

(troop_set_inventory_slot, <troop_id>, <inventory_slot_no>, <item_id>), - помещает определенную вещь в слот инветаря или экипировки заданного юнита.

(troop_set_inventory_slot_modifier, <troop_id>, <inventory_slot_no>, <imod_value>), - назначает модификатор для вещи находящейся в определенном слоте инвентаря или экипировки.

(store_item_kind_count, <destination>, <item_id>, [troop_id]), - запишет в переменную количество заданной вещи у юнита. (по умолчанию ,без [troop_id]  trp_player)

(store_free_inventory_capacity, <destination>, [troop_id]), - запишет в переменную общее количество свободных слотов у юнита. по умолчанию trp_player

(troop_set_name, <troop_id>, <string_no>), -  назначает новое имя для юнита.

(troop_set_plural_name, <troop_id>, <string_no>), - назначает новое множественное имя для юнита.

(troop_set_face_key_from_current_profile, <troop_id>), - назначает юниту фейс код из мультиплеерного профиля игрока.

(troop_add_gold, <troop_id>, <value>), - добавляет заданному юниту определенное количество денег.
используется для игрока и юнитов героев.

(troop_remove_gold, <troop_id>, <value>), - отнимает у заданного юнита определенное количество денег. работает только для игрока и юнитов героев

(store_troop_gold, <destination>, <troop_id>), - записывает в переменную сумму денег которую имеет юнит.

(troop_set_faction, <troop_id>, <faction_id>), - назначает юниту фракцию. в Нативе используется для перебежек лордов.

(store_troop_faction, <destination>, <troop_id>), - запишет в переменную фракцию к которой принадлежит юнит.

(store_faction_of_troop, <destination>, <troop_id>), - аналогичная операция той что выше.

(troop_set_age, <troop_id>, <age_slider_pos>), - назначает юниту возраст. происходит генерация нового кода типа лица с старением или омоложением.

Математические операции , дополнение.

Примечание: - в МС отсутствует работа с дробными числами.

(neg|<operation>), - операция обратного действия любой операции.

пример -

(party_slot_eq, "$current_town", slot_town_lord, "trp_player"),- последующие за этой строкой операции сработают только в том случае если владелец города игрок.

(neg|party_slot_eq, "$current_town", slot_town_lord, "trp_player"), - при использовании neg последующие операции сработают только для тех городов которыми не владеет игрок и не будут работать для городов которые находятся во владении игрока.

(this_or_next|<operation>),- this_or_next группирует однотипные операции в блок или. дословно перевод это или следующее.

Пример

Код: [Выделить]

(this_or_next|eq, ":chislo", 1),
(this_or_next|eq, ":chislo", 2),
(eq, ":chislo", 3),(eq - операция равенства. в данном примере проверяет что ":chislo" равно какому то значению)
последующие за этим блоком строки сработают в случае если переменная ":chislo" равна 1 ИЛИ 2 ИЛИ 3.
без использования this_or_next следующие операции сработают только если ":chislo" будет равно и 1, и 2, и 3,
Синтаксис - в последней строке this_or_next не используется.[/div]

(gt, <value1>, <value2>), - операция проверяет что  <value1> больше чем  <value2>.

(ge, <value1>, <value2>), проверяет что <value1> больше или равно <value2>

(eq, <value1>, <value2>), - проверяет что <value1> равно <value2>

(neq, <value1>, <value2>),- проверяет что <value1> не равно <value2>
 
(le, <value1>, <value2>), - проверяет что <value1> меньше или равно <value2>

(lt, <value1>, <value2>), - проверяет что <value1> меньше  <value2>

(is_between, <value>, <lower_bound>, <upper_bound>), операция проверит что <value> больше или равно <lower_bound> и меньше <upper_bound>.

(assign, <destination>, <value>), операция утверждение. записывает в переменную значение.

(store_add, <destination>, <value>, <value>), - запишет в переменную сумму двух значений.
формула - <destination> = <value> + <value>

(store_sub, <destination>, <value>, <value>), - запишет в переменную разницу двух значений
формула - <destination> = <value> - <value>

(store_mul, <destination>, <value>, <value>), - запишет в переменную результат умножения значения на значение.
формула <destination> = <value> * <value>

(store_div, <destination>, <value>, <value>), - запишет в переменную результат деления значеня на значение
формула <destination> = <value> / <value>

(store_mod, <destination>, <value>, <value>), - это вычисление остатка от деления value1 на value2.
То есть:
(store_mod, reg0, 5, 2), ## reg0 = 1


(val_min, <destination>, <value>), - устанавливает что значение в переменной не может быть ниже значения <value>

(val_max, <destination>, <value>), - устанавливает что значение которое находится в переменой не может превышать <value>

(val_clamp, <destination>, <lower_bound>, <upper_bound>), - устанавливает диапазон для переменной
от нижнего предела <lower_bound> до верхнего <upper_bound> (<upper_bound> = <upper_bound>  - 1 )

(val_abs, <destination>),- Абсолютное значение (т.е. если отрицательное - станет положительным).

(store_random_in_range, <destination>, <range_low>, <range_high>), запишет в переменную случайное число находящееся в диапазоне <range_low>(нижний предел), <range_high>(верзний предел -1)

(shuffle_range, <reg_no>, <reg_no>), - Берёт указанный диапазон регистров, и случайно "перетасовывает" их значения. В коде обычно используется для рандомизации порядка (например, порядка в котором бойцы сражаются на арене).

(store_or, <destination>, <value>, <value>), - ИЛИ

(store_and, <destination>, <value>, <value>), - И

(val_or, <destination>, <value>), - ИЛИ

(val_lshift, <destination>, <value>), - Побитовое смещение влево

(val_rshift, <destination>, <value>), - Побитовое смещение вправо

(set_fixed_point_multiplier, <value>), -  множитель для работы с дробными числами. дефолтное <value>
 один.
после назначения множителя<value>  в последующих операциях числовое значение будит делится на <value>.
пример -
(set_fixed_point_multiplier, 100),
(entry_point_get_position, pos1, 0), - операция записывающая в  pos1 координаты энтри поинт № 0
(position_move_z, pos1, 150), передвинет pos1 на 1,5 метра (не на 150, как указано) по z оси

(convert_to_fixed_point, <destination_fixed_point>), -  конвертирует целое число в дробное умножая на заданный множитель

(convert_from_fixed_point, <destination>), - извлекает целое число из дробного деля на заданный множитель

(store_sqrt, <destination_fixed_point>, <value_fixed_point>),- запишет в переменную корень квадратный

(store_pow, <destination_fixed_point>, <value_fixed_point>, <value_fixed_point), - запишет в переменную число взведенное в степень

(store_sin, <destination_fixed_point>, <value_fixed_point>), - синус числа

(store_cos, <destination_fixed_point>, <value_fixed_point>),- косинус числа

(store_tan, <destination_fixed_point>, <value_fixed_point>),тангенс числа

(store_asin, <destination_fixed_point>, <value_fixed_point>), арксинус числа

(store_acos, <destination_fixed_point>, <value_fixed_point>), арккосинус числа

(store_atan, <destination_fixed_point>, <value_fixed_point>), - атангенс

(store_atan2, <destination_fixed_point>, <value_fixed_point>, <value_fixed_point>), вычисление угла по значениям катетов

Операции по работе с квестами

(quest_set_slot, <quest_id>, <slot_no>, <value>), - запишет в слот значение для квеста

(quest_get_slot, <destination>, <quest_id>, <slot_no>),  запишет в переменную значение из слота

(quest_slot_eq, <quest_id>, <slot_no>, <value>), проверит равенство значения в слоте и значения

 (quest_slot_ge, <quest_id>, <slot_no>, <value>), - проверит что значение в слоте больше или равно значению.

(start_quest, <quest_id>, <giver_troop_id>), - задает старт квеста и отмечает юнита который выдал квест

(check_quest_active, <quest_id>), - проверит что квест в активной фазе ( не провален и не завершен)

(check_quest_finished, <quest_id>), - проверит что заданый квест завершен.

(check_quest_failed, <quest_id>), - проверит что заданный квест был провален

(check_quest_succeeded, <quest_id>), - проверит что задданый квест выполнен

(check_quest_concluded, <quest_id>) - проверит на завершенность квеста, но с учетом того что квест завершен не так как того хотел наниматель.

(conclude_quest, <quest_id>), - установит квест завершенным, с учетом того что квест завершен не так как хотел того наниматель.

(succeed_quest, <quest_id>), - устанавливает что квест завершен но игрок должен вернутся к юниту который его выдал для завершения квеста.

(complete_quest, <quest_id>), устанавливает что заданный квест завершен. изымает информацию из списка активных квестов

(fail_quest, <quest_id>), - устанавливает что заданный квест провален. из списка не изымает - игрок должен поговорить с юнитом выдавшим квест

(cancel_quest, <quest_id>), - отменяет квест
может быть устанавливает завершение многоступенчатого квеста

(store_partner_quest, <destination>), - запишет в переменную ID юнита  выдавшего квест.

Операции для работы с звуком, музыкой.

(play_sound, <sound_id>, [options]), - проигрывает заданный звук. [options] - опционально можно установить флаг из файла header_sounds.py

(play_sound_at_position, <sound_id>, <position_no>, [options]), - проиграет звук из заданной позиции.
[options] - опционально можно установить флаг из файла header_sounds.py

(stop_all_sounds, [options]), - останавливает звук. (трэк?)
 [options] -
0 - остановит текущий звук позволив проиграть до конца
1 - остановит его медленно с угасанием звука
2 - остановит немедленно.

(play_track, <track_id>, [options]), - проигрывает трэк из файла module_music.py.
[options]
0 -  проигрывать заданный после звучащего
1 -  угасание звучащего и проигрывание заданного
2 - резкая смена играющего на заданный

(play_cue_track, <track_id>), - будет проигрывать заданный трэк совместно с играющим.

(music_set_situation, <situation_type>), - задает ситуацию для проигрывания трэка. флаг см. в header_music.py . трэки для проигрывания в ситуациях задаются в строке самого трэка.
также есть скрипт music_set_situation_with_culture  который можно вызвать для проигрывания нужного трэка, который задан скажем для культуры_1 и должен играть в таверне.

(music_set_culture, <culture_type>), - задает культуру для проигрывания трэка. флаг см. в header_music.py . трэки для проигрывания для определенных культур задаются в строке самого трэка.

Операции для работы с клавиатурой , мышью

назначение клавиш см. подробнее в header_triggers.py

(key_is_down, <key_id>), - проверит что была зажата определенная клавиша.

(key_clicked, <key_id>), - проверит что было ,,клацанье,, по определенной клавише

(key_is_down, <game_key_id>), - проверит что определенная клавиша зарегистрированная в движке зажата (например клавиша движения вперед)

(key_clicked, <game_key_id>), - проверит что определенная клавиша зарегистрированная в движке кратковременно нажата

(mouse_get_position, <position_no>), - запишет в позицию X и Y координаты указателя мыши

(omit_key_once, <key_id>), - единовременно заставит движок проигнорировать нажатие определенной клавишы зарегистрированной в движке

(clear_omitted_keys),- Очень специфическая операция, и вроде как по моим экспериментам - совершенно бесполезная. Однако же, используется. В общем, если мы где-то перехватываем значения клавиш, которые используются для управления игрой (I, P, C итд.), то лучше в конце триггера/презентации сделать вызов clear_omitted_keys - сугубо на всякий случай и для очистки совести. В конце-концов, скриптеры Taleworlds так делают, чем мы хуже?(Lav,)

Операции вызывающие игровые окна зарегистрированные в движке

(change_screen_return),- используется в module_game_menus.py для выхода на глобальную карту

(change_screen_loot, <troop_id>), - открывает окно луттинга используя для этого инвентарь определенного юнита.

(change_screen_trade, [troop_id]), - использутся для вызова окна торговли в файле module_dialogs.py.
 [troop_id] - опция, дефолтно будет вызван инвентарь для торговли того юнита с кем происходит диалог

(change_screen_trade_prisoners),  - открывает окно продажи юнитов находящихся у игрока в качестве пленных. юнит с флагом геро не может быть продан. цена на заключенных регулируется в зависимости от уровня в
script_game_get_prisoner_price в файле module_scripts.py

(change_screen_view_character), - открывает окно характеристик юнита с которым ведется диалог.
вызывается окно только из файла module_dialogs.py

(change_screen_mission), - используется для перехода в сцену.перед операцией должна быть указана сцена и миссия из файла module_mission_templates.py

(change_screen_map_conversation, <troop_id>), открывает окно диалога при встрече партии игрока с активной партией на глобальной карте. Используется операция в
script_setup_troop_meeting
script_setup_party_meeting
с вызовом сцены для встречи из script_get_meeting_scene
в файле module_scripts.py

(change_screen_equip_other, [troop_id]), - вызывает окно экипировки юнита. работает только из файла
module_dialogs.py. [troop_id] - опционально и будет подразумевать собеседника

(change_screen_map), - закрывает окна сцены диалога или меню с выходом на глобальную карту

(change_screen_notes, <note_type>, <object_id>), - открывает окно заметок(notes) -
<note_type> -
1 - юнит
2 - фракция
3 - партия
4 - квест
5 - страница информации.
<object_id> - объект типа
например
(change_screen_notes, 2, "fac_nord"), - откроет окно с информацией о фракции норд

(change_screen_quit), - выход из игры в меню

(change_screen_give_members, [party_id]), - -открывает окно передачи юнитов в другую партию. без [party_id] подразумевает партию с которой встретился игрок

(change_screen_exchange_members, [0,1 = exchange_leader], [party_id]), - вызывает окно гарнизона или изъятия с определенным лордом
0 - нельзя изъять из партии или передать юнита с флагом геро(лидера партии)
1 - можно изъять из партии или передать юнита с флагом геро(лидера партии)

[party_id] - опционально. если не указана, то будет поразумеваться та партия с которой произошла встреча игрока
(нас пункт либо активная партия)

Если подразумевается двухсторонний обмен с изъятием и отдачей то используются обе операции.

(change_screen_exchange_with_party, <party_id>), дублирующая операция (change_screen_exchange_members), но без выбора о возможности передачи лидера партии

(change_screen_controls), - вызывает окно конроля
(change_screen_options), - вызывает окно опций


(start_map_conversation, <troop_id>, [troop_dna]), - откроет окно сцены встречи с опциональным параметром которым можно вызвать днк юнита для говорящего в партии которая не имеет лидера

               

Операции для module_game_menus.py

(set_background_mesh, <mesh_id>), - устанавливает определенный фон для определенного меню.
 позиция изображения будет зависеть от координат самого меша.  для использование  мешей с текстурой которые заданы в родном меню, нужно поставить флаг для имени меню - mnf_scale_picture

(set_game_menu_tableau_mesh, <tableau_material_id>, <value>, <position_register_no>),   - добавит в определенное меню табле  меш.
<position_register_no> - X, Y, координаты означают расположение по осям меша. Z - размер изображения.
<value>, - сочитается с параметром самого табле меша

(jump_to_menu, <menu_id>), операция перехода из одного меню в другое. либо же при выходе с определенной миссии (сцены) адресует выход в определенное меню

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

(set_party_battle_mode), -Влияет на состояние игрока и его команды в начале миссии. Если бэттл-мод, то все начинают миссию в полной боеготовности, с обнажённым оружием.

finish_party_battle_mode - останавливает команду set_party_battle_mode

(start_encounter, <party_id>), - вынуждает партию игрока встретится с партией <party_id>.

(leave_encounter), - завершает встречу.

(encounter_attack), - используется в модуль_диалог для завершения разговора с переходом к боевым действиям.

(select_enemy, <value>), - определяет противника игрока при присоединении его к уже идущему сражению. 
<value> -
0 - к партии агрессору
1 - к защищающейся партии

(set_passage_menu, <value>), -  устанавливает номера пассажей в сцене по порядку определенного меню.
если использовать переход из гейм_меню в определенную миссию и установить
(set_passage_menu,"mnu_town"),
номера пассажей (телепортов) буду совпадать с подменю  mnu_town.

(auto_set_meta_mission_at_end_commited), - хз

(start_mission_conversation, <troop_id>), - используется в файле module_mission_templates.py для инициирования диалога инрока с определенным юнитом находящимся в сцене.

(set_conversation_speaker_troop, <troop_id>), - позволяет в диалоге переключить оппонента на реплику определенного юнита. 

(set_conversation_speaker_agent, <agent_id>),позволяет в диалоге переключить оппонента на реплику определенного агента в сцене

(store_conversation_agent, <destination>), - запишет в переменную ID агента с которым ведется диалог

(store_conversation_troop, <destination>), - запишет в переменную ID  юнита с которым ведется диалог.

(store_partner_faction, <destination>), - запишет в переменную ID фракции к которой относится юнит с которым ведется диалог

(store_encountered_party, <destination>), - запишет в переменную ID партии c которой происходит встреча.

(store_encountered_party2, <destination>), - запишет в переменную ID второй партии. если первая находится в бое то здесь запишется оппонент партии 1

(set_encountered_party, <party_no>), - ?
 в нативе используется для определения ID партии (города) для перехода в миссию засады. 

(end_current_battle), - ?
в нативе используется для завершения битвы, когда у противников игрока заканчиваются юниты для последующего перехода в бой.

Последующие операции используются в module_dialogs.py

(store_repeat_object, <destination>), - записывает в переменную динамические реплики. используется вместе с   repeat_for_. хранит в переменной реплики.

(talk_info_show, <hide_or_show>), - используется для вк./отк. функции  информации о собеседнике, когда указатель мыши расположен в окне для собеседника.
0 - отключает
1 - включает

(talk_info_set_relation_bar, <value>),- вызывает на экран в окне собеседника при наведении мыши на оппонента меш с текущим уровнем отношения с собеседником.

(talk_info_set_line, <line_no>, <string_no>) - вызывает на экран имя собеседника при наведении указателя мыши на окно собеседника, вместе с тулбаром отношений.

header_scene_props.py

Файл декларирует "флаги", придуманные для работы с объектами сцен. Ничего не меняйте в этом файле и не обращайте внимания на конструкции, где нет приставки sokf_.

sokf_type_container   Превращает объект сцены в сундук.
sokf_type_ai_limiter   Превращает объект сцены в препятствие для всех агентов, кроме пешего игрока. Пеший игрок может проходить сквозь такой объект независимо от наличия у объекта "физического тела" (body mesh).
sokf_type_barrier   Превращает объект сцены в препятствие для всех агентов.
sokf_type_barrier_leave   Превращает объект в препятствие для всех агентов, с помощью которого игрок может покинуть данную сцену. При приближении к такому объекту появляется надпись "Leave area" (покинуть местность).
sokf_type_ladder   Превращает объект сцены в лестницу с возможностью подниматься по ней под очень крутым углом. Точный градус не скажу, под текстом для пояснения привожу скриншот, где центральная колонна имеет минимально необходимый угол наклона.
sokf_type_barrier3d  бессмысленный флаг, хотя и рабочий. Превращает объект сцены в препятствие для всех агентов. Объекты с таким флагом по сути в игре не используются.
sokf_type_mask  Не используется.
sokf_add_fire  Не используется. Огонь добавляется триггерами в файле scene_props.py
sokf_add_smoke  Не используется. Дым добавляется триггерами в файле scene_props.py
sokf_add_light  Не используется. Свет добавляется триггерами в файле scene_props.py
sokf_show_hit_point_bar  Указывает, что у разрушаемого объекта должна отображаться строка состояния (индикатор степени разрушенности).
sokf_place_at_origin  Объект с таким флагом при загрузке сцены всегда будет оказываться у правого башмака ГГ.
sokf_dynamic   Не используется.
sokf_invisible   Делает объект невидимым (если не активирован режим редактирования).
sokf_destructible   Присваивается разрушаемым объектам, помимо него нужен триггер в файле scene_props.py (он определяет запас прочности, фиксирует удар, обеспечивает результат разрушения), примечательно, что без этого флага триггер будет фиксировать нулевой урон и разрушение никогда не произойдёт.
sokf_moveable   Присваивается объектам, которые можно с помощью скриптов перемещать (анимировать) на сцене. Замена в строке disable_moveable_flag_optimization = 0 файла module.ini нуля на единицу позволяет обходиться без применения данного флага. Есть мнение, что такой подход увеличивает требовательность игры к системным ресурсам компьютера.
sokf_face_player   Заставляет объект сцены всегда поворачиваться лицевой стороной к игроку, в нативе применяется для флагов (баннеров).
sokf_dynamic_physics   Заставляет объект сцены реагировать на удары и в результате падать, скакать, сползать. Поведение такого объекта выглядит нереалистично и с привычной нам физикой имеет мало общего.
sokf_missiles_not_attached   Не используется. Предполагается для указания, что достигшие объекта стрелы и т.п. не должны в нём оставаться.

Операции для работы с мультиплеером

# multiplayer
(multiplayer_send_message_to_server, <message_type>), - отправить сообщение на сервер(? не использовал ни разу) message_type прописываются в header_common.

(multiplayer_send_int_to_server, <message_type>, <value>), - отправить на сервер информацию, что событие <message_type> должно начаться с одним из параметров, равным <value>. По сути, это тоже вызов скрипта, ведь все события записаны в #script_game_receive_network_message. Однако, в отличие от простого вызовы скрипта, данное событие произойдёт для всех.

(multiplayer_send_int_to_player, <player_id>, <message_type>, <value>), - работает аналогично предыдущей команде, но только для конкретного игрока <player_id>. Как я считаю, эта команда нужна отчасти для того, чтобы сделать событие на сервере видимым для игрока. (Яркий пример - это инвентарь в мультиплеере, позволяющий игроку переодеваться прямо во время битвы. То есть, мы установили новую броню игроку, но никто не заметил изменения одежды. Поэтому следует продублировать изменение брони для всех игроков через эту команду.) Кроме того, она может использоваться для того, чтобы перемещать камеру конкретному игроку и прочего.

 (multiplayer_send_string_to_player, <player_id>, <message_type>, <string_id>), - отправить игроку при событии строковую переменную <string_id>, лежащую в файле module_strigns.py. Или же, вместо неё можно попробывать написать переменную в виде "@абырварг".

 (get_max_players, <destination>), - пишет в переменную то ли максимально возможное количество игроков на сервере, то ли максимально возможное вообще.

(player_is_active, <player_id>), - выдаёт истину, если игрок на сервере. вроде бы, точно не помню.

 (player_get_team_no,  <destination>, <player_id>), - пишет в переменную, в какой команде игрок. 0,1 или 2. 2 - наблюдатели.

 (player_set_team_no,  <destination>, <player_id>), - устанавливает игроку новую команду.

(player_get_troop_id, <destination>, <player_id>), - пишет в переменную, за какой тип солдата играет игрок. Солдаты лежат в module_troops.py

(player_get_troop_id, <destination>, <player_id>), - устанавливаем игроку тип солдата.

 (player_get_agent_id, <destination>, <player_id>), - пишет в переменную идентификатор агента игрока. Агент, как я понимаю, это любое "живое" существо на карте, бот, игрок или лошадь.

(player_get_gold, <destination>, <player_id>),
(player_set_gold, <player_id>, <value>, <max_value>), #set max_value to 0 if no limit is wanted
первая команда пишет в переменную текущее количество золота у игрока, вторая - выдаёт игроку золото в количестве value.




(player_spawn_new_agent, <player_id>, <entry_point>), - заставляет появиться копию игрока на указанной entry_point.

player_add_spawn_item                = 410 # (player_add_spawn_item, <player_id>, <item_slot_no>, <item_id>), - ? как описать, не знаю, но ей выдаются предметы, выбранные в меню закупки.

multiplayer_get_my_team              = 411 # (multiplayer_get_my_team, <destination>),
multiplayer_get_my_troop             = 412 # (multiplayer_get_my_troop, <destination>),
multiplayer_get_my_gold              = 414 # (multiplayer_get_my_gold, <destination>),
multiplayer_get_my_player            = 415 # (multiplayer_get_my_player, <destination>),
пишут в переменные данные о команде, типе солдата, золоте и идентификаторе игрока для игрока.(когда расчёт идёт не для сервера, а для игрока. Лучше не знаю, как объяснить).

multiplayer_set_my_troop             = 413 # (multiplayer_get_my_troop, <destination>),

multiplayer_clear_scene              = 416 # (multiplayer_clear_scene), -?
(multiplayer_is_server),  возвращает истину, если игрок, у которого выполняется код, является сервером, создавшим сервер из игры(?).

multiplayer_is_dedicated_server      = 418 # (multiplayer_is_dedicated_server),-?
game_in_multiplayer_mode             = 419 # (game_in_multiplayer_mode), -?

 (multiplayer_make_everyone_enemy), - это вроде делает всех врагами. для дезматча.(?)




## Set_slot operations. These assign a value to a slot.
Слоты! С ними можно всё. На них строиться код.
Слот - это, по сути, своя переменная с одним и тем же именем для множества однородных объектов.
Допустим, нам надо записать, что квест выполнен наполовину. Для этого можно создать переменную типа :half или $g_half. Но для каждого нового квеста нам придётся создавать новые переменные, дабы отразить его состояние. То есть много лишней информации.
Но мы можем использовать слоты. Слот - это такой ящик, в который мы можем положить любые предметы. Например, у нас два квеста - синий и зелёный. Чтобы записать, что квест пройден наполовину, мы сделаем так.
В module_constants.py сколотим новый ящик в разделе Quest Slots. Например, ящик quest_stage.
Потом мы просто делаем такой же и относим его в синий или зелёный домик.

(quest_set_slot,<quest_id>,<slot_no>,<value>), - quest_set_slot - сама команда, кладущая в ящик информацию; <quest_id>  - идентификатор квеста, в нашем случае "синий" или "зелёный". <slot_no> - это наш ящик; value - значение, вещь, которую мы положили в слот. Это может быть идентификатор игрока или агента, оружия, объекта сцены, самой сцены, любое число.

Итого, если зелёный квест выполнен наполовину, мы напишем:
(quest_set_slot,"qst_зелёный",slot_quest_stage,1)

После этого мы командой quest_get_slot можем в любом другом месте модульной системы(скрипты, триггер миссий) определить состояние нашего квеста.

Или вот так можно. Нам нужно записать, что игрок должен принести случайно выбранное программой оружие. например, был выбран itm_sword. Создадим новый слот quest_weapon.

(quest_set_slot,"qst_зелёный",slot_quest_weapon, "itm_sword").
Теперь мы можем легко проверить, какое оружие у нас должно найтись.

Так, а если нам надо два предмета? То есть, придётся сделать два слота? quest_weapon_1 и quest_weapon_2? Нет, можно проще.

Слот - это ящик, сущность которого одновременно пребывает в разных измерениях в количестве от одного до бесконечности. Так вот. Можно в зелёную комнату принести ещё такой же ящик и на него прикрепить бирку с номером. То есть в зелёной комнате будут два идентичных ящика с номерами 0 и 1.

И вот, второе оружие - лук.
Мы запишем так:
(quest_set_slot,"qst_зелёный",slot_quest_weapon, "itm_sword") - ящик с номером 0
(quest_set_slot,"qst_зелёный",slot_quest_weapon+1, "itm_bow") - ящик с номером 1

Вот и всё. И никаких глобальных переменных в неведомом числе

немного отпишусь...

Пояснение понятия Слот.

(автор Dargor, )

   Для целого ряда существующих в игре объектов возможно создание специальных ячеек памяти, называемых слотами (slot). Слоты упрощают хранение и систематизацию информации, избавляют нас от необходимости сочинять и запоминать тьму-тьмущую переменных. Вот список таких объектов: item, agent, faction, party, party_template, scene, scene_prop, troop, quest, player, team. Для каждой сцены, для каждого предмета, юнита и т.д. мы можем создать почти неограниченное множество слотов (ячеек памяти). Чтобы обращаться к этим слотам годятся как порядковые номера (от нуля до... почти бесконечности), так и названия. Названия вновь придуманных слотов необходимо прописать в файле module_constants.py. Учтите, что большое количество слотов уже имеют свои названия и используются игрой в различных ситуациях.
   Например, для агентов в нативе используется 26 слотов, пронумерованных от 0 до 25 и снабжённых названиями типа slot_agent_is_running_away (в данном случе это слот с номером 15). Следовательно, надёжнее всего новый слот создать с номером 26, это на 100% защитит нас от багов, связнных с использованием одного и того же слота двумя разными скриптами. Упомянутый слот позволяет для любого из агентов, находящихся на сцене, сделать запись, что он в данный момент убегает (дезертирует):

(agent_set_slot, ":cur_agent",  slot_agent_is_running_away, 1),

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

(agent_set_slot, ":cur_agent",  15, 1),

   Функционировать всё будет точно так же, разница лишь в том, что человеку обычно легче запомнить несущие значения слова, чем набор чисел. В нашем примере slot_agent_is_running_away означает - вот константа, используемая для обозначения слота агента, где хранится информация, убегает он или нет. Если какое-то название слота вам сложно запомнить, то вы можете ввести для него альтернативное название. Для этого достаточно в файле module_constants.py добавить соответствующую запись:

run_away = slot_agent_is_running_away

и тогда наша строка-пример преображается в следующую с полным сохранением своей функции:

(agent_set_slot, ":cur_agent",  run_away, 1),

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

(try_for_range, ":unused", 0, 26),
(agent_set_slot, ":cur_agent",  ":unused", 0),
(try_end),

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

(agent_set_slot, ":cur_agent",  run_away + 1, 1),

в данном случае мы обратились уже к следующему слоту, имеющему номер 16.

По отношению к слотам нам доступны следующие операторы:
(agent_set_slot,<agent_id>,<slot_no>,<value>),          записывает в слот число (value)
(agent_get_slot,<destination>,<agent_id>,<slot_no>),    узнаёт записанное в слот число
(agent_slot_eq,<agent_id>,<slot_no>,<value>),           делает строгую проверку (содержимое слота равно определённому значению)
(agent_slot_ge,<agent_id>,<slot_no>,<value>),           делает нестрогую проверку (содержимое либо больше, либо равно определённому значению)
(neg|agent_slot_eq,<agent_id>,<slot_no>,<value>),       делает нестрогую проверку (содержимое либо больше, либо меньше определённого значения)
(neg|agent_slot_ge,<agent_id>,<slot_no>,<value>),       делает строгую проверку (содержимое меньше определённого значения)

Разумеется при работе с другим объектом вместо слова agent будет фигурировать что-то из списка item, faction, party, party_template, scene, scene_prop, troop, quest, player или team. 

Операции для работы с строковыми регистрами.(стринг)

Строковые регистры(s0, s1,..) , в отличии от простых регистров (reg0, reg1, reg2,...), которые хранят числовое значение, позволяют хранить буквенные символы - текст, для вывода его на экран. Текст можно хранить в файле module_strings.py, и затем с помощью операции помещать его в строковой регистр. например в файле module_strings.py первая запись - ("no_string", "NO STRING!"),
"no_string" -идентификатор (имя) стринга.
"NO STRING!" - Сам текст.
для того чтобы использовать текст сделаем следующее -

Код: [Выделить]

(str_clear, s0),                                                        # Сотрем текст который может быть сохранен от предыдущего использования  s0.
(str_store_string, s0, "str_no_string"),                       # Запишем в s0 текст который хранится под идентификатором no_string
Можно пойти другим путем, без помещения текста в файл module_strings.py

Код: [Выделить]

(str_clear, s0),                                                        # Сотрем текст который может быть сохранен от предыдущего использования  s0.
(str_store_string, s0, "@ NO STRING! "),                    # В данном случае мы ввели текст непосредственно в самой операции. использование значка @
                                                                                  перед текстом является обязательным.Работая с строковыми регистрами мы можем комбинировать несколько записей в одну в зависимости от обстоятельств. Например нам нужно вывести имя партии с которой происходит встреча игрока для ввода его в определенную строку, а поскольку оно нам не известно можно сделать таким образом.

Код: [Выделить]

(str_clear, s0),                                                        # Сотрем текст который может быть сохранен от предыдущего использования  s0.
(str_store_party_name, s0, "$current_town"),            # Запишем имя партии которая идентификатор которой находится в $current_town
                                                                                "$current_town" - глобальная переменная в которой ID города с которым происходит встреча
                                                                                  партии игрока.
(str_clear, s1),                                                        # Сотрем текст который может быть сохранен от предыдущего использования  s1.   
(str_store_string, s1, "@ You rode into in the gate of {s0} "),   # В этом случае у нас будет динамически выводится имя города 

(str_is_empty, <string_register>), проверит что определенный стриг чист

(str_clear, <string_register>),  очищает заданный стринг

(str_store_string, <string_register>, <string_id>), - запишет в стринг текст из module_strings.py, либо быстрый стринг.

(str_store_string, <string_register>, <string_no>), - запишет в стринг текст из другого регистра.

(str_store_troop_name, <string_register>, <troop_id>),   - запишет в стринг имя заданого юнита

(str_store_troop_name_plural, <string_register>, <troop_id>), запишет в стринг множественное имя заданого юнита

(str_store_troop_name_by_count, <string_register>, <troop_id>, <number>), - запишет в стринг имя заданого юнита
и заданое число юнитов.
(str_store_troop_name_by_count, s1, "trp_bandit", 10), - запишет в стринг - "10 Bandits"

(str_store_item_name, <string_register>, <item_id>), - запишет в стринг название вещи

(str_store_item_name_plural, <string_register>, <item_id>), - запишет в стринг множественное название вещи

(str_store_item_name_by_count, <string_register>, <item_id>), - запишет в стринг название вещи и его количество.

(str_store_party_name, <string_register>, <party_id>), - запишет в стринг название заданной партии

(str_store_agent_name, <string_register>, <agent_id>), - запишет в стринг имя заданого агента.

(str_store_faction_name, <string_register>, <faction_id>), - запишет в стринг название фракции.

(str_store_quest_name, <string_register>, <quest_id>), - запишет в стринг название заданого квеста

(str_store_info_page_name, <string_register>, <info_page_id>), - запишет в стринг название инфо страницы из module_info_pages.py

(str_store_date, <string_register>, <number_of_hours_to_add_to_the_current_date>), - запишет в стринг текущюю время и дату

Последующие операции для вывода текста  с переходом к странице информации по заданной теме при клацании мышкой на тексте .

(str_store_troop_name_link, <string_register>, <troop_id>), - запишет в стринг имя юнита.

(str_store_party_name_link, <string_register>, <party_id>), - запишет в стринг название партии

(str_store_faction_name_link, <string_register>, <faction_id>), -запишет в стринг название фракции

(str_store_quest_name_link, <string_register>, <quest_id>), - запишет в стринг название квеста

(str_store_info_page_name_link, <string_register>, <info_page_id>), - запишет в стринг название темы инфо страницы

(str_store_class_name, <stribg_register>, <class_id>) - запишет в стринг название класса юнитов
(Infantry, Archers, Cavalry)

По мультиплееру без понятия.

(str_store_player_username,<string_register>,<player_id>),
 (str_store_server_password, <string_register>),
 (str_store_server_name, <string_register>),
 (str_store_welcome_message, <string_register>),
 (str_encode_url, <string_register>),

 

Существует немало весьма полезных тем и туториалов, которые помогают на начальном этапе изучения модульной системы и учат, как можно с ее помощью изменять любые детали Mount&Blade Warband, но мне так и не удалось найти ни одной, которая бы досконально объясняла все самые основы и азы операций и их синтаксиса, используемого в модульной системе. Вместо этого существует множество небольших одиночных тем-вопросов в разделе "Вопросов и ответов", которые помогают начинающим кодерам и модульщикам разобраться в принципах работы модульной системы. Итак, я, как, без сомнения, наиболее опытный и умелый член этого сообщества, который лучше всех сумееет точно, понятно и толково разъяснить основы синтаксиса модульной системы, решил, что не будет хуже, если я попытаюсь.

ОСНОВЫ

Список всех существующих операций и команд, которые могут быть использованы, содержится в файле header_operations.py. Каждая команда сопровождается комментарием (отмеченным символом #), в котором прописаны все аргументы данной операции, и возможно — краткое описание и подсказки по использованию. Каждая операция модульной системы имеет следующий вид:
1. Операция заключена в круглые скобки: (operation)
2. Сразу после операции должна стоять запятая: (operation),
3. Аргументы пишутся внутри скобок сразу после названия самой операции в строго заданном порядке и разделяются запятыми: (operation, argument, argument),

Помимо этого, в header_operations каждой операции присвоен ее собственный номер. Например, call_script = 1. Когда игра выдает сообщения об ошибке, они имеют вид SCRIPT ERROR ON OPCODE ##: …  (Здесь и далее # - целое число. Прим. пер.) Номер OPCODE соответствует номеру операции в header_operations. Таким образом, если у ошибки OPCODE 1, то можно понять, что ошибка произошла при попытке вызвать операцию call_script.

Вообще все элементы, содержащиеся в любом файле МС, строго пронумерованы по порядку. Нумерация начинается с 0, и каждый следующий элемент имеет номер на 1 больше, чем предыдущий. Таким образом классы, предметы, триггеры, сцены и т. д., после компиляции  МС в игровые текстовые файлы, сортируются по их этим самым номерам. Итак, если вы видите, что ошибка в “ trigger 0” -  значит, имеется в виду первый триггер в соответствующем файле, и если ошибка в 4-ой строке, искать нужно 5-ю операцию в этом триггере.

Переменные

Локальные переменные (local variables) - “:variable” - переменные, названия которых начинаются с двоеточия ( : ) - это локальные переменные. Они существуют только в данном фрагменте кода, ограниченном скобками ( [ ] ) и они не могут быть вызваны непосредственно из других фрагментов кода иначе, кроме как быть переданными в качестве аргументов операции. Перед тем, как использовать переменную в коде, необходимо ее сперва инициализировать — присвоить ей какое-либо значение (0 или любое другое, подходящее по типу). Названия локальных переменных заключаются в кавычки ( “” ), и начинаются с двоеточия ( : ). Пример: “:agent_id”

Глобальные переменные (global variables) - “$variable” - переменные, названия которых начинаются со знака доллара ( $ ) - это глобальные переменные. Они могут быть доступны из любой части кода, из любого module_*.py файла после того, как были однажды инициализированы. По умолчанию значение созданной глобальной переменной равно 0.  Названия глобальных переменных заключаются в кавычки ( “” ), и начинаются со знака доллара ( $ ). Пример: “$g_talk_troop”

Регистры (registers) – reg(#) или reg# - это переменные, используемые движком игры для временного хранения информации. Регистры глобальны, но могут быть доступны из других частей кода только пока существуют. В header_common содержатся объявления всех существующих регистров от reg0 до reg65.

Строки (strings) – s# - это специальная разновидность регистров, предназначенная для хранения не чисел, а строк текста. Строки, не прописанные заранее в module_strings (быстрые строки(quick strings)) начинаются с символа @. В header_common содержатся объявления всех существующих строковых регистров от s0 до s67.

Позиции (positions) – pos# - В отличие от предыдущих двух видов регистров, позиции хранят больше одного элемента информации; каждая позиция содержит координаты по осям X, Y и Z, а также углы поворота объекта относительно каждой из этих осей. В header_common содержатся объявления всех существующих регистров - позиций от pos0 до pos64, а также начинающийся с pos64 неустановленный массив позиций, используемых осадными башнями.

Постоянные, константы (constants) – constant – это постоянные значения, прописанные в module_constants, содержащие численное значение, присвоенное им при инициализации. Их значения не могут быть изменены никак иначе, кроме как напрямую в module_constants.  Они могут быть доступны из любой части кода, из любого module_*.py файла. Константы не заключаются в кавычки.

Локальные и глобальные переменные, как и регистры, инициализируются с помощью команды (assign, <variable_name>, <variable_value>), Присваиваемое значение (<variable_value>) может быть другой переменной. Строки и позиции имеют свои собственные уникальные операции, прописанные в header_operations.

Приставки

В модульной системе существует возможность обращаться из одного файла к объектам из другого с помощью специальных приставок, добавляемых перед названием нужного объекта. Таким образом, если нужно, например, в module_mission_templates использовать какую-либо анимацию, то название этой анимации пишется следующим образом: anim_<название анимации из module_animations>.

module_animations: "anim_" - Анимации
module_factions: "fac_" - Фракции
module_info_pages: "ip_" - Описания
module_items: "itm_" - Предметы
module_map_icons: "icon_" - Иконки глобальной карты
module_game_menus: "menu_" - Меню
module_meshes: "mesh_" - Модели
module_mission_templates: "mst_" - Миссии
module_particle_systems: "psys_" - Визуальные эффекты
module_parties: "p_" - Отряды, партии
module_party_templates: "pt_" - Шаблоны отрядов, партий
module_pstfx_params: "pfx_" - Параметры окружающей среды
module_presentations: "prsnt_" - Игровые ситуации
module_quests: "qst_" - Квесты
module_scene_props: "spr_" - Сценовые объекты
module_scenes: "scn_" - Сцены
module_scripts: "script_" - Скрипты
module_skills: "skl_" - Умения, навыки
module_sounds: "snd_" - Звуки
module_strings: "str_" - Строки
module_tableau_materials: "tableau_" - Скрипты, обрабатывающие текстуры
module_troops: "trp_" - Классы персонажей

Module_scripts, скрипты, параметры, аргументы и т. д.

Большая часть module_*.py файлов содержат в основном самостоятельный, изолированный код. Такие файлы как _troops, _skills, _items и т. д. представляют собой просто список различных игровых объектов с описаниями их свойств. module_game_menus содержит всевозможные меню в игре, их пункты, параметры и др. Presentations хранит данные, связанные с рисованием различных игровых ситуаций, и т. д.

Но module_scripts связан с каждым из этих файлов — он содержит «общие» функции, которые могут быть вызваны из любой части игрового кода. Поэтому предполагается, что скрипты из module_scripts будут вызываться, в основном, из других module_*.py файлов с помощью операции (call_script, <script_name>, <arguments>),
Чтобы упростить процесс использования скриптов, операция вызова позволяет передавать информацию из текущего фрагмента кода в сам скрипт без использования глобальных переменных с помощью так называемых аргументов или параметров. Эти аргументы или параметры могут быть локальными переменными, объявленными в данном фрагменте кода. Сам скрипт в module_scripts при вызове начнет свое выполнение с приема и сохранения переданных аргументов как локальных переменных в своем теле, чтобы иметь возможность использовать их при выполнении. Правда, скрипты не могут передавать информацию в код, откуда они были вызваны тем же способом... Но для этих целей обычно используются регистры. В коде, из которого вызывается скрипт, сразу после завершения выполнения скрипта значения этих регистров для удобства сохраняются в локальные переменные. В скрипт за одну операцию вызова можно передавать до 15 аргументов.

Пример:
Фрагмент кода из module_mission_templates:

Код: [Выделить]

//...объявления, инициализация...//
(assign, ":local_variable_1", 10), #объявление первой локальной переменной
(assign, ":local_variable_2", 5), #объявление второй локальной переменной

#вызов скрипта с передачей локальных переменных как аргументов
(call_script, "script_example_script", ":local_variable_1", ":local_variable_2"),

#получение результата выполнения скрипта из регистра
#и сохранение его в новую локальную переменную
(assign, ":local_variable_3", reg0), #local_variable_3 = 15

//...продолжение кода, работающего с local_variable_3...//
Скрипт из module_scripts:

Код: [Выделить]

# script_example_script
# Input: variable_1, variable_2
# Output: Sum in reg0
("example_script", [
#получение и сохранение переданных аргументов
(store_script_param, ":num1", 1), #теперь num1 равен 10
(store_script_param, ":num2", 2), #теперь num2 равен 5
#тело скрипта, выполнение действий над аргументами
(store_add, ":sum", ":num1", ":num2"),
#сохранение результата выполнения скрипта в регистр,
#чтобы он был доступен из исходного фрагмента кода в mission_templates
(assign, reg0, ":sum"),
]),

ТЕРМИНОЛОГИЯ

«Класс» и «Агент» (Troop vs Agent)

Классы обозначают объекты, описанные в module_troops — классы персонажей игры, каждый из которых имеет какие-то свои уникальные свойства и иособенности. “trp_player” - это игрок, “trp_npc##” - это класс компаньонов, “trp_knight_#_##” - класс лордов, “trp_swadian_footman” - класс свадийских пехотинцев и т. д. Классы используются как шаблоны для создания персонажей с определенным набором свойств, причем каждый класс может содержать большое количество объектов. Например, солдаты в отряде, которые группируются по типу (классу), и которых в каждом типе(классе) может быть несколько.

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

Партии и Шаблоны Партий (Parties and Party Templates)

«Партия» - это любой объект на глобальной карте, будь то отряд игрока, разбойники, их убежища, армии лордов или города, замки, деревни. Типы партий поделены на категории и прописаны в первом слоте партии “slot_party_type”, в котором должно содержаться число, соответствующее нужной категории. Эти категории прописаны в module_constants и начинаются с приставки spt_ (slot_party_type). Примерами spt_* являются spt_kingdom_hero_party (для армий лордов) или spt_castle (для замков).
Каждая партия имеет свой уникальный ID номер, который может использоваться в коде. Например, партия игрока - это “p_main_party”, у которой значение ID — 0. Точно определенные партии имеют постоянный, статический ID, как партия игрока и все города, замки и деревни. Все такие партии со статическими ID прописаны в module_parties. Их ID можно просмотреть в ID_parties.py после того, как МС будет скомпилирована.

Для всех партий, которые НЕ прописаны в module_parties, ID создаются динамически, по мере создания самих партий. Партии же создаются с помощью шаблонов партий по тому принципу, что агенты и классы (см. выше). Шаблоны партий прописаны в module_party_templates.py и их названия начинаются с приставки “pt_*”. Шаблон содержит в первую очередь список классов персонажей, находящихся в этой партии и численные интервалы, означающие количество представителей каждого класса в этой партии (точное количество выбирается случайным образом в пределах этого интервала). Шаблоны партий используются для динамического создания отдельных партий с помощью команды (spawn_party). Созданной партии присваивается ID номер, и после этого партия может быть классифицирована по значению slot_party_type и т. д. Также шаблоны партий могут быть использованы для уже существующих партий, а именно можно добавить шаблон партии со всеми входящими в нее персонажами к уже существующей партии в качестве «подкрепления».

Слоты

Слоты, в сущности,  - это способ сгруппировывать переменные по объектам (к которым относятся партии, классы, агенты, команды, фракции, сцены, сценовые объекты и шаблоны партий). Каждая партия, класс, агент, предмет и т. д. имеет определенный набор «слотов» -  переменных, привязанных именно к этому объекту. Каждая такая переменная имеет название типа ”slot_item_SLOTNAME”, и они привязываются к каждому экземпляру объекта (предмета (item'a) в данном случае), что очень удобно, поскольку позволяет хранить свою собственную уникальную информацию для каждого отдельного объекта. Выглядят слоты как константы из-за того, что движок игры воспринимает их именно так, и имя каждого слота заменяет на число, прописанное в module_constants (slot_item_base_price = 53). Это значит, что чтобы узнать базовую цену данного объекта-предмета, движок должен взять значение 53-го слота, привязанного к этому объекту.

Итак, посмотрев на какую-нибудь операцию, работающую со слотами, как например (item_get_slot, “:base_price”, “:item_id”, slot_item_base_price), можно увидеть, что необходимо точно указывать, базовую цену какого именно предмета вам нужно узнать (“:item_id”). Но вы можете использовать цикл try_for_*, подставляя в каждой итерации цикла новое значение в “:item_id”, и перебрать таким образом любое количество предметов, чтобы произвести какие-то действия с ценой каждого из них, например.

Вы можете узнать цену какого-либо предмета, получив значение соответствующего слота с помощью операции item_get_slot, изменить ее, присвоив новое значение с помощью операции item_set_slot, проверять, не равна ли она какому-либо заданному значению с помощью item_slot_eq и многое другое.

Если вы знакомы с C-подобными языками программирования, то слоты работают примерно так же, как это:

Код: [Выделить]

slot_troop_spouse
spouse[troop1] = spousename
spouse[troop2] = spousename
spouse[trp_player] = spousenameДвижок игры этот код воспринимает так: troop_variable_30[troop1], troop_variable_30[troop2], troop_variable30[trp_player], поскольку slot_troop_spouse в module_constants имеет номер 30.

Код: [Выделить]

slot_item_base_price
baseprice[item1] = priceA
baseprice[item2] = priceB
baseprice[item3] = priceCДвижок игры этот код воспринимает так: item_variable_53[item1], item_variable_53[item2], item_variable_53[item3],... поскольку slot_ item_base_price в module_constants прописан под номером 53.

Пока слотам не присвоено никакое значение операцией *_set_slot, значения всех слотов по умолчанию равны 0.

УСЛОВИЯ И ЦИКЛЫ

Необходимо упомянуть, что игровой движок в любой конструкции “Если-Тогда” воспринимает любую операцию проверки условия как “ЕСЛИ”, и весь код, который следует за ней — как “ТОГДА”. Так как код выполняется построчно, то если его выполнение прервется при первом же неверном условии, то вообще весь последующий код не будет выполнен.
Поэтому для изоляции конструкций “Если-Тогда”, чтобы код мог нормально выполняться и прерывание его выполнения на одном неверном условии не значило прекращение выполнения вообще, используются так называемые “try-блоки”, использующие операции (try_begin), (else_try), и (try_end), Подробнее о использовании try-блоков ниже.

Операции - условия

(eq,<value>,<value>),  Значение 1 = Значение 2?
(gt,<value>,<value>),  Значение 1 > Значение 2?
(ge,<value>,<value>),  Значение 1 >= Значение 2?
(lt,<value>,<value>),  Значение 1 < Значение 2?
(le,<value>,<value>),  Значение 1 <= Значение 2?
(neq,<value>,<value>), Значение 1 != Значение 2?
(is_between,<value>,<lower_bound>,<upper_bound>),  Нижняя граница <= Значение < Верхняя граница?

Кроме этого любая операция, содержащая “_is_”, также является условием и может быть проверена на выполнение-невыполнение (true-false). Например, операция (agent_is_alive, <agent_id>), - это проверка, жив ли в данный момент агент <agent_id>. Если да, то есть если данный агент жив, то выполнение кода продолжается. Если же агент мертв, то выполнение данного try-блока прерывается.

Для того, чтобы проверить операцию-условие, содержащую “_is_” на НЕвыполнение (выполнение кода продолжается, если условие неверно), нужно сделать следующее:
(neq|<operation>),
В нашем предыдущем примере,  (neq|agent_is_alive, <agent_id>), выполнение кода продолжится в том случае, если данный агент мертв (НЕ жив), и прервется, если он жив.

Управляющие операции

(try_begin),
(try_end),
(else_try),
(try_for_range,<destination>,<lower_bound>,<upper_bound>),
(try_for_range_backwards,<destination>,<lower_bound>,<upper_bound>),
(try_for_parties,<destination>),
(try_for_agents,<destination>),

<destination> - это переменная, значение которой будет изменяться в каждой итерации цикла в соответствии с текущей итерацией. Подробнее см.ниже.

Логические операторы И и ИЛИ

Поскольку, как уже упоминалось выше, движок воспринимает каждую операцию-условие в конструкции “Если-Тогда” как “ЕСЛИ”, а последующий код — как “ТОГДА”, логическое И может быть реализовано просто путем выписывания нужных условий одно за другим. Например, если нужно определить, является ли агент живой вражеской лошадью, то есть если агент жив И является лошадью И является врагом, то код будет выглядеть просто следующим образом:

(agent_is_alive,<agent_id>),
(neg|agent_is_human,<agent_id>),
(neg|agent_is_ally,<agent_id>),

Чтобы проверить выполнение одного ИЛИ другого условия, используется такая конструкция:
(this_or_next|<operation>),
По тем же самым причинам эти условия так же должны располагаться одно за другим. Например, так будет выглядеть проверка, равно ли значение переменной 1 ИЛИ 5:

(this_or_next|eq, “:test_variable”, 1),
(eq, “:test_variable”, 5),

Конструкция Если-Тогда-Иначе

Поскольку по умолчанию операции-условия относятся ко всему коду, следующему за ними, возникает необходимость разделять код на фрагменты, чтобы каждое условие относилось только к коду своей секции и не затрагивало остальное.
Это можно сделать, используя “try блок”: код, который должен быть изолирован в отдельную секцию, заключается между операциями (try_begin), и (try_end), Такой способ может быть использован при создании простейшей конструкции “Если-Тогда”: первые строки после (try_begin), должны быть условием “Если”, и за ними должен следовать код, выполняемый, если это условие верно (“Тогда”). После чего должна стоять операция (try_end), означающая конец “try блока” - секции.
И в любой уважающей себя конструкции Если-Тогда должна быть операция Если-Иначе. В МС такой операцией является (else_try), Если внутри try блока какое-либо условие окажется неверно, то выполнение кода прервется на нем и продолжится с ближайшей операции (else_try),

Пример:

Код: [Выделить]

#Какой-то предыдущий код
(try_begin),
(eq, 1, 1), #Верно, переходим к следующей строке
(gt, 2, 5), #Неверно, переходим к ближайшему следующему else_try
#consequence operations here
(else_try),
(eq, 0, 1), #Неверно, переходим к ближайшему следующему else_try
#consequence operations here
(else_try),
(eq, ":favorite_lance", ":jousting"), # Возможно?
(assign, ":prisoners", 100),
(try_end),
#Последующий код, не имеющий отношения к этому try блоку

Циклы

В МС существует множество вариантов цикла For-Next. Простейший из них выглядит следующим образом: начинается с операции (try_for_range, ":iterator", <lower bound>, <upper bound>), (описание см. выше), затем идет тело цикла, состоящее из собственно тех операций, которые должны повторяться, и в конце стоит (try_end), означающий конец цикла.
Во время каждой итерации цикла изменяется значение переменной  ":iterator". Значения этой переменной начинаются со значения, указанного в качестве нижней границы (lower_bound) и, пошагово изменяясь после каждой пройденной итерации, приближаются к значению, соответствующего значению верхней границы (upper bound), уменьшенного на 1. Эта переменная ":iterator" может быть использована в теле цикла  try_for_range, но не может быть изменена, потому что это нарушит работу цикла — некоторые итерации могут быть пропущены. Если переменная ":iterator" не используется в теле цикла, то вместо нее в операции цикла НЕОБХОДИМО использовать переменную ":unused".

Пример:

Код: [Выделить]

(try_for_range, ":i", 0, 10),
   (store_add, ":count", ":i", 1),
   (assign, reg0, ":count"),
   (display_message, "@{reg0}"),
(try_end),
#Этот код будет выводить на экран сообщения, считающие от 1 до 10
Также существует цикл (try_for_range_backwards, ":iterator", <lower bound>, <upper bound>), в котором стартовое значение итератора будет равно значению верхней границы — 1, а конечное — нижней границе. Не обращайте внимания на комментарии в header_operations, гласящие, что нужно поменять местами нижнюю и верхнюю границы. Это не так. Этот цикл очень удобен, например, для удаления элементов из списка (членов отряда, например), чтобы не возникало проблем с индексацией.
Заметьте, что ни верхняя, ни нижняя граница не обязаны быть просто числом: это с тем же успехом могут быть переменные с численным значением, присвоенным им в коде ранее. Примеры см. в следующем разделе.

Существуют еще два специальных варианта цикла try_for_*: (try_for_agents, <agent_id>), и (try_for_parties, <party_id>). Эти циклы предназначены для перебора всех агентов на сцене или партий в игре соответственно. Итератор в процессе прохода по циклу последовательно принимает значения каждого агента или партии, и для использования в теле цикла должен быть сохранен как локальная переменная.

Пример:

Код: [Выделить]

(get_player_agent_no, ":player"),
(agent_get_team, ":playerteam", ":player"),
(try_for_agents, ":agent"), #Цикл перебора всех агентов на сцене
   (agent_is_alive, ":agent"), #Проверка, жив ли данный агент
   (agent_is_human, ":agent"), #Если жив, проверка, является ли человеком (не лошадью)
   (agent_is_non_player, ":agent"), #Если жив и человек, проверка, не является ли игроком
   (agent_get_team, ":team", ":agent"), # Если жив, человек и не игрок, узнаем его команду
   (eq, ":team", ":playerteam"), #Проверка, в одной ли команде этот агент с игроком

  #Последующие операции, производимые с этим агентом, если он в одной команде с игроком
(try_end), #Переход к следующему агенту или если больше агентов нет — выход из цикла

Выходы из цикла

Вы, скорее всего, неоднократно столкнетесь с необходимостью перебирать в цикле всех агентов, чтобы найти одного конкретного агента, или же перебирать массивы любых других объектов, чтобы найти какой-то один конкретный. И после того, как искомый найден — нет больше необходимости проходить циклом по оставшимся — вы ведь уже нашли то, что искали. Нужно выходить из цикла. В МС нет никаких специальных операций для того, чтобы прекратить выполнение цикла, но существует несколько простых и эффективных способов сделать это вручную. Какой из них выбрать в данном случае, зависит от типа использующегося цикла try_for_*.

Способ 1: Изменение условия конца цикла.

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

Пример:

Код: [Выделить]

#Проходим циклом (try_for_agents), по всем агентам
    (assign, ":end", "itm_glaive"),  #Установка верхней границы
    (try_for_range, ":item", "itm_jousting_lance",":end"), #Перебираем все копья в игре
       (agent_has_item_equipped, ":agent", ":item"), #Проверяем, есть ли у данного агента данное копье в инвертаре
       (agent_set_wielded_item, ":agent", ":item"), #Если есть — агент берет его в руки
       (assign, ":end", "itm_jousting_lance"), #Выход из цикла — приравниваем верхнюю границу к нижней — перестаем перебирать копья, мы ведь уже нашли, какое есть у агента
    (try_end),
#Продолжаем работать с агентами в цикле (try_for_agents),
- Для цикла try_for_range_backwards
Тот же самый способ используется и для цикла try_for_range_backwards. Но здесь условием конца цикла является нижняя граница, поэтому для выхода нужно изменять не верхнюю, а нижнюю границу — она должна быть приравнена к значению верхней границы.

Пример:

Код: [Выделить]

#Код, в котором присваивается какое-то значение переменной ":troop"
(assign, ":array_begin", 0), # Установка нижней границы
(try_for_range_backwards, ":i", ":array_begin", 10), #Цикл от 0 до 10
(party_slot_eq, "p_main_party_backup", ":i", 0), #Проверка, равняется ли i-тый слот данной партии 0
(party_set_slot, "p_main_party_backup", ":i", ":troop"), #Если да, то присваиваем этому слоту значение переменной ":troop"
(assign, ":array_begin", 10), # Выход из цикла — приравниваем нижнюю границу к верхней — перестаем перебирать слоты, ведь нужный слот, равный 0, уже найден
(try_end),
Способ 2: С помощью проверки условия

- Для циклов try_for_agents и try_for_parents
В циклах try_for_agents и try_for_parents нет возможности менять верхние и нижние границы. Вместо этого для выхода из цикла используется проверка какого-либо условия (как правило, проверка на равенство двух значений), которая располагается в начале тела цикла, чтобы проверять данное условие перед каждой итерацию. Пока условие выполняется, цикл продолжает работать. Когда условие становится неверным, цикл продолжает работать, однако в его теле не происходит уже никаких действий, поскольку условие, стоящее перед всем основным телом, неверно и выполнение кода тела цикла прерывается в самом начале. Таким образом, цикл очень скоро закончит свою работу. Чтобы воспользоваться этим способом, инициализируйте новую переменную перед циклом. Затем, в самом начале цикла поставьте проверку условия, связанного с этой переменной. После того, как нужный код в теле цикла выполнился, значение этой переменной должно измениться так, чтобы условие, стоящее в начале, стало неверным и произошел выход из цикла.

Пример:

Код: [Выделить]

#Код, в котором присваивается какое-то значение позиции pos1
(assign, ":break_loop", 0), #Инициализация переменной для выхода из цикла
(try_for_agents, ":agent"), #Перебор всех агентов
    (eq, ":break_loop", 0), #Проверка условия: равна ли переменная 0?
    (agent_is_alive, ":agent"), #Если условие верно, продолжаем; жив ли данный агент?
    (agent_is_non_player, ":agent"), #Если жив, проверка, не игрок ли он?
(agent_is_human, ":agent"), #Если жив и не игрок, проверка, человек ли он?
(agent_get_position, pos0, ":agent"), #Если жив, человек и не игрок, сохраняем его местоположение в pos0
(get_distance_between_positions_in_meters, ":distance_to_target_pos", pos0, pos1), #Сохраняем расстояние между pos0 и pos1 в локальную переменную
(lt, ":distance_to_target_pos", 10), #Проверка, находится ли агент менее, чем в 10 метрах от pos1
(assign, ":agent_at_target", ":agent"), #Если да, то сохранить ID этого агента в локальную переменную ":agent_at_target"
(assign, ":break_loop", 1), #Выход из цикла — изменяем значение переменной, чтобы при следующем прохождении цикла условие не было выполнено
(try_end),
#Выход из цикла произойдет, как только будет найден первый живой агент-человек, не являющийся игроком и находящийся менее, чем в 10 метрах от целевой позиции pos1
#Дальнейший код, работающий с найденным агентом

ДРУГИЕ ТЕМЫ

Триггеры

Триггеры из module_mission_templates.py (да и из module_triggers.py, если уж на то пошло) всегда записываются в следующем виде:

Первая часть: частота проверки условия выполнения триггера, "интервал вызова", либо в секундах, либо по определенному событию, ка например "ti_on_agent_hit"
Вторая часть: задержка в секундах между проверкой условий из блока условий и выполнением тела триггера. Не работает, если в качестве частоты проверки условия указано событие, как например "ti_on_agent_hit".
Третья часть: задержка «перезарядки» в секундах, то есть время между моментом завершения выполнения триггера и моментом, когда он снова сможет быть активирован. Специальная задержка перезарядки "ti_once" предназначена для одноразовых триггеров, которые могут выполниться лишь однажды, и после одного выполнения не могут больше выполняться вообще.
Четвертая часть: Блок условий, которые всегда проверяются при вызове триггера
Пятая часть: Тело триггера, основной код, который выполняется только в том случае, если выполнены все условия из блока условий и после задержки, указанной во вторй части триггера.

Важно: В отличие от всех остальных чисел в МС, интервалы задержек в триггерах НЕ обязаны быть целыми числами.

На практике это выглядит как-то так:

Код: [Выделить]

(10, 2, 60,
   [
    (eq, 1, 1),
   ],
   [
    (val_add, "$global_variable", 10),
   ]),
В этом примере интервал вызова составляет 10 секунд, поэтому триггер будет вызываться через каждые 10 секунд. Задержка между проверкой блока условий и выполнением тела равна 2 секундам, поэтому если все условия из блока условий выполнены, то спустя 2 секунды начнется выполнение тела триггера. Интервал перезарядки составляет 60 секунд, значит после каждого выполнения триггера пройдет минута, прежде чем он снова сможет быть активирован.
Здесь блок условий — простая проверка 1==1, которая всегда будет выполняться, поэтому тело триггера будет всегда срабатывать через 2 секунды после проверки условий выполнения триггера. В теле производится простейшее действие: к глобальной переменной прибавляется число 10.

Временные триггеры
Чтобы понять, что интервалы проверки/задержки/перезарядки во временных триггерах могут быть весьма непростыми штуками, рассмотрим следующий пример:

Код: [Выделить]

(2, 1, 3, [<условие, которое иногда выполняется, иногда нет>],
   [
    #некоторый код
   ]),Этот триггер, как и любой триггер с интервалом проверки > 0, начнет проверяться с 1 секунды миссии:

Код: [Выделить]

Секунда    Событие   
1                Триггер вызван; условие неверно — ожидание следующего вызова ( 2 секунды)
3                Триггер вызван; условие неверно — ожидание следующего вызова ( 2 секунды)
5                Триггер вызван; условие верно — включение задержки ( 1 секунда)
6                Тело выполнено - ожидание следующего вызова ( 2); включение перезарядки ( 3)
11              Триггер вызван; условие неверно — ожидание следующего вызова ( 2 секунды)
13              Триггер вызван; условие верно — включение задержки ( 1 секунда)
14              Тело выполнено - ожидание следующего вызова ( 2); включение перезарядки ( 3)
19              Триггер вызван....Итак, хотя интервал вызова равен 2 секундам, можно увидеть, что на самом деле вызов триггера не происходит каждые две секунды; вместо этого он происходит в 1, 3, 5, 11, 13, 19 секунды и т. д.
Если триггер должен вызываться точно «по расписанию», нельзя использовать ни задержку, ни перезарядку.

Два триггера с одинаковыми типами или интервалами
Если два триггера имеют одинаковые интервалы вызова (будь то в секундах или по условию ti_*), то порядок, в котором они будут выполнены, определяется текущим шаблоном миссии. Триггер, прописанный в шаблоне первым, первым и сработает, за ним уже выполнится второй с тем же интервалом и т. д. Это означает, что если у вас есть два триггера, срабатывающих по условию ti_on_agent_spawn, первым выполнится тот, который прописан в файле перед другим.

Триггеры в начале миссии
Логично предположить, что триггер ti_before_mission_start срабатывает перед тем, как сформирована сцена и появились агенты. Затем выполняются триггеры ti_on_agent_spawn – перед всеми остальными триггерами. Потом срабатывают триггеры ti_after_mission_start и все триггеры, интервал вызова у которых равен 0, поскольку на этом этапе запускается таймер миссии. Триггеры, срабатывающие по событию, не будут вызваны, пока это ti_* событие не произойдет. Остальные временные триггеры начинают вызываться где-то на первой секунде миссии, после выполнения всех триггеров ti_after_mission_start и с интервалами вызова 0.

Если у вас есть триггеры, которые не обязательно должны срабатывать сразу при запуске миссии, добавление в блок условий чего-нибудь в этом роде сильно поможет снизить нагрузку на процессор при запуске миссии:
(store_mission_timer_a, reg0),(gt, reg0, <время, прошедшее со старта миссии в секундах>),
Ни ti_before_mission_start, ни ti_after_mission_start не требуют использования "ti_once" в качестве перезарядки, поскольку они все равно и так будут выполнены только один раз.

Подводя итог, запуск миссии происходит в следующем порядке:
- Триггеры ti_before_mission_start
- Триггеры ti_on_agent_spawn
- Запуск таймера миссии
- Триггеры  ti_after_mission_start и триггеры с интервалом вызова равным 0
- Временные триггеры (с 1 секунды миссии)
- Триггеры по событию

Диалоги

Первая часть любого диалога, с которой он начинается, выглядит примерно так:

"[ ...какой-то код... ]"

Это код, отвечающий за проверку условий при вызове диалога. Единственное и главное его назначение – проверять, выполнено ли данное условие или набор условий и возвращать результат. Каждый диалог при вызове проверяет это условие до тех, пока оно не будет выполнено.

Далее идут последующие части диалога, которые выполняются, только в том случае, если проверка условий пройдена успешно и активна именно их ветвь диалога. Поэтому, если вы хотите, чтобы какое-то одно действие выполнялось всегда, когда, игрок, например, встречает Главнокомандующего во вторник, но совершенно другое – когда они встречаются в среду, диалог может выглядеть как-то так:

Код: [Выделить]

#Начало диалога
[
#См. header_dialogs, чтобы узнать, какие команды могут быть использованы здесь помимо "anyone".  Но любой диалог обязательно должен иметь строку "start",
anyone, "start",
#Начало стартового блока проверки условий
[
(eq, "$g_talk_troop", "trp_generalissimo_evilguy"),#Собеседник игрока – главнокомандущий?
(try_begin),
   (eq, "$g_day_of_week", 2),#Сейчас вторник?
   (assign, "$g_conversation_temp",1),
   (str_store_string, s17, "@Так начинается разговор по вторникам"),
(else_try),
   (eq, "$g_day_of_week", 3),# Сейчас среда?
   (assign, "$g_conversation_temp",2),
   (str_store_string, s17, "@ Так начинается разговор по средам "),
 (else_try), ,# Если сейчас не вторник и не среда
   (assign, "$g_conversation_temp",3)
   (str_store_string, s17, "@ Так начинается разговор во все остальные дни "),
(try_end),
],
#Допустим, проверка пройдена и собеседник игрока – главнокомандующий. Теперь надо вывести нужный текст
"s17",
#Теперь нужно добавить ответные реплики игрока, пускай даже какие-нибудь простейшие типа «Уйти» для выхода из диалога
"player_response_or_responses_here",
#Специальный код, если нужен:
[],
#Конец диалога
],
Но вообще создавать строки диалога, зависящие от классов,  в одном блоке условий, как это было сделано выше — довольно плохой тон. Так делать не стоит, поскольку больше вероятность сделать какую-нибудь логическую ошибку. Лучше заключать создание каждой строки в отдельный блок условий, вот так:

Код: [Выделить]

[anyone,"start", [(eq, "$g_talk_troop", "trp_player_castellan"),], "Что вам угодно, {playername}?", "castellan_talk",[]],
С помощью такого подхода можно сделать несколько вариантов начала разговора, используя несколько блоков условий:

[code][anyone,"start",
[
(eq, "$g_talk_troop", "trp_player_castellan"),
(eq, "$g_some_game_global", 1),
], "Что вам угодно,{playername}?", "castellan_talk",[]],

[anyone,"start",
[
(eq, "$g_talk_troop", "trp_player_castellan"),
(eq, "$g_some_game_global", 2),
], "А, это снова ты, {playername}! Подлый мерзавец,

Строки состояния

Строка состояния — это условное выражение, использующееся в строке для подстановки одной из двух данных строк в зависимости от значения определенного регистра. Если значение регистра не равно 0, подставляется первый вариант; в противном случае — если значение регистра равно 0 — подставляется второй вариант. Вари

Операции для работы с позициями.

Позиция (pos) - вид регистра позволяющий хранить x, y, z, координаты. используется для определения координат в сценах, в презентациях для определения расположения и размера контейнеров( блоков текста изображения из которых состоит) и для глобальной карты.
для сцен, для объектов сцены( агенты, сцен_пропсы) -

y ось, - вперед (положительное число)/назад(отрицательное число) по ходу движения агента 
x ось - вправо(положительное число/влево(отрицательное число) по ходу движения агента
z ось - вверх (положительное число)/ низ (отрицательное число) относительно положения земли в сцене.

Для презентаций -
х ось - справо налево.
у ось - снизу вверх.
нулевая отметка нижний левый угол. ( не уверен)

для глобальной карты
х.у.оси (горизонтальное положение) - установлены самой 3д моделью карты.
х - восток/запад
у - север/юг
 z ось - вертикальная ось относительно уровня земли

(copy_position,<position_no_1>,<position_no_2>),    - перепишет (x, y, z,) координаты из <position_no_2>   в <position_no_1>

(init_position,<position_no>), - устанавливает координаты позиции (0,0,0)

(get_trigger_object_position,<position_no>),- - запишет координаты позиции стрелкового оружия для которого используется триггер.( используется также в триггерах для сцен_пропсов при инициализации оного)

(get_angle_between_positions, <destination_fixed_point>, <position_no_1>, <position_no_2>), - Угол между *проекциями* векторов на горизонтальную плоскость.

(position_has_line_of_sight_to_position, <position_no_1>, <position_no_2>),- Название вполне очевидное. Функция проверяет, можно ли с позиции 1 увидеть позицию 2, или линия зрения блокирована землёй и/или объектами. В более ранних версиях операция была глючной, но в последних патчах (ЕМНИП не то с 1.134 или 1.142) её таки пофиксили. Это, однако, не гарантия, так что лучше проверять.Lav,

(get_distance_between_positions,<destination>,<position_no_1>,<position_no_2>), - запишет в переменную дистанцию между позициями. в санитметрах.

(get_distance_between_positions_in_meters,<destination>,<position_no_1>,<position_no_2>), запишет в переменную дистанцию между позициями. в метрах

(get_sq_distance_between_positions, <destination>, <position_no_1>, <position_no_2>),- запишет в переменную квадрат дистанции между позициями
в сантиметрах

(get_sq_distance_between_positions_in_meters,<destination>,<position_no_1>,<position_no_2>),- запишет в переменную квадрат дистанции между позициями в метрах

(position_is_behind_position,<position_no_1>,<position_no_2>), - проверит что вторая позиция расположена за первой.

(get_sq_distance_between_position_heights,<destination>,<position_no_1>,<position_no_2>), - запишет в переменную квадрат дистанции по высоте между 2 позициями.

(position_transform_position_to_parent,<dest_position_no>,<position_no>,<position_no_to_be_transformed>), - запишет в <dest_position_no> координаты <position_no_to_be_transformed> относительно <position_no>. 
пояснение - 
если вводится новая позиция <position_no_to_be_transformed> и с ней производятся действия перемещения или вращения после применения этой операции координаты позиции пересчитаются  по отношению <position_no> и запишется в <dest_position_no>.

(position_transform_position_to_local, <dest_position_no>,<position_no>,<position_no_to_be_transformed>), - обратная от предыдущей операция. позволяет определить ккординаты <position_no> относительно  <position_no_to_be_transformed>. координаты запишутся в <dest_position_no>

(position_copy_rotation,<position_no_1>,<position_no_2>), - скопирует вращение из <position_no_2>
в <position_no_1>.

(position_copy_origin,<position_no_1>,<position_no_2>), - скопирует координаты из <position_no_2> в <position_no_1>

(position_move_x,<position_no>,<movement>,[value]), - передвинет <position_no> по оси х .<movement> - число в сантиметрах.
[value] - необязательный параметр
0 - в сцене право лево
1 - на глобальной карте запад/восток

(position_move_y,<position_no>,<movement>,[value]), - передвинет позицию по оси у в сантиметрах.
параметр [value] как и у предыдущей.

(position_move_z,<position_no>,<movement>,[value]), передвинет позицию по оси z в сантиметрах.
параметр [value] как и у предыдущей.

(position_rotate_x,<position_no>,<angle>), задаст вращение позици по оси х в градусах.

(position_rotate_y,<position_no>,<angle>), - задаст вращение по оси у в градусах.

(position_rotate_z,<position_no>,<angle>,[use_global_z_axis]), - задаст вращение по оси z в градусах
[use_global_z_axis] - 1 - для глобалки. необязательный параметр

(position_get_x,<destination_fixed_point>,<position_no>) -  запишет в переменную координату позиции по оси х в метрах умноженное на   fixed point multiplier

(position_get_y,<destination_fixed_point>,<position_no>), запишет в переменную координату позиции по оси у в метрах умноженное на   fixed point multiplier

(position_get_z,<destination_fixed_point>,<position_no>), - запишет в переменную координату позиции по оси z в метрах умноженное на   fixed point multiplier

(position_set_x,<position_no>,<value_fixed_point>),- задаст координату позиции по оси х в метрах.
разделенное на   fixed point multiplier

(position_set_y,<position_no>,<value_fixed_point>), задаст координату позиции по оси у в метрах.
разделенное на   fixed point multiplier

(position_set_z,<position_no>,<value_fixed_point>), - задаст координату позиции по оси z в метрах.
разделенное на   fixed point multiplier

(position_get_scale_x,<destination_fixed_point>,<position_no>), запишет в переменную размер позиции по х оси в метрах умноженное на   fixed point multiplier

(position_get_scale_y,<destination_fixed_point>,<position_no>), - запишет в переменную размер позиции по у оси в метрах умноженное на   fixed point multiplier 

(position_get_scale_z,<destination_fixed_point>,<position_no>), - запишет в переменную размер позиции по z оси в метрах умноженное на   fixed point multiplier

(position_rotate_x_floating,<position_no>,<angle>), -  задает угол вращения умноженный на   fixed point multiplier вокруг оси х

(position_rotate_y_floating,<position_no>,<angle>), -   задает угол вращения умноженный на   fixed point multiplier вокруг оси у

(position_get_rotation_around_z,<destination>,<position_no>), - запишет в переменную угол вращение вокруг оси z в градусах

(position_get_rotation_around_x,<destination>,<position_no>), - запишет в переменную угол вращения вокруг оси х в градусах

(position_get_rotation_around_y,<destination>,<position_no>), - запишет в переменную угол вращения вокруг оси у в  градусах

(position_normalize_origin,<destination_fixed_point>,<position_no>),[/b] - Вроде как считает расстояние между нулём, т.е. точкой (0,0,0) и позицией. Достоверность данного утверждения не 100%, но близко.Lav,

(position_get_screen_projection, <position_no_1>, <position_no_2>), -Очень, очень интересная функция. Берёт объект на сцене, и возвращает координаты точки, в которой этот объект отображается *на экране*. После чего запускаем фоновую презентацию, и в этой точке вешаем какую-нибудь метку или ещё что.Lav,

Следующие 3 операции только для миссий. не используются на глобальной карте.

(position_set_z_to_ground_level, <position_no>), - автоматически задает координату по z оси на уровне земли в сцене. ( например спаун на энтри поинт, которая не всегда размещена на уровне земли. при использовании операции агент во время спауна автоматически получит  координату по z оси на уровне земли)

(position_get_distance_to_terrain, <destination>, <position_no>), - запишет в переменную дистанцию до уровня земли от позиции без учета того что находится между позицией и землей.

(position_get_distance_to_ground_level, <position_no>),- запишет в переменную дистанцию до уровня земли от позиции с учетом того что находится между позицией и землей. если будет сцен пропс то запишется дистанция до коллижена сцен пропса.

Операции для работы с агентом

Агент (agent ) - Субъект сцены. к агентам относятся  - мертвые, живые, раненые юниты, игрок , а также итем
лошадь, котарая может являться отдельным агентом сцены.

(agent_is_in_special_mode,<agent_id>), [/b] -  проверит что заданный агент в данный момент является участником действий которые определенны операциями.

(agent_is_routed,<agent_id>), - Проверяет, что агент сбежал из боя (запаниковал, добежал до края карты и исчез).

(get_player_agent_no,<destination>), - запишет в переменную игрока как агента

(get_player_agent_kill_count,<destination>,[get_wounded]), - запишет в переменную общее число убитых юнитов игроком.
[get_wounded] -
0 - общее число и убитых и раненных
1- только убитых.
(agent_is_alive,<agent_id>), -  проверит что заданный агент жив.
(agent_get_speed, <position_no>, <agent_id>), - запишет в позицию скорость агента по Х и У
(agent_refill_wielded_shield_hit_points, <agent_id>),- восстановит количество ХР щиту, который в данный момент в руках у заданного агента
(agent_is_wounded,<agent_id>),- проверит что заданный агент ранен.
(agent_is_human,<agent_id>), - проверит что заданный агент человек (не лошадь)
(get_player_agent_own_troop_kill_count,<destination>,[get_wounded]), -запишет в переменную общее число
[get_wounded] = 1 раненых и убитых
[get_wounded] = 0  убитых
союзников игрока.
(agent_is_ally,<agent_id>), - проверит что заданный агент принадлежит к союзной партии вступившей в бой на стороне игрока.
(agent_is_non_player, <agent_id>), - проверит что агент не является игроком.
(agent_is_defender,<agent_id>), - проверит что агент относится к стороне защитников.
(agent_is_active,<agent_id>), - проверит что агент активен.
(agent_get_look_position, <position_no>, <agent_id>), - запишет позицию на которую смотрит агент
(agent_get_position,<position_no>,<agent_id>), - запишет позицию на которой находится агент.
(agent_set_position,<agent_id>,<position_no>), -телепортирует агента на заданную позицию
(agent_set_look_target_agent, <agent_id>, <agent_id>), - принудит первого агента смотреть на второго агента
(agent_get_horse,<destination>,<agent_id>), - запишет в переменную агента-лошадь, которую имеет агент.
Примечание - запишет не ID Item лошадь а именно ай ди агент.
(agent_get_rider,<destination>,<agent_id>), - в данной операции в ID агента - лошадь. в переменную запишется ID агент всадник этой лошади.
(agent_get_party_id,<destination>,<agent_id>), - запишет в переменную ID партии к которой относится агент.
(agent_get_entry_no,<destination>,<agent_id>), -запишет в переменную Точку входа агента
(agent_get_troop_id,<destination>, <agent_id>), - запишет в переменную troop_id которое имеет агент человек.
(agent_get_item_id,<destination>, <agent_id>), - запишет в переменную item_id лошади которое имеет лошадь агент.
(store_agent_hit_points,<destination>,<agent_id>,[absolute]) - запишет в переменную число очков здоровья агента.
[absolute]=0 - запишет число в процентном соотношении
[absolute]=1 - запишет реальное число здоровья.
Дефолтно установлен процентный параметр
(agent_set_hit_points,<agent_id>,<value>,[absolute]), - задаст агенту заданное число очков здоровья
 [absolute]=0 - запишет число в процентном соотношении
[absolute]=1 - запишет реальное число здоровья.
Дефолтно установлен процентный параметр
(agent_deliver_damage_to_agent, <agent_id_deliverer>, <agent_id>, <value>, [item_id]), - заданный агент<agent_id_deliverer> нанесет заданное число урона второму агенту. если значение <= 0 урон будет высчитыватся движком из оружия которым наносится урон. опциональный параметр [item_id] позволяет указать оружие из которого будет высчитываться урон.
(agent_get_kill_count,<destination>,<agent_id>,[get_wounded]), - запишет в переменную количество
[get_wounded] = 1 раненых и убитых
[get_wounded] = 0  убитых
заданным агентом в текущем сражении
(agent_set_invulnerable_shield, <agent_id>, <value>), - при
 <value> = 1 - задает неуязвимость агенту
 <value> = 0 - отключает неуязвимость
(agent_get_wielded_item,<destination>,<agent_id>,<hand_no>), - запишет в переменную ID итема находящегося в заданной руке агента
<hand_no>=0 - правая рука
<hand_no>=1 - левая рука
(agent_get_ammo,<destination>,<agent_id>, <value>), - запишет в переменную количество боеприпасов для стрелкового оружия.
<value>= 1 для стрелкового которое в руках агента.
<value>= 0 для всего стрелкового что имеет в слотах агент
(agent_refill_ammo,<agent_id>),- восстановит количество боеприпасов для стрелкового и метательного оружия которое имеет агент.
(agent_has_item_equipped,<agent_id>,<item_id>), - проверит что агент экипирован определенной вещью.
(agent_set_scripted_destination,<agent_id>,<position_no>,<auto_set_z_to_ground_level>), - задает позицию на которую агент будет двигаться в обязательном порядке. после перемещения агент будет ждать дальнейшего скриптования в состоянии пассивной защиты ( атаковать врагов находящихся в радиусе действия оружия).
Примечание - процесс скриптования агента нужно начинать с позиции которую агент имеет в данный момент.
Опциональный параметр
<auto_set_z_to_ground_level> = 0 - оставит координату по оси Z та что задана в позиции
<auto_set_z_to_ground_level> = 1 - установит 0 по оси Z ( уровень земли).
(agent_get_scripted_destination,<position_no>,<agent_id>), - запишет позицию на которуюю заскриптован агент.
(agent_force_rethink, <agent_id>), -заставляет агента персчитать свои действия в ходе процесса скриптования.
(agent_set_no_death_knock_down_only, <agent_id>, <value>),- делает агента бессмертным подобно юниту герою. (<value> = 1), либо отключает заданное действо (<value> = 0)
(agent_set_horse_speed_factor, <agent_id>, <speed_multiplier-in-1/100>), - умножит скорость лошади которую имеет агент на заданное число.
(agent_clear_scripted_mode,<agent_id>), - очищает агента от заскриптованых действий
(agent_set_speed_limit,<agent_id>,<speed_limit(kilometers/hour)>), - установит лимит скорости агента (только для ии агентов,)
(agent_ai_set_always_attack_in_melee, <agent_id>,<value>), - вынуждает агента использовать оружие ближнего боя.(<value>=1), или очищает от данной операции .(<value>=0)
(agent_get_simple_behavior, <destination>, <agent_id>), - запишет в переменную  модель поведения ии агента . модель поведения установленна константами в header_mission_templates.py

# Agent AI Simple Behaviors
aisb_hold = 0
aisb_go_to_pos = 1
aisb_mount = 2
aisb_dismount = 3
aisb_melee = 4
aisb_ranged = 5
aisb_ranged_horseback = 6
aisb_charge_horseback = 7
aisb_maneuver_horseback = 8
aisb_flock = 9
aisb_race = 10
aisb_patrol = 11
aisb_no_enemies = 12
aisb_horse_hold = 13
aisb_horse_run_away = 14

(agent_get_combat_state, <destination>, <agent_id>), запишет в переменную combat_state(?) которое имеет агент.
константы покрыты мраком.. в МС имеется одно упоминание в скрипте "siege_move_archers_to_archer_positions_defender"
# 7 = no visible targets (state for ranged units)
(agent_set_animation, <agent_id>, <anim_id>, [channel_no]), заставит агента проигрывать заданную анимацию.
опциональный параметр  [channel_no] в дефолте 0
 [channel_no]=0 нижняя часть тела ( передвижение, смерть, анимация получения урона)
 [channel_no]=1 верхняя часть тела (анимация ударов стрельбы и тд)
(agent_set_stand_action, <agent_id>, <anim_id>), - назначает агенту анимацию пасивности( пример стражник в городе\ замке)
(agent_set_walk_forward_action, <agent_id>, <anim_id>), - хз

(agent_set_animation_progress, <agent_id>, <value_fixed_point>),- хз. по видимому задает скорость проигрования анимации

(agent_set_look_target_position, <agent_id>, <position_no>), - вынуждает заданного агента повернуться в сторону заданной позиции

(agent_set_attack_action, <agent_id>, <value1>, <value2>), - позволяет задать атакуещее действие агенту.
<value1> - -2 = отменяет любое действие
                  0 = колющий удар
                  1 = удар справа
                  2 = удар слева
                  3 = удар сверху
<value2>  0 = зарядить и выстрелить
                 1 = зарядить и ожидать

любое значение -1 - обнуляет действие

agent_set_defend_action, <agent_id>, <value>, <duration-in-1/1000-seconds>), - задает агенту действие защиты
value: -2 = отменяет любое действие
           0 =защита снизу
          1 = блок справа,
           2 = блок слева
            3 = блок сверху

(agent_set_wielded_item, <agent_id>, <item_id>), - заставит определенного агента, вооружиться оружием, при условии что заданый итем есть в инвентаре. в противном случае вернет -1

(agent_set_scripted_destination_no_attack,<agent_id>,<position_no>,<auto_set_z_to_ground_level>),
задает агенту ожидание следующей команды скриптованием на заданной позиции без атакующих действий

<auto_set_z_to_ground_level> - 0 - не установить позицию на 0 по оси зет ( уровень земли)
                                                              1 - установить позицию на нулевую отметку уровня земли.

(agent_fade_out, <agent_id>), - вынуждает заданного агента покинуть сцену с той позиции где находиться. попросту исчезнуть с сцены
(agent_play_sound, <agent_id>, <sound_id>), воиспроизведение заданного звука с позиции заданного агента.
(agent_start_running_away, <agent_id>, [position_no]), - задает агенту движение к краю сцены( побег)

(agent_stop_run_away, <agent_id>), -останавливает побег с сцены.

(agent_ai_set_aggressiveness, <agent_id>, <value>), - задает степень агрессивности агента. 100 - дефолтное значение

(agent_set_kick_allowed, <agent_id>, <value>), #0 for disable, 1 for allow- хз

не завершено.....

Бесценная работа Rongar,  по модификаторам.

header_item_modifiers.py

http://rusmnb.ru/index.php?topic=12300.msg468005#msg468005

РЕЗЕРВ

РЕЗЕРВ

РЕЗЕРВ

header_triggers.py

 используется только в файле module_simple_triggers

ti_simulate_battle       сработает при бое ии партий или автобое. в нативе не используется. из движка вызывается script_game_event_simulate_battle
ti_on_party_encounter    сработает при встрече партии игрока с любой другой партией. в нативе не используется. из движка вызывается script_game_event_party_encounter

используется только в файле module_mission_templates

ti_before_mission_start  сработает до старта миссии один раз. агентов нет на сцене.
ti_after_mission_start   сработает после старта миссии один раз. агенты присутствуют на сцене
ti_tab_pressed           сработает при нажатии tab. в игре это выход из миссии.
ti_inventory_key_pressed сработает при нажатии кнопки инвентаря. (в оригинале i/ш) - вызывает окно инвентаря в миссии
   (set_trigger_result,0), - по умолчанию. нельзя использовать
   (set_trigger_result,1), - дает доступ игроку к инвентарю
ti_escape_pressed        -сработает в момент нажатия эскейп 
ti_battle_window_opened  - сработает один раз при старте миссии . используется для вызова фоновых презентаций
ti_on_agent_spawn        - сработает при спауне агента
     Trigger Param 1:  agent_id
ti_on_agent_killed_or_wounded = сработает при смерти или при фатальном ранении агента.
   Trigger Param 1:  agent_id  - умерший агент
   Trigger Param 2:  agent_id  - агент убийца
   Trigger Param 3:  agent_id - раненый агент
ti_on_agent_knocked_down - сработает при падении агента на землю
   Trigger Param 1:  agent_id  - агент упавший
   Trigger Param 2:  agent_id - атакующий агент
ti_on_agent_hit        - сработает при получении урона агентом
    Trigger Param 1: урон полученный агентом
    Trigger Param 2: урон наносимый атакующим агентом
    Trigger Param 3: причененный урон
    Register 0: урон от оружия
    Position Register 0: позиция оружия с которой нанесен урон
  Trigger result: если значение больше или равно нулю урон будет высчитыватся из кода
ti_on_leave_area         = -30.0 сработает при выходе из миссии( выход уже был определен в предыдущем триггере)
ti_on_agent_mount        сработает в момент получения в сцене агентом лошади. (оседлает коня)
  Trigger Param 1: agent id - агент ставший всадником
  Trigger Param 2: horse agent id - лошадь агент оседланная.
ti_on_agent_dismount     сработает в момент потери агентом лошади
   Trigger Param 1: agent id - агент потерявший лошадь
   Trigger Param 2: horse agent id - лошадь
ti_on_item_wielded      - сработает в момент получения в руки оружия
  Trigger Param 1: agent id - агент получивший (экипировавшийся) оружием
  Trigger Param 2: item id - АйДи оружия
ti_on_item_unwielded     сработает в момент переэкипировки ( когда оружие убирается)
  Trigger Param 1: agent id - агент переэкипировавшийся
  Trigger Param 2: item id  - оружие убранное
 

используется только в файле module_scene_props

ti_on_scene_prop_init    сработает в момент появления сцен пропса на сцене
ti_on_init_scene_prop    = ti_on_scene_prop_init
Trigger Param 1: prop instance number - порядковый номер сцен пропса на сцене. не путать с АйДи как сцен пропс.

ti_on_scene_prop_hit     - сработает в момент получения урона сцен пропсом
 Trigger Param 1: prop instance number - порядковый номер сцен пропса
 Trigger Param 2: hit damage - поулученный урон
Position Register 1: Hit Position позиция в которую получен урон ( вернет координату на самом сцен пропсе например в месте попадания стрелы)
 Position Register 2: x holds attacker agent id пзиция агента атаковавшего сцен пропс.( по х сторона от сцен пропса)

ti_on_scene_prop_destroy - сработает в момент уничтожения сцен пропса
 Trigger Param 1: prop instance number порядковый номер пропса

ti_on_scene_prop_use     - сработает в момент использования сцен пропса агентом. с версии 1.151 работает и в сингле
 Trigger Param 1: user agent id - агент использующий пропс
Trigger Param 2: prop instance number порядковый номер пропса

ti_on_scene_prop_is_animating - сработает в момент когда сцен пропс имеет анимацию, которая предварительно была задана кодированием
 Trigger Param 1: prop instance number порядковый номер пропса
Trigger Param 2: remaining animation time -запишется время от старта анимации

ti_on_scene_prop_animation_finished - сработает в момент завершения пропсом анимации
 Trigger Param 1: prop instance number порядковый номер пропса на сцене

ti_on_scene_prop_start_use =сработает в момент начала использования пропса
 Trigger Param 1: user agent id агент использующий пропс
 Trigger Param 2: prop instance number номер пропса на сцене

ti_on_scene_prop_cancel_use сработает в момент завершения использования пропса агентом
Trigger Param 1: user agent id агент использовавший пропс
Trigger Param 2: prop instance number номер пропса на сцне

# используется только в файле module_items

ti_on_init_item          сработает в момент инициализации итема. например меч выхвачен из ножн.
Trigger Param 1: agent id агент использующий итем
Trigger Param 2:  troop id номер юнита использующий оружие
ti_on_weapon_attack     - сработает в момент проигрования анимации атаки.
Trigger Param 1: attacker agent id агент атакующий данным оружием
Position Register 1: Weapon Item Position позиция оружия в данный момент
ti_on_missile_hit       - сработает в момент попадания в цель стрелы, болта, пули, метательного оружия
Position Register 1: Missile Position позиция снаряда
Trigger Param 1: shooter agent id айди агента выстрелившего\метнувшего снаряд

#

используется только в файле module_presentations

ti_on_presentation_load сработает в момент старта презентации. в этом триггере определяются размери и стартовые позиции оверлеев.(кнопки текст меши-картинки и тд)
ti_on_presentation_run   = -61.0 срабатывает постоянно во время работы презентации. производятся манипуляции с изменением самой презентации
Trigger Param 1: текущее время работы презентации в милисекундах
ti_on_presentation_event_state_change - сработает в момент если игроком сделан какойто выбор при нажатии той или инной кнопки самой презентации
 Trigger Param 1: id of the object that has the event ид объекта презентации(как правило в этом случае он помещен в глобальнуюю переменную при старте объекта определении его позиции и размера)
Trigger Param 2: value (when available) - значение которое выбрано для объекта презентации ( например комбокнопка имеющая несколько вариантов выбора)
ti_on_presentation_mouse_enter_leave - сработает в момент попадания указателя мыши на определенный объект презентации
 Trigger Param 1: ид объекта презентации
Trigger Param 2: запмшет в переменную параметра 0 если указатель вошел в зону объекта, 1 если указаталь вышел
ti_on_presentation_mouse_press       сработает в момент нажатия кнопки мыши в зоне определенного объекта
Trigger Param 1: ид объекта презентации(как правило в этом случае он помещен в глобальнуюю переменную при старте объекта определении его позиции и размера)
Trigger Param 2: запишет в переменую парметра 0 левая клавиша мыши, 1 правая клавиша мыши, 2 средняя клавиша мыши

# используется только в файле module_map_icons

ti_on_init_map_icon    - сработает при инициализации иконки партии на глобальной карте
Trigger Param 1: id партии

могу только догадыватся -
ti_question_answered     
ti_server_player_joined 
ti_on_multiplayer_mission_end
ti_on_player_exit       
 Trigger Param 1: player_id
ti_on_item_picked_up     = -53.0 #can only be used in module_mission_templates triggers
# Trigger Param 1: agent id
# Trigger Param 2: item id
# Trigger Param 3: scene prop id (will be deleted after this trigger)
ti_on_item_dropped       = -54.0 #can only be used in module_mission_templates triggers
# Trigger Param 1: agent id
# Trigger Param 2: item id
# Trigger Param 3: scene prop id
ti_on_order_issued                 = -71.0 #can only be used in module_mission_templates triggers
# Trigger Param 1: order no
# Trigger Param 2: agent id

могу только догадыватся -
ti_question_answered

Отслеживает выполнение операции question_box
В нативе срабатывает в module_mission_templates в момент выбора "да" или "нет" после нажатия клавиши "Tab" когда игрок пытается досрочно выйти из боя.
trigger param: answer 0 or 1 (по умолчанию 0=да, 1=нет, хотя в question_box могут быть заданы любые строки для отображения вариантов ответа)
 
Добавлено: 05 Ноября, 2012, 13:33

Дополнение по get_party_ai_current_behavior
На самом деле эта операция запишет в переменную именно текущее поведение партии.
Дело в том, что партии на карте могут менять своё поведение по ситуации. Например патрулирующие бандиты начинают преследовать крестьян, при этом их основное поведение не меняется (проверено опытным путём: behavior преследующей крестьян партии бандитов остаётся неизменным patrol_location, тогда как current_behavior становится track_party).
Судя по всему это происходит на уровне движка и редактированию не поддаётся, т.к. не существует операции  set_party_ai_current_behavior.
Так что могу предположить, что behavior и current_behavior это разные захардконенные слоты партии, с разными значениями.

 
Добавлено: 05 Ноября, 2012, 13:50

Тоже самое касается и get_party_ai_current_object

Поправьте, если не прав.
Могу только предположить, что current_object и current_behavior назначаются движком в зависимости от aggressiveness и courage самой партии и bandit_attraction, carry_goods и carry_gold находящийся рядом партии (ну силы этих партий естественно), но точного алгоритма расчёта лично я не знаю.

Дополнение по party_force_add_members
Как выяснилось обычная party_add_members тоже игнорирует лимит партии
party_force_add_members Добавит юнитов к партии только при условии, что в партии нет ни одного такого же юнита.

РЕЗЕРВ

Ещё резерв

Здесь:

http://www.nexusmods.com/mountandblade/mods/3478/?tab=2&navtag=http%3A%2F%2Fwww.nexusmods.com%2Fmountandblade%2Fajax%2Fmodfiles%2F%3Fid%3D3478&pUp=1

можно скачать файл header_operations с описаниями функций МС на английском языке.