How can I create a new disease?

[Bigblue1938]

I want to try and create a new Vampire/Werewolf hybrid disease but not really sure how to do it. I have the Skyrim Creation kit so if anyone can help me or give a short step by step list to what I need to do that would be great. I'm new to modding so I have no idea on how to start this. Anyone willing to help I really appreciate it.

[awwhownice]

I was wondering the same question, but only just how to create a new disease in general...is it possible even?

[steve40]

Creating a simple disease is quite straight-forward, it's pretty much a type of spell/ability with a MagicEffect that alters the player's stats temporarily. Just look under Magic in the CK to get a feel for how it is done. A disease such as Vampirism is much more complex and needs scripting to track the stages of the disease, change the player's race to vampire, apply new abilities and effects and so on.

 

The vampire script is called "PlayerVampireQuestScript.psc" but there are other scripts involved, such as "VampireChangeEffectScript.psc", "VampireDiseaseEffectScript.psc" and "VampireSunISMDEffectScript.psc".

 

Unless someone beats me to it, I'll write brief instructions on how to create a simple disease later when I get the time.

[awwhownice]

Until then, I'll try to figure it out.. thanks.

[steve40]

Ok, for todays tutorial we are going to make a simple disease called hemorrhagic fever. This infection will slowly drain away the victim's heath until they either find a cure or die. The disease will be transmitted by contact by any skeever race creature during combat. Lets do this tutorial as a stand-alone mod.

 

Fire up the Creation Kit and click the File Open icon on the toolbar. In the Data window that appears, double-click on Skyrim.esm to put a check-mark in the box in front of it. Now click OK. Wait a minute or two while the library loads. When an error box pops up, click "YES TO ALL" to ignore all "errors".

 

1) In the Creation Kit (CK), we will mainly be using the Object Window. Scroll down the left-hand side of the window until you find the Magic category. Expand this tree and look for the subcategory called Magic Effect. Now type "disd" in the Filter at the top-left of the Object Window. You should now see 14 items in the right-hand window with a "top hat" symbol in front of them - these are the magic effects that are used for the basic diseases in Skyrim (Bone-break fever, Ataxia, etc). Six of these effects are used by traps and the other 8 are used by creatures. The only difference between the "trap" disease effects and the regular effects is that the regular effects cost magika, but the trap effects don't (traps don't have magika of course).

 

2) Ok, so now double-click on the DisDamageStamina form, we will use that as a template for the new disease. In the Magic Effect form that opens, there are a daunting lot of options. Rather than trying to explain them all here, you can look here for detailed info on what all these options do. Now the first thing that you need to do is edit the ID field and type in a new name for our MagicEffect. Let's give it the ID of DisDrainHealth and in the Name field type in Drains Health. Change the Effect Archetype from "Peak Value Modifier" to Value Modifier. The Effect Archetype is one of the options that you can experiment with later. It's important that the Casting Type is Constant Effect and that the Delivery is Contact. Also change Magic Skill to NONE. Leave the Flags as they are, they are just fine for our purpose. Let's not worry about Visual Effects or Sounds for this simple example.

 

So now we need to set how the disease will damage the player. In the field called Assoc. Item 1 pick HealRate from the drop-down list.

 

Tip: note that the Detrimental flag is ticked. This is important because it will apply the magnitude of the actor value that we are modifying negatively, so that the heal rate will decrease rather than increase.

 

Tip: if we wanted to, we could set a secondary damage effect for the disease. To do this you would change the Effect Archetype to Dual Value Modifier and then you could pick another stat to damage in the Assoc. Item 2 field. You would then have to set a value for 2nd AV Weight (a weight of 1 would mean that the magnitude of damage for the secondary effect is the same as the magnitude of the primary effect, while 0.5 would mean the secondary effect does half as much damage as the primary effect).

 

Tip: In the Resist Value field, choose Disease Resist, so that actors that are resistant to diseases will also be resistant to our new disease.

 

3) We also can specify some conditions that control how the disease is applied. In the Target Conditions box you will see that there is already a condition (S GetRandomPercent NONE <= 5.00 AND). This condition basically sets a 5% chance that the disease will be contracted. "GetRandomPercent" is just a random number generator that picks a number between 0 and 100. The condition will return TRUE if the random number is less than or equal to 5, that is, the MagicEffect will activate. For more info on constructing condition statements look here and here. There are a lot of variables that can be used in Conditions, but many of them are undocumented. Just for fun, lets increase the chance from 5% to 50%. Just double-click the condition (an error box will pop up, just ignore it by clicking "yes to all"). In the Condition Item box that then appears, change 5.00000 to 50, then click OK. You can do a lot of nifty creative things with conditions, for example, you could make it that the disease can't be contracted on a certain day of the week, or on a certain type of creature, or on a bright sunny day, etc...

 

