Тутор по добавлению background-скриптов

Spoiler (expand)

Перевод камрада HouseOfHam
Ниже-следующее - авторский, т.е. мой собственный, перевод моей-же статьи с анлийского. Оригинал тут: To view the link Register

В начале, немного терминологии:

campaign script (скрипт компании) - Скрипт вызываемый в конце файла descr_strat.txt и исполняемый только один раз, в момент создания новой компании. Пока этот скрипт работает, нет возможности сохранить или загрузить игру. Из-за этого желательно делать такой скрипт коротким и использовать его только для инициализации и что-бы завести фоновой скрипт. Самый известный пример использования такого скрипта - в компании Sons of Mars (Сыны Марса) в ванилле.

background script (фоновой скрипт) - Этот вид скриптов заводится посредством советника и, как явствует из имени, работает на заднем фоне. Основные преимущества таких скриптов: 1) Возможность сохранять/загружать игру пока они работают, и 2) Возможность перезапустить такой скрипт после перезагрузки сохранённой игры. Этот тип скриптов так же известен как showme script из-за того что старый метод запуска таких скриптов требовал нажатия кнопки советника 'Show me how...' ('Показать как...'). Скрипты этого типа часто используются для эмуляции таких вещей как 4 (или больше) хода в год и открывают широкие возможности для динамической постановки задач игроку по ходу компании, автоматического создания армий и зданий при выполнение определённых условий, и т.д.

on-demand script (скрипт исполняемый по требованию) - Этот вид скриптов используется для выполнения небольших фрагментов кода. Скрипт заканчивает работу как только код выполнен. Например, некоторые моды используют скрипт что-бы заставить ИИ принять дипломатическое предложение сделанное игроком. Этот вид скриптов тоже посылается на изполнение посредством советника, и заводится нажатием какой-нибудь редко-используемой кнопки в интерфейсе. Напримет, кнопки '?' в свитке помощи.

Как создать background script

Данные здесь инструкции покажут Вам все действия необходимые для создания фонового скрипта.

Для того что бы скрипт заработал, необходимо как минимум выполнить инстрикции в частях I и III. Часть II делать не обязательно, но желательно, что бы игроку не пришлось жать на лишние кнопки. Часть IV содержит различную дополнительную информацию которая должна помочь Вам узнать больше о том как писать скрипты.

Часть I: Создаём новое задание (AdviceThread) для советника

1. Вставьте этот код в начало файла export_descr_advice.txt :

<br />;------------------------------------------<br />AdviceThread My_Script_Thread<br />    GameArea Campaign<br /><br />    Item my_script_Item_1<br />        Uninhibitable<br />        Verbosity  0 <br />        Threshold  1 <br />        MaxRepeats  0 <br />        RepeatInterval  1 <br />        Attitude Normal<br />        Presentation Default<br />        Title my_script_Title_1<br />        On_display scripts\show_me\my_script.txt<br />        Text my_script_Text_1<br />

Строка On_display связывает это задание с указанным на ней скриптом. Сам скрипт включится автоматически как только откроется окно с текстом сообщения советника. Если настроить советника выдавать только голосовые сообщения, скрипт включится как только портрет советника появится на экране.

2. В конце файла export_descr_advice.txt добавьте вот это:

<br />;------------------------------------------<br />Trigger my_script_trigger_1<br />    WhenToTest ButtonPressed<br /><br />    Condition I_ThreadCount My_Script_Thread = 0<br />    <br />    AdviceThread My_Script_Thread  1<br /><br />;------------------------------------------<br />Trigger my_script_trigger_2<br />    WhenToTest CharacterSelected<br /><br />    Condition I_ThreadCount My_Script_Thread = 0<br />    <br />     AdviceThread My_Script_Thread  1<br /><br />;------------------------------------------<br />Trigger my_script_trigger_3<br />    WhenToTest SettlementSelected<br /><br />    AdviceThread My_Script_Thread  1

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

3. Добавьте этот код в конце файла text\export_advice.txt :

<br />{my_script_Title_1}Фоновой скрипт<br />{my_script_Text_1}Скрипт включён.<br />

Это текст который выдаст советник когда скрипт будет запущен.

Часть II: Автоматический запуск фонового скрипта при создании новой компании

1. Добавьте следующий код в самом конце файла descr_strat.txt:

<br />script<br />campaign_script.txt<br />

Этот код будет автоматически включать фоновой скрипт командами из скрипта компании.

2. В той-же папке где находится файл descr_strat.txt, создайте новый файл с именем campaign_script.txt (наш скипт компании) и впишите в него эти команды:

<br />script<br /><br />wait 1<br />console_command clear_messages<br />wait 1<br />advance_advice_thread My_Script_Thread<br />wait 1<br />select_ui_element advisor_portrait_button<br />simulate_mouse_click lclick_up<br /><br />end_script<br />

ВАЖНО: Этот файл следует сохранять в формате ANSI!

Часть III: Создаём фоновой скрипт - Что должно быть в этом скрипте

