SkillDesc.txt File Guide (v. 2)

SkillDesc.txt File Guide (v. 2)

Description: by Ric Faith, restyled by HarvestWombs

Categories: File Guides (1.1x)

SkillDesc.txt File Guide
& descline reference by RicFaith

Skilldesc is an important part of the skill making process. It gives the modder the ability to fully customize the skill descriptions of his skills. It is also important for the placement and arrangement of skills on the skilltrees.

Files used by SkillDesc:


Patchstring > Expansionstring > String
This means that any entry in Patchstring will overwrite the an entry of the same index in Expansionstring or String, and any entry in Expansionstring will overwrite another entry sharing the same name in String. Thus to find the most recent string, you should check in the order stated above.

Naming convention:
So as to make certain things clearer, and to simplify this File Guide, here are some naming conventions that I will use while describing:

string(s) - refers to an entry in any of the .tbl files
tree(s) or page(s) - the skill trees available to the character
shortcut(s) - the list of skills that show up when you press 'S'
charscreen - character screen, shows up when you press 'C'
selected skill - one of the two active skills that are set to your mouse buttons


skilldesc: Name of the skill description, referenced by skills.txt (col D).


SkillPage: (Allowed values = 0 - 3) Determines which page the skill will show up.

CODE: Select all

0 - not on trees 
1 - bottom page 
2 - middle page 
3 - top page 

SkillRow: (Allowed values = 0 - 6) Determines which row the skill will show up.

CODE: Select all

0 - not on page 
1 - top row 
6 - bottom row 

SkillColumn: (Allowed values = 0 - 3) Determines which column the skill will show up.

CODE: Select all

0 - not on page 
1 - left column 
2 - middle column 
3 - right column  

ListRow: (Allowed Values = -1 - 4) Determines which row the skill will show up in the shortcuts

CODE: Select all

-1 & every other value - skill will not shot up  
0 - reserved for basic attacks and unsummon  
1-3 - for skills, from bottom up, usually the same value as SkillPage, but not necessarily 
4 - reserved for Identify and Town Portal 

ListPool: (Allowed Values = 0 - 2) Used only by Identify and Town Portal scrolls.

CODE: Select all

0 - Everything else 
1 - scroll of identify 
2 - scroll of town portal 

IconCel: (Allowed Values = 0 - X) (user defined, read below)
Used to determine the icons (usable and unusable) used by the skill. Value that is put here determines the usable icon, and the next icon will be the unusable icon.
Icons always come in pairs, so if you're making your own skill icons, do put them in the right order.

If skill is a class skill, icons will be taken from :
dataglobaluispellsXXskillicon.dc6 where XX is -

CODE: Select all

XX	Class 
am	Amazon 
as	Assassin 
ba	Barbarian 
dr	Druid 
ne	Necromancer 
pa	Paladin 
so	Sorceress 

If skill is not a class skill, icons will be taken from :

str name: This is the string that is used as the skill name in the trees, the shortcuts and the selected skill.

str short: This is the string that is used as the skill description in the shortcuts and the selected skill.

str long: This is the string that is used as the skill description in the trees.

str alt: This is the string that is used as the skill name in the charscreen.

str mana: Usual values = StrSkill3 or (blank)
Even if your skill has no mana cost, putting a string here will not display a 0 mana cost. You can use StrSkill3 ('Mana Cost: ') or your own fancy string for mana cost.
Eg. Raven has its own mana cost string ('Mana Cost Per Raven')

descdam: Allowed values = 1 - 24 or (blank)
If your skill deals damage, then you need to use this to tell skilldesc how to go about calculating the damage. Here is a list of the various values for descdam.

CODE: Select all

descdam   description  
1   attack 
2   kick 
3   throw 
4   left hand throw 
5   check dmg cols 
6   arrow with explode 
7   attacks w dmg increases 
8   inferno type dmg 
9   blaze,firestorm  
10   smite 
11   vengeance  
12   blessed hammer 
13   double throw 
14   hunger 
15   kick combo  
16   kick AoE 
17   cstrike 
18   royal strike  
19   2h attacks 
20   assn chargeups 
21   lightbolt 
22   javelin with explode 
23   rabies 
24   blade fury 
Some skills have their own special descdam, so you should check the most relevant skill to yours to see if it requires something different, otherwise it's almost always 5.