4) The last thing we need to do to complete our MagicEffect is to update it's description. In the Magic item description field, delete the text that's there (Drains <mag> points from stamina.) and type in "Sets the heal rate negatively to <mag>." (without quotes). <mag> is just a text replacer for the magnitude of the effect. We set the magnitude in a different form. So now click OK on the Magic Effect form and a Create New Object? dialog box will appear asking if you want to create a new form. Click YES.

 

Well that's was the complicated part done. Now we need to create a Disease form to apply our new Magic Effect to.

 

5) In the left-hand side of the Object Window look for the Spell category. Expand that tree and click on the Disease subcategory. We need to clear the search filter to see all the items in this category, so clear the text "disd" from the Filter field in the top-left corner of the window. Now you should see 13 diseases in the right side of the window. Let's use DiseaseBrainRot as a template. Double-click it to open this form. Note in the window name that this is actually a Spell form. Spells, Abilities, Diseases, Poisons and Powers are all essentially just spells and they are all set up in very similar ways. Now, edit the ID and change it to DiseaseHemorrhagicFever then edit the Name field and change it to Hemorrhagic Fever. Now in the big white Effects field, select the effect that is already in the form (Damage Magika : Magika) and hit the delete key and click the YES button to confirm the deletion. Now right-click within the Effects field and choose "New". An Effect Item form will appear. In the Effect drop-down list choose our new Magic Effect (DisDrainHealth). Now in the Magnitude field we have to set the strength of our disease. Type in the value 10. You can't set a negative number for the magnitude, but because the Detrimental box was ticked in the Magic Effect form, the magnitude that we set will be applied negatively anyway. You can experiment with how strong you want the effect to be, a larger number will drain the health faster. Notice that there is another Conditions box here. This one controls the overall disease, whereas the previous Conditions box controlled the individual magic effect. You can have multiple Magic Effects on a single disease for more flexibility. We don't need to add any more conditions, so click Ok to close the Effect Item form. Now, in the Description box of the Spell form, type "You are dying of hemorrhagic fever." That's the text that you will see when you look at the magic effects that are active on you in the Skyrim menus, so keep it quite brief. We don't need to change any other settings in the Spell form so just close it by clicking OK. Again, when the Create New Object? box appears, click YES.

 

So now all we have to do is find a way to apply our new disease. One simple way to do this is to add the disease to one (or more) of the attacks of an actor. You can do this at the Race level or on an individual Actor form. Let's look at the Skeever Race.

 

6) In the left-hand side of the Objects Window, scroll up to the Race category. Select it and type "skeever" in the Filter box at the top-left of the window. You should see "SkeeverRace" and "SkeeverWhiteRace" in the right-hand side. Double-click SkeeverRace. In the Race form, click on the Attack Data tab near the top of the form, it's the 6th tab along. Notice that there are 6 different attacks listed in the Attacks: field. Select one of them. Now underneath where all the stats are, look at the Attack Spell drop-down list. That is where we put the disease. Notice that all of the 6 attacks already have a disease spell attached (DiseaseAtaxia). Select all six attacks in turn and change the Attack Spell to our new disease, DiseaseHemorrhagicFever. Then click OK to close the Race form. We won't bother changing the white skeever race.

 

7) We're almost done. So let's save our mod. Click the save button on the Creation Kit toolbar. When asked, type in a name for your new mod, such as "aaTestNewDisease".

 

Ok, so load up the new mod in Skyrim and find a Skeever to attack and see what happens. Make sure you are not wearing any items that give you disease immunity. This disease will keep draining your health until it kills you, so make sure that you have a cure disease potion or three handy. Hawk feathers, if eaten, will cure a disease instantly.

Edited January 5, 2013 by steve40

[awwhownice]

Wow! Thanks so much.... I actually did find the disease and such where you told me to look, but could not for the life of me find any Damage Health effect (what my disease is based around, like your example). What a great example and walkthrough. :thumbsup:

[Redzerocode]

You're really help, thank you so much.

[Drag00n123]

Great tutorial, thanks!

[Elgar2389]

Thank you for this amazing tutorial. You made it so easy to understand and retain :)

[tyrannynexus]

shouldn`t this go on the WIKI?