Просмотр исходного текста страницы Учебник SKV1991 Гонец

[[Category:Учебники]]
[[Category:New Users]]
[[Category:Серия учебников от SKV1991]]
{{Tutorial Index
|series=Создание квестов от SKV1991
|chapter=1
|Prev=:Category:Учебники
|Next=:Category:Учебники
|espInitial=EmptyPlugin.esp
|espCompleted=-
}}
{{IncompleteNoImage}}

В данном учебнике будет описан процесс создания гонца/курьера (''англ.'' messenger) в Скайрим, который сообщает о послании для игрока и добавляет квест.

'''Автор учебника:''' Кирилл SKV1991 Слатыков

'''Права:''' Копирование/изменение/перепечатка урока и материалов урока категорически запрещена.

= Обзор =
В данном учебнике будет рассмотрено:

* Создание квеста для гонца и настройка алиасов
* Написание скрипта для установки этапа квеста при активации объекта
* Использование текстовых подстановок для замены переменной на имя предмета из алиаса

= Создание квеста для гонца =
Для начала, небольшой совет - почаще сохраняйтесь!

Итак, первым делом необходимо создать [[Quest Script|объект квеста]], для этого в окне Object Window переходим в категорию ''Character > Quest'' и с правой части окна щелкаем правой кнопкой мышки и выбираем пункт New, откроется окно Quest с пустой формой квеста, здесь на вкладке '''Quest Data''' необходимо заполнить поля:

* '''ID:''' ''AAANewQuest01'' или свое имя, в пределах данного учебника я буду использовать такое имя, вы можете своё
* '''Quest Name:''' ''Печальная весть''
* '''Priority:''' ''60''
* '''Type:''' ''Side Quests''
* '''Start Game Enabled''' (отметить)

Нажимаем '''ОК'''

Теперь двойным щелчком открываем созданный только что объект квеста и переходим на вкладку '''Quest Stages''', далее в левой части окна в списке нажимаем ПКМ и выбираем ''New'' для создания нового этапа квеста.

Индекс этапа оставляем равным ''0'', правее отмечаем галочку '''Start Up Stage''' (начальный этап квеста), далее создаем новые этапы с индексами:
* ''10'' - На этом этапе игрок получит письмо от гонца
* ''20'' - Здесь игрок уже прочитал письмо, но ещё не пришел к цели
* ''30'' - Финальный этап, где игрок достиг указанной цели

На этапе ''30'' в списке над полем '''Log Entry''' нажимаем ПКМ > ''New'', ставим под полем ввода '''Log Entry''' галочку у '''Complete Quest''', потому что это конечный этап квеста.

== Алиас письма ==
Переходим на вкладку Quest Aliases, ПКМ в списке и нажимаем '''New Reference Alias''' для создания нового алиаса, после некоторого ожидания появится огромное окно '''Reference Alias''', которое может вылезать за границу экрана.

Заполняем алиас:
* '''Alias Name:''' ''Letter''
* '''Fill Type:''' ''Specific Reference''
* Отмечаем чекбокс '''Optional''' в верхней части окна (алиас будет заполнен потом, после начала квеста)
* И чекбокс '''Quest Object''' - значит этот предмет будет квестовый и его нельзя просто так выкинуть из инвентаря
* А так же чекбокс '''Stores Text''' - позволяет использовать название объекта, на который указывает алиас и подставлять его в тексте задания

Теперь нужно сделать несколько вещей, при получении письма изменить этап квеста на ''10'', и затем на ''20'' при его прочтении.

=== Добавляем скрипты ===

Для этого, нужно добавить к алиасу нашего письма два скрипта. В поле '''Scripts''' в правой части окна '''Reference Alias''' нашего письма нажимаем '''Add''' и в появившемся окне в поле фильтра вводим текст ''DefaultSetStageOnPlayerAcquire'' (стандартный скрипт, меняет этап квеста при получении предмета), выбираем его, нажимаем '''ОК'''.

После этого щелкаем по добавленному скрипту и справа нажимаем на кнопку '''Properties''', откроется окно со свойствами скрипта, настраиваем следующий образом:

* Выбираем '''myQST''', справа нажимаем '''Edit Value''' и, щелкнув по выпадающему меню, начинаем набирать на клавиатуре первые символы ID нашего квеста (''AAANewQuest01''), либо выбираем из списка вручную.
* В свойстве '''preReqStage''' оставляем значение по-умолчанию, оно отвечает за предыдущий необходимый этап квеста (допустим для этапа 20 сначала должен быть этап 10 и т.п.), оно нам не нужно в данном случае
* В свойстве '''StageToSet''' вводим значение ''10'' (это индекс этапа квеста, который будет установлен при получении игроком письма)
* Нажимаем '''ОК'''