ddam calc1 / ddam calc2 If your skill has an increase in damage, you'll need to fill in one or both of these columns. The resulting damage is given by this formula:
Damage = (Original Damage) * (100 + ddam calc1)/100 + ddam calc2
Thus if your skill has a %age increase in damage, put the increase or calc in ddam calc1. Or if your skill has a flat +X increase in damage, put the increase or calc in ddam calc2.

pXdmelem / pXdmmin / pXdmmax where X = 1 - 3
These are only used by the Assassin charge-up attacks. These columns describe the necessary details.
pXdmelem - The element type for that charge
pXdmmin - Minimum damage for that charge
pXdmmax - Maximum damage for that charge

descat: (Allowed values = 1 - 5 or (blank))
If your skill has an increase in attack rating, you will need to fill this column. I can't see any difference between 1 and 2, so I guess you should look at the skill that is closest to yours.

CODE: Select all

descatt  description
1   increase in attack rating 
2   increase in attack rating   
3   throw 
4   left hand throw 
5   kick finishers 
descmissileX where X = 1 - 3 In the case where your damage, duration or other values are taken from missiles, you will need to put the primary missile in descmissile1.
Currently, it seems that the descmissile2 and descmissile3 are only used by assassin charge-ups, but I think you should be able to put other missiles here for description too.

From here, the real stuff begins. Since it is highly repetive in nature, I will explain it differently.

There are 3 main sections for descriptions, desc, dsc2 and dsc3. First a breakdown of where these descriptions show up.

desc: Shows up in trees, shortcuts and selected skill.
dsc2: Shows up in trees, shortcuts and selected skill.
dsc3: Sshows up in trees only.

Next, I'll describe what the different descriptions show.

Shortcuts and Selected skill - desc and dsc2 show current level stats only.
Trees -
desc: Show current and next level stats
dsc2: Show current stats
dsc3: Show current stats (but is currently used for synergies)
For a more precise layout of the stats, see Appendix A below.

If you leave a set blank, they will simply be ignored. So you can fill any
sets of columns, the blank ones will be skipped.

Now, we will cover the different parts of a description. I will use just 1 set of columns for simplicity, the effect is the same for all columns. Each set of columns will have:
descline, desctexta, desctextb, desccalca, desccalcb
with various numbers appended to them.

descline: (Allowed values = 1 - 75 or (blank))
This tells skilldesc the format of the description, which values to take and which order to place them. Read further for an example. All desclines and their usage can be found in Appendix B.

desctexta / desctextb: These are strings that may be filled or left blank.
Some desclines are not picky about whether these are filled, but since there are so many desclines, you can find something that matches your needs quite closely.

desccalca / desccalcb: These are numbers or calcs that may be filled or left blank.
Similar to desctexts, desccalcs may be treated as empty or 0 if not present, so if you don't need the extra space, choose a suitable descline.


In Appendix B, I used the following notation:
S1 & S2 refer to desctexta and desctextb respectively. S for String because that is what these two columns are.
C1 & C2 refer to desccalca and desccalcb respectively. C for Calc
I used S1,S2,C1,C2 because these are immediately identifiable. Most of the desclines come with fixed text. You can change the 'fixed' part in the .tbl files, but you'll be changing them for all skills that use that descline. Anyway there are so many workarounds that you really don't have to change it, just use another descline.

Example 1:
I'll use descline 3 as an example.
Descline 3 gives the following output: S1C1S2
This means that if my input is
S1 = 'Good'
S2 = 'Nothing'
C1 = 4
C2 = 365
The result will be 'Good4Nothing'. There are no spaces, because the output merely concatenates everything. C2 is ignored because it is not included in the output.
If S1 was blank, the output is '4Nothing'
If S2 was blank, the output is 'Good4'
If C1 was blank, the output is 'GoodNothing'

I'm sure that is quite clear, now on to some of the more complex desclines

