Difference between revisions of "A beginner's guide, lesson 6 - Quest Dialogue"

'''TES IV: Oblivion Modding for Beginners

This is the Sixth in a proposed series of Tutorial Lessons aimed at teaching how to mod TES IV: Oblivion aimed at beginners. It will build up into a Complete Modding Course. Don't worry there are no exams, though there is some homework. This version has been written for use on the forum. The RTF version contains additional material left out due to formatting limitations

'''Files

I have uploaded some files in a zip which we will used to accompany the next few tutorials.  

'''A. BGModTutBase.esp:''' This contains a building, a farmhouse, and a dungeon that we will use as sets in lessons 6, 7 and 8. This file is referred to in the text as the BASE files

'''B. BGModTutPlayTest.esp:''' This is the interim quest mod illustrating the stage you should have reached prior to polishing the mod. This is referred to in the text as the PLAYTEST files

'''C. BGModAnvilCheat.esp:'''This is a small optional cheat mod to give users 5000 septims to allow them to follow this tutorial if they have not completed the quest. (See Introduction to lesson 4)

It is being assumed that you have completed lessons one to three, and that that you have at least read through the appendix section on the Quest Interface.

It doesn't stop the quest running. You can repeatedly play the on-screen text by selecting the topic message for you until you get the message

|  BGMMessage4u (Message for you)

|  I hear a Lawyer called Vilanus Villa is looking for you

| GetIsRace Argonian == 0 etc.<br>

GetInCell ‘IC’ == 1<br>

GetInFaction ‘ICFaction’ == 1<br>

GetIsID BGVilanusVilla == 0<br>

GetStage BGM001 < 10<br>

| BGVilanusVilla (in add topic box)

|  SetStage BGM001 10 (compile)

I'll use these summaries throughout these tutorials as a direction for you to use. I have used this table as a template when planning my own quests and found them really useful. Remember if you get stuck refer to the PLAY TEST version to see how it should look.

''I have been told a lawyer called Vilanus Villa is looking for me. I should find out where he is staying. He may have important news for me.''