1. В папке scripts\show_me, создайте файл с именем my_script.txt <-- Это файл на который указывает строка On_display в AdviceThread в Части I. Традиционно, мододелы хранят скрипты в этой папке, но вообще-то можно держать их где угодно под папкой Data, при условии что строка On_display показывает правильное местоположение скрипта.

2. Что должно быть в самом скрипте:

<br />script<br /><br />; Всё что на строке после точти с запятой считается комментариями и игнорируется игрой<br /><br />; Убрать советника с экрана<br />select_ui_element advisor_dismiss_button<br />simulate_mouse_click lclick_up<br /><br />; Ждём пока советник не исчезнет<br />while I_AdvisorVisible<br />end_while<br /><br />suspend_unscripted_advice true<br /><br />; Открывать окно с текстом сообщения советника автоматически когда используется команда advance_advice_thread.<br />; Рекомендую пользоваться этим методом вместо комбинации команд select_ui_element + simulate_mouse_click.<br />; Не пытайтесь использовать оба метода одновременно, или советник будет появляться и сразу изчезать с экрана.<br />declare_show_me<br /><br />; Весьма полезная команда на стадии отладки - уберите точку с запятой в начале следующей строки что бы включить<br />;console_command toggle_perfect_spy<br /><br />; Ловим перезагрузку игры и отключаем старый скрипт.<br />monitor_event GameReloaded TrueCondition<br />  terminate_script<br />end_monitor<br /><br />;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;<br />;;; Добавляем здесь Ваш код<br />;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;<br /><br />; Например, такой код будет добавлять вам по 1 золотому в начале каждого хода<br />monitor_event FactionTurnStart FactionIsLocal<br />  console_command add_money 1<br />end_monitor<br /><br />;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;<br />;;; Конец Вашего кода<br />;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;<br /><br />; Бесконечная петля - Не даём скрипту закончиться, иначе все мониторы объявленные в этом скрипте и следящие за событиями в игре отключатся.<br />while I_TurnNumber < 99999<br />  suspend_unscripted_advice true<br />end_while<br /><br />end_script<br />

ВАЖНО: Этот файл следует сохранять в формате ANSI!

Учебник по скриптам для Rome Total War 2-я часть

Spoiler (expand)

Перевод камрада HouseOfHam
Часть IV: Учимся писать скрипты - Где найти инфомацию

1. Другие ресурсы

Рекомендованные материалы (на английском):

- Введение в Скриптинг, Часть 1 - To view the link Register
- Введение в Скриптинг, Часть 2 - To view the link Register
- Статьи в форуме To view the link Register

Референсные материалы:

- Список комманд для скриптов от ведущего разработчика игры (Jerome Grasdyke из Creative Assembly) за Сентябрь 2005-го - To view the link Register
- Список элементов интерфейса доступных для скриптов - To view the link Register

Где можно спросить совет по скриптам (на англ.):

- Форум на Total War Center - To view the link Register
- Форум на Total War .org - To view the link Register

2. Советы и коментарии из моего собственно опыта:

- Следующие команды не работают внутри блоков monitor_event: wait, campaign_wait, battle_wait, while, и под-блоки monitor_event/monitor_conditions. При попытке так их использовать, скрипт виснет.

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

- Исключением из выше-приведённого правила являются команды имя которых начинается с "I_" и console_command-ы, так как параметры для этих команд - имена конкретных объектов, либо они не нуждаются в параметрах.

- Настоятельно рекомендую добавить параметр -show_err к строке "Target Line" в закладке.

- Ошибке в командах console_command никогда не показываются и не могут привести к вылету из игры. Они просто тихонечко игнорируются.

- Другие ошибки, в зависимости от их серьёзности, могут привести к вылету из игры или к показу окошка с ошибкой при выходе из игры.

- Некоторые команды могут приветси к зависанию игры, так что она совершенно перестаёт реагировать, даже на Alt-F4. У меня такое произошло когда Я попытался добавить такой код:

<br />monitor_event CharacterSelected CharacterIsLocal<br />    call_object_shortcut hud_select_prev_item_cycle<br />end_monitor<br />

Проверять его на себе не стоит!

- При нажатии мышкой на армию в поселении, событие CharacterSelected НЕ генерируется

- Скриптом можно передвинуть только те армии которые находятся вне поселений

- Что эффективно писать скрипты, следует иметь базовое понимание того как работают следующии вещи: descr_strat.txt, советник, трейты и свита, здания, и юниты.

- В отличии от МТВ2, счётчики (counter-ы) НЕ сохраняют своё значение когда сохраняешь игру. По этому для хранения важной информации используемой скриптом приходится пользоваться другими методами. Например, трейтами (особенно помеченные как hidden), уникальными персонажами свиты, и зданиями в ключевых поселениях.

- Счётчик AdviceThread увеличивает своё значение при нажатии на портрет советника (что-бы открыть окошко с текстом).

- Событие AbandonShowMe генерируется при нажатии кнопки 'X' советникa.

Все вопросы по данному сообщению, задавайте здесь - To view the link Register

Community Imperial: Тутор по добавлению background-скриптов - Сообщество Империал

Тутор по добавлению background-скриптов