Example 2:
Some desclines don't use string or calcs, so I'll show a nice one for poison skills.
Descline 14 has the following output:
Poison Damage: X-Y
over Z seconds

Yes, some desclines produce more than one line, but they're usually a little hardcoded. This descline reads the values of EMin, EMax and ELen from skills.txt and does some math before displaying the values.

For this example, I'll use Poison Nova Lvl 1
From skills.txt:
HitShift = 4
EMin = 14
EMax = 25
ELen = 50

First, some things you have to know about the values in Len, this value is in frames, and Diablo has 25 frames to a second. Thus Poison Nova does damage for 2 seconds.

Next, for HitShift, this is because Blizzard uses 8 bits of accuracy for HitPoints, Mana and Stamina. HitShift for Poison Nova is 4, so the damage is 'divided' by 2^4 = 16.

Anyway, back to the descline and the formula.
The output has X,Y and Z, this is because even these values are not raw values. Here's how we calculate them:
X = EMin*ELen/16 = 43
Y = EMax*ELen/16 = 78
Z = ELen/25 = 2

Last thing to note, Blizzard rounds everything down to the integer. So 3/4 = 0, 41/40 = 79/40 = 1.

In the end, we get the final output:
Poison Damage: 43-78
over 2 seconds


Skilldesc can get a bit tricky, and sometimes some things just don't work so well. My advice is that even though some of the desclines may look perfect for your skill description, if they don't work, try using some of the more common ones. Some of the desclines are not used in skilldesc, I found them by trying every number. Some are only used by one skill, so I classed it as being specific, though they may still be able to work, don't get too worked up when it doesn't. In my opinion, you can do a lot with just the basic few. You can do your own calcs and display a raw number instead of leaving it to the hardcoded desclines. But it's up to the individual modder


Appendix A: Layout of Skill Description on the Tree.

str name
str long

(all dsc2 lines)

Current Level: X
(all desc lines)

Next Level: X+1
(all desc lines)

(all dsc3 lines)

As mentioned earlier, synergies are using dsc3 lines, so they'll be shown right at the bottom. If you want some stats that only show for current level, use dsc2. If you want stats that show for current and next levels, use desc.


Appendix B: List of desclines

This list is a bit long (75 entries), so I put it in a code. I'm thinking of making an excel page that allows you to put values in to see the result, but there may or may not be a need for it. I'll see how it goes. If you think that it'd be good, PM me so I know there's a demand.

descline = descline number
formula used = result from the inputs
calc/desc = in the event that the numbers are not directly related to inputs S1,S2,C1,C2, I explained it here
elem = if this descline refers to a specific elem, because of the calc method or if it can take any elem based on the EType in skills.txt, then I'll state it here
reference = the files it references, such as skills.txt, missiles.txt etc. descline   formula   used   calc/desc   elem   reference   specific

CODE: Select all

