Working With Conversations and Interactions

Objective
The goal of this guide is to introduce creating Quest Items, using Variables, creating a Conversation, and making Props interactable. Advancing further into the Secret Lab is going to require interacting with a Computer. This will trigger a Conversation and result in acquiring a Quest Item. We're also going to set a Variable in the conversation; if the player has a high enough skill, this Quest Item will allow progress through a Door.
 * 1) Create a Quest Item
 * 2) Create a Variable
 * 3) Create a Conversation
 * 4) Make a Prop Interactable

Creating a Quest Item
First off we'll create a quest item that can later be acquired by the player in a conversation. Quest items can be found in the Story Data view.
 * 1) Click File -> Select New Quest Item
 * 2) Enter an Item Name (e.g. tut_s01_Security Code)
 * 3) Enter an UI Name (e.g. Security Code)
 * 4) Enter a Description (e.g. Access codes for the Securiy Lab doors)

The Editor keeps all Quest Items and Conversations of the entire Content Pack in the Story Data panel. It is recommended to come up a naming scheme to help keep all your data sorted. For example:
 * c01-s01_ConversationName
 * c01-s01_QuestItem

Like this, everything from Chapter01 - Scene01 will be grouped together.

Create a Variable
Lets create a variable for use in the conversation. These are stored in the Scene Data view.
 * 1) Right-Click Variables -> Select Create Variable
 * 2) Set the Property Name to AlarmOn
 * 3) Set the Property Type to Bool
 * 4) Select AlarmOn and set the Bool Value to True by checking the box.

Create a Conversation
With the Quest Item and Variable prepared we can go about setting up our Conversation. Conversations, like Quest Items, are stored in the Story Data view.
 * 1) Click File -> Select [[Image:IconNewConversation.PNG]] New Conversation
 * 2) Name the Conversation (e.g. "tut_s01_Computer")
 * 3) Select [END DIALOGUE]
 * 4) Click [[File:IconNewConversation.PNG]] to create a new item
 * 5) Select [End DIALOGUE]
 * 6) Enter "Renraku Lab Systems, Operating System v3.41 -- Main Menu" in the Dialogue tab.
 * 7) Click [[image:IconNewConversation.PNG]] and add 3 more items
 * 8) Select the first [END DIALOGUE]
 * 9) Enter Door Codes in the Dialogue Box
 * 10) Check Available Only Once
 * 11) With Door Codes still selected -> Click [[image:IconNewConversation.PNG]] to create a new item
 * 12) Select [End DIALOGUE]
 * 13) Enter "You access today's security codes." for the Dialogue
 * 14) Under the Type drop down select GM Voice
 * 15) Click the Conditions and Actions Tab
 * 16) Click [[image:IconAdd.PNG]] to add a new condition
 * 17) Right-Click No Effect -> Under Actors -> Select Add Item to Team
 * 18) Right-Click LightningBarrier5 -> Under Existing Items -> Under Quest Items -> Select tut_s01_Security Code
 * 19) Select the Renraku Lab Systems... node -> Click [[image:IconCopy.PNG]] to copy the node
 * 20) Select the "You access today's..." node -> Click [[image:IconNewConversation.PNG]] to create a new node
 * 21) Select [END DIALOGUE] -> Click [[image:IconPasteAsLink.PNG]] to paste the node as a link
 * 22) Select the second [END DIALOGUE]
 * 23) Enter Security Alarm in the Dialogue Box
 * 24) Check Available Only Once
 * 25) With Security Alarm selected -> Click [[image:IconNewConversation.PNG]]
 * 26) Select [END DIALOGUE]
 * 27) Enter "You turn off the Alarm system" in the Dialogue Box
 * 28) Under the Type drop down select GM Voice
 * 29) Click the Conditions and Actions tab
 * 30) Click [[image:IconAdd.PNG]] to add a new condition
 * 31) Select the Renraku Lab Systems... node -> Click [[image:IconCopy.PNG]] to copy the node
 * 32) Select the You turn off the... node -> Click [[image:IconNewConversation.PNG]] to create a new node
 * 33) Select [END DIALOGUE] -> Click [[image:IconPasteAsLink.PNG]] to paste the node as a link
 * 34) Select the Security Alarm node
 * 35) Click the Conditions and Actions tab
 * 36) Click [[image:IconAdd.PNG]] to add a new Prerequisite
 * 37) Right-Click No Effect -> Select Compare Actor Skill
 * 38) Right-Click Ranged Combat -> Under Preset Value -> Select Decking
 * 39) Right-Click Equal To -> Under Preset Vaue -> Select Greater Than or Equal To
 * 40) Enter   Decking 3   before Security Alarm in the Dialogue Box

The Computer
With the conversation all put together, we need something to start it. We'll use the computer in the corner of the southern room to make this happen.
 * 1) Select the computer prop
 * 2) In the Properties View change Prop Name from Cyberterminal to Computer
 * 3) Click [[image:IconHammer.PNG]]
 * 4) Change Interaction Type to  Generic Interaction

Create Trigger
We now need a trigger to fire off the conversation when the computer is interacted with
 * 1) Create a new Trigger in the Scene Data view
 * 2) Give the new Trigger a descriptive name (e.g. prp_Computer)

When

 * 1) Click [[image:IconAdd.PNG]] to create a new When Statement
 * 2) Right-Click the new When Statement -> Select On Item Interaction
 * 3) Set the item to "Computer"

Do

 * 1) Click [[image:IconAdd.PNG]] to create a new Do Statement
 * 2) Right-Click the new Do -> Under Dialogue -> Select Start Conversation
 * 3) Set the Conversation to start with Triggering Actor
 * 4) Check Retain this Trigger After Firing

The Door
Now that the player can recieve the quest item, lets create a door that can use it. We can use the door in the eastern room, just north of the computer. We will create a condition that checks that the player has the security codes. For added affect, we'll make it so the door can't be opened if the alarms are still on.
 * 1) Select the computer prop
 * 2) Click [[image:IconHammer.PNG]]
 * 3) Click [[image:IconAdd.PNG]] to add a new condition
 * 4) Right-Click No Condition -> Select Evaluate if Actor has Item
 * 5) Change Lightning Barrier 5 to tut_s01_Security Code
 * 6) Click [[image:IconAdd.PNG]] to add a new condition
 * 7) Right-Click No Condition -> Select Comparison (bool)
 * 8) Change False to AlarmOn

Testing the Scene
With everything in place it is time to test the scene. This requires the game client to be running with the content menu open.
 * 1) Select [[Image:IconTestScene.PNG]] Test Scene
 * 2) Select Hire Main Character from the Main Character Override drop down
 * 3) Click [[Image:IconTestScene.PNG]] Test Scene
 * 4) Switch focus to the Shadowrun game client
 * 5) Click "Continue" when the scene has finished loading