Ok, we have now added a topic called '''BGMMessage4u.

When you click on the "BGMMessage4u" topic in the game the topic Vilanus Villa will now automatically be added.  

Select the BGVilanusVilla topic we added earlier and add a response (See table below). This response should direct the player to the Talos District of the Imperial City.  

Since this is a direct follow-on from "BGMMessage4u", we can use the same conditions to do the job.  

In the "BGMMessage4u" condition box, right click and select copy all conditions and then paste these into the BGVilanusVilla response.  

This response is fine, unless of course we are already in the Talos district.

We need to add one more condition to account for this by using the [[GetInCell]] function.

!  TOPIC

|  BGVilanusVilla (Vilanus Villa)

|  I believe he is staying in the Talos district

| GetInRace Argonian == 0 etc.<br>

GetInCell ‘IC’ == 1<br>

GetInFaction ‘ICFaction’ == 1<br>

GetIsId BGVilanusVilla == 0<br>

GetStage BGM001 < 20<br>

'''GetInCell ‘ICTalosDistrict’ == 0'''<br>

For this topic we need to add another response.  

This one should direct the player to the Imperial Hotel where we placed Vilanus Villa. Again we can copy the conditions across by using the copy and paste method, and then change the last condition to 1.

!  TOPIC

|  BGVilanusVilla (Vilanus Villa)

|  I believe he is staying in the Imperial Hotel

| GetInRace Argonian == 0 etc.<br>

GetInCell ‘IC’ == 1<br>

GetInFaction ‘ICFaction’ == 1<br>

GetIsID BGVilanusVilla == 0<br>

GetStage BGM001 < 20<br>

'''GetInCell ‘ICTalosDistrict’ == 1'''<br>

If you wanted to get really flashy we could add another response for the occasions when we ask NPCs about Vilanus Villa in the hotel itself.  

However, I have not done this to save a bit of time. Feel free to try this yourself. A response like ‘Yeah I've seen him around here.' would do.  

Don't forget to copy the conditions and alter the GetInCell parameter.

Another way to pass on information via dialogues is to use the GREETING topic. If you remember the discussion in lesson four about how conversations work, all dialogues begin with a GREETING, which is selected by the game from the GREETING topic.  

In the topics tab select Right Click-Add and add GREETING. This already exists so you will not need to create a new topic when the list appears.

This is quite a long response so we should split it up.

This reduces the amount of text that appears on the screen at any one time.  

:''Hello, my name is Vilanus Villa and I've been looking for you. I'm afraid I have some bad news

Then in the center response details box, not the upper info box, right click and add a new response. You'll get a new interface to write in.

 

:''Your uncle has passed away peacefully in his sleep.

:''I have been asked to look after his last will and testament

We can go adding new lines to this response info if we wish. In the top box we can see the number of responses increments to 3. The text appears in the top box as:

Hello, my name is Vilanus Villa and I've been looking for you. I'm afraid I have some bad news || Your uncle has passed away peacefully in his sleep. || I have been asked to look after his last will and testament.''

With the || indicating the separate lines of this single response info

We need to add some conditions, to control who says these lines. This is very important when using the GREETINGS topic as this is so wide spread within the game. While it is silly that every character could respond to BGMMessage4u, it is dangerous to have an unconditional greeting as this might override every other Greeting in the game and prevent other quests from running as intended.

We can use the GetIsID function.  

We need to have an NPC reference which is why we built BGVilanusVilla first. We will also restrict this response to the opening stage of our quest.

* '''GetStage BGM001==10'''

* '''GetIsID BGVilanusVilla==1'''

Now we want to add a new topic called BGWill. However, there is an issue (and many thanks to Hecks for pointing this out) when adding topics to the GREETING or indeed any existing Bethesda topic. For technical reasons, the topic might not get added if more than one plug-in is attempting to use GREETING to add a topic.

First create a new topic which we can reference called BGWill (Right Click, etc).  

Now add this by now familiar script function to the result script for this info response.

We can stop this by setting up what I call a conditional pair of responses.

 

This is automatically set at zero. We can use the response result box to bump this up to one after speech with this bit of script.

Don't forget to click the compile button.

Summarising the first response

!  TOPIC

* Hello, my name is Vilanus Villa and I've been looking for you. I'm afraid I have some bad news.

* Your uncle has passed away peacefully in his sleep.

* I have been asked to look after his last will and testament.

| GetStage BGM001==10<br>

GetIsID BGVilanusVilla==1<br>

'''GetQuestVariable BGM001.MetVilla == 0'''<br>

| BGWill

|  Set BGM001.MetVilla to 1

We can then add this alternative response info to the GREETING topic

!  TOPIC

|  Whenever you want to talk about your uncle's will, let me know

| GetStage BGM001==10<br>

GetIsID BGVilanusVilla==1<br>

'''GetQuestVariable BGM001.MetVilla == 1'''<br>

|  ''No script''

|  ''No add topic''

We can now add another multi-line response info to the BGWill topic added by the first response.  

You will need to add a new topic called BGHubart.

!  TOPIC

|  BGWill

* Apparently your uncle has some property here in Cyradiil. I am not sure where though.

* I was expecting a courier to deliver the details but he has not shown up.

* Captain Hubart of the Chorrol Guard has written to explain the courier did not make it to his Chorrol rendezvous.

* You will have to go to Chorrol to check with him what is going on. Here is a copy of his letter.

| GetStage BGM001==10<br>

GetIsID BGVilanusVilla==1

| BGHubart

|  SetStage BGM001 20

:''I have been told that I may have inherited some property, but the courier carrying the details has gone missing. I will need to go to Chorrol and speak to a Captain Hubart of the Chorrol guard to get more details

Again we can create a ‘new' item, but it means trying to add artwork to the game, and unless we want the letter or scroll to look completely unique, and have some talent in that direction, it is a chore we don't need to do.

Instead select any letter from the object/items/books list in the object window, change its ID to something meaningful like ‘BGHubartLetter'  

The text on the right hand side indicates the content of the letter. We can edit this. I will look at the precise details and syntax needed to produce text in  another lesson.  

It uses standard HTML instructions.  

For now the key command is <nowiki><br></nowiki> which produces a line break, or new line. Leave the font face alone.

I regret to inform you that the White Horse courier Janus Jakobs, who you asked me to meet, has not arrived for her expected rendezvous. I know you where expecting some important documents to arrive.<br>

I don't have enough man power to launch a search. Perhaps you can find someone willing to assist in finding Jakobs.

I look forward to hearing from you old friend.

Save the letter as a new form.

Now type this in the results script box for Stage 20 and compile it using the button below.

  Player.additem "BGHubartLetter" 1

We can also add a new response info to the topic called BGHubart, to direct the player to Chorrol

!  TOPIC

|  BGHubart (Captain Hubart)

|  You’ll find him in Chorrol

| GetStage BGM001==20<br>

GetIsID BGVilanusVilla==1

We have completed phase one, now we move to Chorrol.

Objectives: - In this phase of the quest we want to use a new NPC called Hubart to direct the player to solve a mystery. He will direct the player to a cottage, where they will discover a mysterious medallion and the dead body of the courier. Hubart will then be able to help us move on to Aleswell and the next phase.

 

Again we need to add the NPC first so we can reference him in conditions.

We can again use a new NPC object, but it really saves a lot of time and effort if we simply change the name and ID of an existing Chorrol Guard, I used ChorrolGuardPatrolNight01. Give him a ID to suit like BGCptHubart (Captain Hubart).

Again strip out his AI, but we can leave his inventory as is, since the Chorrol guards' inventory already contains all we will need. We can also leave the factions alone as they work fine. I placed Hubart outside the Fire and Steel. (Hint a fast way to get to an exterior cell is to select the Fire and Steel interior, and the click on the teleport marker by the door)

This is only his starting position. We can add AI's later to move the character about.

We have to set up a new responses to the BGHubart topic.

We could add a new topic but it is always a good idea to try to limit how many new topics we add, this reduces the ‘footprint' of the mod, and helps avoid possible conflicts with other mods.

We want to set up a response that when any Chorrol based NPCs are questioned they will direct the PC toward the likely location of the good captain. Add conditions to limit, race to human, saving all that MP3 work, and the location to the Chorrol dummy cell. We can also limit the ‘timescale' to the current quest stage. Try this yourself. You can always refer to the play test version if you get stuck.

!  TOPIC

|  BGHubart (Captain Hubart)

|  Ah yes I know him. He is usually on duty near the Fire and Steel

| GetInRace Argonian == 0 etc.<br>

GetInCell ‘Chorrol’ == 1<br>

GetInFaction ‘ChorrolFaction’ == 1<br>

GetIsID BGCptHubart == 0<br>

GetStage BGM001>= 20

We can limit this using suitable conditions to Hubart only and using the current stage. ADD a TOPIC called BGCourier (Couriers)

!  TOPIC

|  BGVilanusVilla

|  Vilanus has sent you to investigate the courier’s disappearance.

| GetIsID BGCptHubart == 1<br>

GetStage BGM001== 20

|  BGCourier

Again try this and then refer to the Play test version if you are stuck.

Before we go any further we need to set the scene at the cottage.

We want to remove some of the clutter. We also want to give the impression a fight has taken place. Tips some chairs and tables over (Y=90). Remember this set will be locked at the start and you will only use it for a short time, so don't go overboard. We also want to place some props. We need an amulet to trigger the next phase. Why an amulet. It's small enough that you have to look for It., without being so small that it becomes hard to find. Again use an existing item of jewellery as a base and edit it. I called it BGEmbossedAmulet. Set this as a Quest Item. This means the character can not drop or sell this item once he has picked it up.

We also want to create a custom letter with this text called BGPartialLetter. Set the letter as a quest item. We will refer to it in some scripts.

The client wishes his only living heir in Cyrodiil, to inherit his house, I have enclosed

the deed and key. the location is registerd at the Imperial City land offices ..<br>

Of course this would look really cool if we could create a custom ‘ripped' scroll. But that is beyond the scope of these tutorials.

 

 

Bodies are NPCs who just happen to be dead. You will need to create an NPC, don't bother too much about detail on this one as they are dead. I used the Courier1 npc as abase.

Place this character in to the render window, Edit her ID, and position in a suitable place. I put her in a side room so you don't see her straight away. . I also left a nice blood trail to lead you to her. Initially she will be standing up.

First edit the NPCs health to read zero (0).

To access her ability you will have to ensure that the PC offset flag is unchecked. Setting her health to 0 kills her.

Now the awkward thing is the fact that she is just standing there. She will stay standing in the game unless we make her fall first. To get her to fall, click on the WORLD menu and select run havoc sim, now click this.

Down she goes.

We have to now add the letter to the dead courier's inventory.

I also placed a sword which pointed directly at the amulet.

Another useful technique is to create an NPC called something like BGDummyPlayer. Use any base you like. We will not place this NPC in the render window. Don't bother to edit anything other than the reference ID.

We can now set the ownership of the door and cell (lesson 3) to BGDummyPlayer. This means that all items in the cottage will display the red hand, with the exception of the embossed amulet. This is a handy way to set ownership without having to create detailed NPCs. We can use BGDummyPlayer to set the ownership of all the doors and sets we want to prohibit our player from entering.

Create a key called BGCourierKey. Again select an existing key and change the editor id. Edit the cottage door to set its lock status to ‘needs a key' and use this as the key.

We need to add an [[XMarker]] to the interior and the exterior a [[map marker]].

Drop an xmarker or an [[XMarkerHeading]] object inside the cottage and give it a reference name like BgCourierLodgeXMarker.

Now select a MapMarker and drop it just outside the cottage door, in the exterior cell.

It looks a bit like a door teleport marker but is pink rather than yellow.

Edit its details to give it a reference name like BGMCCottageMapMarker

Finally in the name box call it Courier Cottage.

Again this is the name that will appear on the map.

Add the following multi-line response and set conditions to limit it to Hubart and the current stage. First add stage 30 in the stage tab.

 

!  TOPIC

|  BGCourier (Courier?)

* Here is a key to get you in. Let me know what you find out.

| GetIsId BGCptHubart == 1<br>

GetStage BGM001>= 20

| BGCluesFound

| SetStage BGM001 30

 

 

 

 

And add this to the stage result script

  Player.additem "BGCourierKey" 1

  ShowMap BGMCCottageMapMarker

This activates the map marker and gives the player the key to the cottage.

The Syntax for the [[ShowMap]] Function is

The enableFastTravel is an optional parameter which takes the value 1 if you want to be able to fast travel immediately.

If omitted then you can not fast travel until you have found the location.

Remember we have still to add all those quest targets, and will use the xmarkerheading as a reference for this.

Up till now we have been able to use NPCs to control progression, however now we need to begin to script to do the next bit of progression.

And that seems like a good place to take a break.