Теперь нужно добавить второй скрипт, меняющий этап квеста при прочтении письма, для этого снова в секции '''Scripts''' нажимаем '''Add''' и в поле фильтра вводим: ''DefaultOnReadSetQuestStage'' (именно этот, НЕ с текстом NotAlias, обратите на это внимание).

Выделяем добавленный скрипт, нажимаем на кнопку '''Properties''' и настраиваем следующим образом:

* '''myQuest:''' ''AAANewQuest01''
* '''myStage:''' ''20''
* Нажимаем '''ОК'''

Переходим в поле '''Alias Name''', и удерживая ''Shift'' дважды нажимаем ''Tab'' на клавиатуре, а затем '''Enter''' (этим мы закроем окошко алиаса, сохранив изменения)

== Алиас стула ==
Теперь, нужно добавить второй алиас, который будет отвечать за то, что игрок сел на стул. Не закрывая окно квеста, подгружаем нужную локацию, в моем случае это интерьер ''WhiterunBanneredMare'', и позиционируем камеру над нужным стулом.

Создаем новый алиас и заполняем следующим образом:

* '''Alias Name:''' ''Stool''
* '''Fill Type:''' ''Specific Reference'' > '''Select Forced Reference''' и откроется окно выбора объекта, нажимаем '''Select Reference in Render Window'''.
* Курсор примет форму перекрестия [[Файл:CrosshairRed.png]] и наведя на нужный стул, курсор станет белым [[Файл:CrosshairWhite.png]] - сделайте двойной щелчок, убедитесь, что выбран нужный объект.
* Нажмите '''ОК'''

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

* Переходим в секцию '''Scripts''' алиаса стула и нажимаем '''Add''', в списке делаем двойной щелчок по '''[New Script]''' для добавления нового скрипта.
* Откроется окно '''Add New Script'''. Вводим следующее:
** '''Name:''' ''AAANewQuest01StoolScript'' (вообще хорошей практикой является присвоение имени квеста + имени алиаса + слово Script)
** '''Extends:''' ''ReferenceAlias''
** Нажимаем '''ОК''' и ждем, пока закроется окно добавления и скрипт добавится к алиасу
* ПКМ по добавленному скрипту, и выбираем пункт '''Edit Source'''
* Откроется окно редактирования исходного кода скрипта.

Нам нужно, чтобы при активации стула, менялся этап квеста, для этого используем событие [[OnActivate - ObjectReference|OnActivate]]:

<syntaxhighlight lang="papyrus">
Scriptname AAANewQuest01StoolScript extends ReferenceAlias

Event OnActivate(ObjectReference akActivator) ; При активации стула

  If ( Game.GetPlayer() == akActivator && GetOwningQuest().GetStage() < 30 && GetOwningQuest().GetStage() >= 20 ) ; Если активировал игрок И этап квеста меньше 30 И больше или равен 20
  
    GetOwningQuest().SetStage(30) ; Устанавливаем 30 этап квеста

  EndIf

EndEvent
</syntaxhighlight>

Нажимаем '''Ctrl+S''' или ''File > Save'', скрипт сохранится и скомпилируется, если в окне лога (в нижней части окна) нет ошибок, закрываем окно, если есть, проверяем где допустили ошибку.

Теперь переходим к полю '''Reference Name''', удерживая ''Shift'' дважды нажимаем ''Tab'' на клавиатуре, а затем '''Enter''' для сохранения алиаса.

== Настраиваем задачи ==
Переходим на вкладку '''Quest Objectives''' нашего квеста, ПКМ в верхнем списке и выбираем '''New''' для создания нового задания.

В секции '''Quest Objective Data''' вводим:

* '''Index:''' ''10'' (потому что это для 10 этапа квеста, с которого у нас фактически и начинается история)
* '''Display Text:''' ''Прочти <Alias=Letter>'' (помните, мы отмечали у алиаса письма чекбокс '''Stores Text'''? Данная конструкция будет заменена на имя предмета, на который указывает алиас)

Создаем новое задание:

* '''Index:''' ''20''
* '''Display Text:''' ''Следуй указаниям из <Alias=Letter>''

Нажимаем '''ОК''' для сохранения квеста и сохраняем наш плагин ('''Ctrl+S''' или ''File > Save'')

