The Phrozen Keep

[Nefarius]

---

ItemStatCost.txt Fileguide


Test



This is based on no other fileguide because the differences between the 1.09 and 1.10 ItemStatCost.txt are extreme.





Stat


the name of the stat





ID


the ID of the stat





Send Other


This is most likely used to determine if this stat is sent to other users when in multiplayer. Only those stats are sent that are important for graphics (faster attack / cast / gethit rate). For some reason, dex and strength are sent, too.





Signed


Is the stat signed or not? -> Can this stat be negative or not?






Sendbits


Number of bits used to send this value between client and server.





Send Param


Has something to do with client / server things, too.





UpdateAnimateRate



???


Probably a boolean that tells the client to update the characters animation rate.





Saved


Is the stat saved when the character is saved?


Other stats are saved in the item saves.





CSvSigned



(Character Save Signed)


Stat signed in character save?





CSvBits


(Character Save Bits)


Bits used to save when saved in character save file (maximum value that is saved equals 2^[CSvBits])





CSvParam



(Character Save Parameter)


Has something to do with saved parameters for some stats





fCallback


???





fMin



???





MinAccr


???





Encode


related to how the thing is encoded





Add, Multiply, Divide


used to calculate the items price





the formula is:


price = base_price * (1+ stat_value * ([multiply]/[divide])) + [add]





with


base_price = base item price (from the other .txt files)



stat_value = amount of the stat that is on the item (for +8 strength this would be 8...)





if there is more than one stat on a magic item, the suffix ONLY counts for some reason i dont understand (this is reported by Joel). no idea what happens for rare items. for unique and set items, these values do not count at all.


divide cannot be changed for some reason, better leave it at 1024.


other files may modify the price, too (magicprefix / suffix has add / multiply / divide fields, npc.txt says something about sell / buy multipliers, ...).





ValShift


Value is shifted by that. 1 would mean that its shifted by 1 which is a multiplication by 2. ValShift 2 is a multiplication by 4 and ValShift 8 equals a multiplication by 256 (2^8=256). This is done because, for example, hitpoints are internally calculated with 1/256 step precision.






1.09-Save Bits, 1.09-Save Add


The old Save Bits and Save Add values from 1.09. probably used for converting characters.





Save Bits, Save Add


These two fields are used to handle the way the value is saved on an item. This also determines the minimum and maximum values a stat can have.


Save Bits determines the number of bits the value is saved in, while Save Add is added before the value is saved unsigned.



The results:


Minimum stat value equals -[Save Add]


Maximum stat value equals 2^[Save Bits] - [Save Add] - 1





Example (taken from maxhp):


Save Add = 32


Save Bits = 8





Minimum stat value = -32



Maximum stat value = 2^8 - 32 - 1 = 256 - 33 = 223





SaveParamBits


Determines how many bits are used to save Parameters (???)





keepzero


Boolean, can the stat go negative? (1 = cannot be negative)





op


This is the number of the operator used to calculate the effects of the item stat.


Known numbers and effects:


1 : op stats are increased by [statvalue] percent


2 : op stats are increased by [statvalue] * [op base] / 2^[op param]


3 : not used, effect unknown


4 : seems to have the same effect as 2



5 : op stats are increased by [statvalue] * [op base] / 2^[op param] percent


6 : op stats are increased by time


7 : op stats are increased by time and percent


8 : used to calculate the mana based on energy


9 : used to calculate the hitpoints and stamina based on vitality





op param


See op





op base


See op





op stat1 - op stat3


The op stats. See op





direct



If the stat adds to another stat, too, this is set to 1. For example, when equipping an item with +30 mana, your maximum mana increases as well.





maxstat


The max stat the stat adds to (when direct is set to 1)





itemspecific


Is this stat specific to one item only (and does therefore only affect this item)?



you should be able to stop the second weapon from increasing your first weapons attack speed this way





damagerelated


Does this stat relate to damage (dont know the effect)





itemevent1


When this event happens, the itemeventfunc1 is executed





itemeventfunc1


Function that is executed on itemevent1. Functions that are used are:





6 : attacker takes damage of [statvalue]


7 : knockback


8 : howl effect


9 : stupidity effect


10 : attacker takes lightning damage of [statvalue]



14 : freeze effect


15 : openwounds effect


16 : crushing blow


17 : get mana (after kill)


18 : get life (after demon kill)


19 : slow effect


20 : skill is released


21 : skill is released (same as 20 ?!?)



28 : get life (after kill)


29 : slain monster rests in peace


30 : skill is released (same as 20 ?!?)


31 : reanimate slain monster





descpriority


priority of the description on the item. The higher this, the earlier will the stat be displayed on your item. Not sure, though






descfunc


Function used to display the stat. There are numerous ones, I didnt yet test all yet.





some values and what they display (descval used: 1, see below):


1 : +[value] [string]


2 : [value]% [string]


3 : [value] [string]


4 : +[value]% [string]



5 : [value/1.28]% [string] // used for howl


6 : +[value] [string] [string2]


7 : [value]% [string] [string2]


8 : +[value]% [string] [string2]


9 : [value] [string] [string2]


10 : [value/1.28]% [string] [string2]


11 : Repairs 1 durability in [100/value] seconds


12 : +[value] [string] // used for stupidity, freeze


13 : +[value] to [class] skill levels



14 : +[value] to [skilltab] skills ([class] only)


16 : Level %d %s Aura When Equipped





descval


0 : no value is displayed (like


1 : value is displayed first (like '+5 to strength')


2 : string is displayed first, then value (like 'strength +5')





descstrpos


Description string used when value is positive





descstrneg


Description string used when value is negative





descstr2



Second display string (for per level attributes for example)





dgrp


Display group. If all stats of a display group have the same stats, they will be displayed together.





dgrpfunc


Same as descfunc, but for display groups





dgrpval


Same as descval, but for display groups





dgrpstrpos


Same as descstrpos, but for display groups





dgrpstrneg



Same as descstrneg, but for display groups





dgrpstr2


Same as descstr2, but for display groups





stuff


???





*eol


End of line








EDIT:


One thing you should NEVER EVER do:


have op base and op stat1 be the same. The game crashes with no error message at all when trying to compile the .bin file. Most likely, the same happens when op base and op stat2 / 3 are the same.





EDIT 2:


minor improvements





EDIT 3, 4:


further improvements





EDIT 5:


added info about descval, corrected info about descstr






EDIT 6:


NEVER make two stats have the same name. I posted what happens then here

Link to this article: Select all

[url=https://d2mods.info/forum/kb/viewarticle?a=353&sid=23bbfcdeaf27acd1bc8ae6bcbd7c4da1]Knowledge Base - ItemStatCost.txt File Guide[/url]