descline	formula							calc						reference
1   		null   							1   						almost all damaging skills use this          
2   		S1+C1S2  						1              
3   		S1C1S2  						1             
4   		S1+C1  							1              
5   		S1C1  							1             
6  		+C1S1							1						iron skin   
7		C1S1							1             
8		^ S1S2							1						Automatically displays AR Bonus           
9		S1S2Damage: +C2						1						Automatically displays Dmg Bonus          
10		(Elem) Damage: X-Y  					1   X,Y = Dmg   				any   skills     
11		^ S1S2							1   						Describes a skill dmg?          
12		S1: C1 seconds						1              
13		Life: C1						1  						For displaying summon's life          
14		Poison Damage: X-Ynover Z seconds			X,Y=(Dmg)*Len/16, Z=len/25			pois skills     
15		S1:S2							0             
16		Duration: (C1/25)-(C2/25) seconds			1   C1,C2 in frames         			mind blast   
17		S2S1C1-C2 per second					1            					fists of fire 
18   		S1   							1              
19   		S2S1(C1*2/3) yards					1   C1 in Game length units          
20   		S1+C1 percentS2						0              
21   		S1C1 percentS2						0
22   		Average Fire Damage: X-Y per second			1   X,Y=(dmg*7/3) (hitshift 4)  		fire missiles     
23   		Duration: X seconds					1   X = (range/25)      			missiles    
24   		S1: X-Y   1   X,Y=(dmg/2)      skills     
25   		S1S2   							1              
26   		Average (Elem) Damage: X-Y per second			1   X-Y=(dmg*25/16) (hitshift 4)		any skills     
27   		Average Fire Damage: X-Y per second			1   X,Y=(dmg*14/3) (hitshift 4)			fire skills     
28   		Radius: 1 Yard   1   HC, game value can be changed      skills   fire ball 
29   		X Yards							1   X=(range*2/3)      		      		missiles - fire wall   
30   		Fire Duration: X					1   X=(submissile1.range/25)   			fire missiles - fire wall  
31   		S1(C1/25) seconds					1   C1 in frames           
32   		S1S2+C1 percent						1              
33   		S1S2							1            					skel mastery
34   		Damage: X-Y						1   X,Y=monster damage /w bonuses      		monstats, skills - raise skel  
35   		S1: C1-C2						1            					fire golem  
36   		C1(S1 or S2)						1   						To determine plurality           
37   		S1(C1*2/3) yards					1   C1 in Game length units           
38   		S1C1-C2S2						1              
39   		null							1   						Used by Clay, Blood, Iron Golems           
40   		(C1:Color)S2S1						1						Color Codes below           
41   		Fire Damage: C1-C2					1      					      	fire golem  
42   		S1: +C1.C2 S2						1            					inferno sentry  
43   		S1(C1/25)-(C2/25)S2					1            					holy fire  
44   		S1(C1/256)-(C2/256)S2					0   C1,C2 used for true HP/MP/SP display           
45   		Thorns Damagen1 percent damage returned			0              					Hardcoded
46   		S1							0              
47   		S1C1-C2							1					        holy bolt  
48   		Magic Damage: X-Y					1   X,Y=Dmg  					blessed hammer  
49   		S1: X-Y							1   X,Y=Dmg (used for smite dmg by HShield)     holy shield  
50   		S1: X-Y							1   X,Y=(hitsubmissile1.dmg)			FoH 
51   		S1   							1              
52   		S1+C1-C2S2   						1             
53   		null,HC for isc?   					1              
54   		null,HC for ibk?   					1             
55   		null,HC for tsc?   					1              
56   		null,HC for tbk?   					1             
57   		S1+(C1/25) seconds   					1   C1 in frames        			lycanthropy   
58   		S1S2+C1-C2   						0             
59   		S2S1C1-C2   						1            					inferno sentry   
60   		S1+(C1/256)S2   					0   C1 used for true HP/MP/SP display          
61   		S1(C1/256)S2   						1   C1 used for true HP/MP/SP display         	blade fury   
62   		S1S2C1-C2   						1             
63   		S1: +C1% S2   						1              
64   		S1: +C1/C2 S2   					0             
65   		S1: S2   						0              
66   		S1(C1)S1   						1   S1 has a (%d%%) where C1 will be           
67   		S1: +C1 S2   						1              
68   		C1S1S2   						1          				  	sacrifice  
69   		S1: S2 C1   						0              
70   		S1S2+C1   						1              
71   		S1: S2   						1              
72   		+C1/C2 S1   						1              
73   		C1/C2 S1   						1   eg 3/4 Weap Dmg for Multishot           
74   		S1   							0              
75   		S1   							0              

Appendix C: Color Codes

The values that you can put in the C1 column for skilldesc 40 and a couple of others can be found here: 0 - Light Gray (normal text)

CODE: Select all

1 - Red  
2 - Bright Green (Set Items)  
3 - Blue (Magic Items)  
4 - Gold (Unique Items)  
5 - Dark Gray (Socketed/Ethereal Items)   
6 - Transparent (Text Doesn't Show)  
7 - Tan  
8 - Orange (Crafted Items)  
9 - Yellow (Rare Items)

Link to this article: Select all

[url=]Knowledge Base - SkillDesc.txt File Guide (v. 2)[/url]