= Создаем письмо =
Переходим в категорию ''Items > Book'' окна '''Object Window''' и вводим в поле фильтра ''note'' для поиска по уже существующим письмам, и нам нужно взять за основу какое-нибудь письмо, я выбрал: MQ105Note, двойной щелчок по существующему предмету и меняем форму следующим образом:
* '''ID:''' ''AAANewQuest01Letter''
* '''Name:''' ''Записка от друга''
* ''Book Text:''
<pre>
<font face='$HandwrittenFont'>
Пожалуйста, встреться со мной в таверне Гарцующая кобыла. Сядь на стул.
</font>
</pre>
* Нажимаем '''ОК'''. Если появится окошко '''Check Spelling''' - нажимаем кнопку '''Ignore All'''.
* Появится окошко '''Create New Object?''' спрашивающее, хотите ли вы создать новый объект, нажимаем '''Yes''' (Да)

'''Примечание:''' Про создание книги можно почитать в [[Учебник SKV1991 Создание книги|уроке по созданию книги]].

= Пишем скрипт для квеста =
Возвращаемся обратно к нашему квесту ''AAANewQuest01'', открываем его форму для редактирования двойным щелчком, переходим на вкладку '''Quest Stages'''.

Выбираем ''0'' этап квеста, в правой части окна, в списке добавляем новую запись для лога: ПКМ > '''New'''

Переходим на вкладку Papyrus Fragment (скриптовой фрагмент) данной вкладки (в правой средней части окна), добавляем в качестве кода скрипта:
<syntaxhighlight lang="papyrus">
; Начало квеста
</syntaxhighlight>

Нажимаем '''ОК''', для сохранения квеста, затем открываем его снова и переходим на ту же вкладку на тот же этап квеста, и под тем местом, где писали код скрипта, нажимаем кнопку '''Properties'''.

Откроется окошко с выбором свойств скрипта, нам нужно добавить новое свойство, нажимаем кнопку Add Property, и заполняем следующим образом:

* '''Type:''' ''Quest''
* '''Name:''' ''WICourier''
* Нажимаем '''ОК'''

Свойство автоматически заполнится значением WICourier.

Добавляем ещё одно свойство со следующими параметрами:

* '''Type:''' ''Book''
* '''Name:''' ''Letter''
* Нажимаем '''ОК'''

Присваиваем этому свойству значение: ''AAANewQuest01Letter''

Нажимаем '''ОК''' для закрытия окна свойств.

Переходим снова к скриптовому фрагменту (Papyrus Fragment) и дополняем код следующим образом:

<syntaxhighlight lang="papyrus">
; Начало квеста
alias_Letter.ForceRefTo(Game.GetPlayer().PlaceAtMe(Letter)) ; Создаем экземпляр письма под ногами игрока и заполняем им алиас
(WICourier as WICourierScript).addAliasToContainer(alias_Letter) ; Добавляем алиас с письмом гонцу (перемещаем в его инвентарь)
</syntaxhighlight>

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

Теперь переходим к этапу ''10''. Добавляем новую запись для лога через ПКМ в списке справа и выбираем '''New'''. Здесь мы покажем какие добавлены задания.

В скриптовом фрагменте пишем:

<syntaxhighlight lang="papyrus">
SetObjectiveDisplayed(10) ; Для отображения уведомления о смене этапа квеста
</syntaxhighlight>

Переходим к этапу ''20''. Добавляем запись для лога.

В скриптовом фрагменте пишем:

<syntaxhighlight lang="papyrus">
SetObjectiveCompleted(10) ; Уведомление о выполнении предыдущего этапа квеста
SetObjectiveDisplayed(20) ; Для отображения уведомления о смене этапа квеста
</syntaxhighlight>

И наконец, у 30 этапа в скриптовом фрагменте пишем (запись для лога уже создавали):

<syntaxhighlight lang="papyrus">
SetObjectiveCompleted(20) ; Уведомление о выполнении предыдущего этапа квеста
</syntaxhighlight>

Нажимаем '''ОК''' для сохранения квеста и сохраняем плагин.

= Диалог гонца =
Открываем существующий квест WICourier, переходим на вкладку Dialogue Views и двойной щелчок по ответу вроде: ''Письмо... не знаю от кого. Он не назвался. Сказал что просто твой друг.''

Откроется окно Topic Info. Здесь в списке условий '''Conditions:''' двойной щелчок по последнему условию (GetItemCount) и откроется окошко '''Condition Item''', тут нужно поставить галочку около '''OR''' и нажать '''ОК'''.

Далее добавляем свое условие, ПКМ в этом списке и выбираем '''New''', и настраиваем:

* выпадающее меню '''Condition Function:''' ''GetItemCount'' (можно начать набирать на клавиатуре первые буквы)
* в выпадающем списке '''Run On:''' ''Quest Alias'' и в выпадающем списке правее этого выбираем ''Container''
* галочка у чекбокса '''OR'''
* нажимаем по кнопке с текстом '''INVALID''' и в окне '''Select Function Parameters''' из выпадающего меню выбираем ''AAANewQuest01Letter''
* нажимаем '''ОК'''
* нажимаем '''ОК'''.

Теперь в списке условий выделяем условие с Function Info: ''Alias: Courier'' и используя кнопку [[Файл:Larr_button.png]] с левой стороны под списком условий перемещаем это условие в верх стека (списка) условий. Нажимаем '''ОК'''.

'''Примечание:''' Кстати, можно добавить и свой вариант текст для гонца, для этого нужно сделать двойной щелчок по заголовку топика. Там нажать ПКМ > New и создать свой вариант ответа со своим звуком. Однако голос гонца и ваш скорее всего будут различаться, так что мы ограничились таким вариантом.

Нажимаем '''ОК''', сохраняем квест. Сохраняем плагин.

= Финальные штрихи =
Итак, нам осталось указать игроку, куда идти, для этого нам нужно добавить маркер карты, который будет отображаться на карте и компасе игрока.

Для этого открываем наш квест (''AAANewQuest01'') и переходим на вкладку '''Quest Objectives''' и выбираем задание с индексом ''20''.

В секции '''Quest Objective Data''' в списке нажимаем ПКМ > '''New'''.

Ниже, в секции '''Quest Target Data''' в выпадающем меню '''Target Alias''' выбираем ''Stool''. Галочку у '''Compass Markers Ignore Locks'''. Нажимаем '''ОК'''.

Сохраняем плагин.

= Принцип работы гонца =
Итак, если мы перейдем в категорию ''Character > SM Event Node'' окна '''Object Window''' и очистим поле фильтра, то увидим в списке событие ''Change Location Event'' и прокрутив список ниже, если выбрать ''Stacked Quest Node: WICourierNodeSharesEvent'', то в списке условий в нижней части окна мы увидим множество разных условий, которые проверяются каждый раз при смене локации игроком. Здесь есть следующие условия:
* Включен ли флаг ''WIEventsEnabled''
* ''WICourierItemCount'' говорит, что игроку нужно доставить 1 предмет и более, и увеличивается каждый раз, при добавлении алиаса в контейнер гонца.
* Изменилась ли локация ''LocTypeHabitation''
* Тип локации НЕ ''LocTypeOrcStronghold'' (гонец не будет искать игрока, если тот находится в орочьей крепости)
* Не находится ли игрок в Коллегии Магов Винтерхолда
* Не находится ли в Хеллгене (первая локация, куда нас в повозке привозят)

Теперь, если взглянуть на вкладку '''Scripts''' квеста ''WICourier'' и посмотреть исходный код скрипта ''WICourierScript'', то есть функция, к которой мы обращались, разберем её:
<syntaxhighlight lang="papyrus">
Function addAliasToContainer(ReferenceAlias refAliasToAdd)
{ Добавляет экземпляр объекта из RefAlias в контейнер гонца, увеличивает значение глобальной переменной для включения отслеживания события смены игроком локации (Change Location Event) для квеста }

  ObjectReference vObjectRefToAdd = refAliasToAdd.GetReference() ; Получаем ссылку на объект в алиасе
  AddRefToContainer(vObjectRefToAdd) ; Вызываем функцию добавления объекта в контейнер гонца

EndFunction

Function AddRefToContainer(ObjectReference objectRefToAdd)
{ Добавляет объект в контейнер гонца, увеличивает значение глобальной переменной для включения отслеживания события смены игроком локации (Change Location Event) для квеста }

  pCourierContainer.addItem(objectRefToAdd) ; Добавляем переданный в качестве параметра предмет в контейнер гонца
  incrementItemCount() ; Увеличиваем число предметов

EndFunction
</syntaxhighlight>

''pCourierContainer'' - это свойство, указывающее на контейнер WICourierContainerRef в ячейке WICourierCell, из этой же локации берется и сам гонец, а игра просто телепортирует нужные объекты в нужное место.

То есть, как только добавляется предмет в этот контейнер, он переходит в инвентарь гонца, и тот телепортируется недалеко от игрока, доставляя ему этот предмет. Потом перемещает гонца обратно, пока не появится новый предмет.

Вот собственно и все, удачи в ваших экспериментах!