D2R Data Guide (Corrected)

ActInfo.txt

This file controls global Act functionalities including item levels, monster behaviors, and waypoints

This file uses the WanderingMon.txt file for a modular list of potential wandering units to spawn

This file defines where an act begins and ends. It is new to D2R and helps control traveling between acts.

Data Fields

act - [O] - Defines the ID for the Act

town - [O] - Uses an area level (Name field from Levels.txt) to define the Act's town area

start - [O] - Uses an area level (Name field from Levels.txt) to define where the player starts in the Act

maxnpcitemlevel - [N] - Controls the maximum item level for items sold by the NPC in the Act

classlevelrangestart - [O] - Uses an area level (Name field from Levels.txt) with its MonLvl values as a global Act minimum monster level. For example, this is used to determine chest levels in an Act.

classlevelrangeend - [O] - Uses an area level (Name field from Levels.txt) with its MonLvl values as a global Act maximum monster level. For example, this is used to determine chest levels in an Act.

wanderingnpcstart - [N] - Uses an index to determine which wandering monster class to use when populating areas (WanderingMon.txt for a list of possible monsters to spawn)

wanderingnpcrange - [N] - This is a modifier that gets added to the wanderingnpcstart value to randomly select an index

commonactcof - [O] - Specifies which ".D2" file to use as for the common Act COF file. This is used to establish the seed when initializing the Act.

waypoint1 - [O] - Uses an area level (Name field from Levels.txt) as the designated waypoint selection in the Waypoint UI

wanderingMonsterPopulateChance - [N] - The percent chance (from 0 to 100) to spawn a wandering monster (WanderingMon.txt for a list of possible monsters to spawn)

wanderingMonsterRegionTotal - [N] - The maximum number of wandering monsters allowed at once

wanderingPopulateRandomChance - [N] - A secondary percent chance (from 0 to #) to determine whether to attempt populating with monsters. Only fails if random chance selects 0.

Armor.txt, Misc.txt, Weapons.txt

These files control the functionality for all base items in the game (armors, miscellaneous and weapons).

They are loaded/merged together on runtime with their counterpart files in the following order: Weapons.txt, Armor.txt, Misc.txt

Columns that typically only exist in one of the files will be listed below all of the shared column entries.

This also means columns can be copied between files (such as auto prefix or spelldesc, etc)

Data Fields

name - [O] - This is a reference field to define the item; it does not need to be uniquely named

version - [N] - Defines which game version to create this item (0 = Classic mode | 100 = Expansion mode)

compactsave - [B] - If equals 1, then only the item's base stats will be stored in the character save, but not any modifiers or additional stats. If equals 0, then all of the items stats will be saved.

rarity - [N] - Determines the chance that the item will randomly spawn (1 / N). The higher the value then the rarer the item will be. This field depends on the spawnable field being enabled, the quest field being disabled, and the item level being less than or equal to the area level. This value is also affected by the relative Act number that the item is dropping in, where the higher the Act number, then the more common the item will drop.

spawnable - [B] - If equals 1, then this item can be randomly spawned. If equals 0, then this item will never randomly spawn.

speed - [N] - For Armors: Controls the Walk/Run Speed reduction when wearing the item. For Weapons: Controls the Attack Speed reduction when wearing the item.

reqstr - [N] - Defines the amount of the Strength attribute needed to use the item

reqdex - [N] - Defines the amount of the Dexterity attribute needed to use the item

durability - [N] - Defines the base durability amount that the item will spawn with. An item must have durability to become ethereal

nodurability - [B] - If equals 1, then the item will not have durability. If equals 0, then the item will have durability.

level - [N] - Controls the base item level. This is used for determining when the item is allowed to drop, such as making sure that the item level is not greater than the monster's level or the area level.

ShowLevel - [B] - If equals 1, then display the item level next to the item name. If equals 0, then ignore this.

levelreq - [N] - Controls the player level requirement for being able to use the item

cost - [N] - Defines the base gold cost of the item when being sold by an NPC. This can be affected by item modifiers and the rarity of the item.

gamble cost - [X] [N] - Defines the gambling gold cost of the item on the Gambling UI. Only functions for rings and amulets.

code - [O] - Defines a unique 3* letter/number identifier code for the item. This code is case sensitive, so a69 and A69 are considered different. *Can technically use 4 characters instead of 3, but Items.json will not process it (no visuals).

namestr - [O] - String Key that is used for the base item name. Reference string files found in local/lng/strings, such as item-names.json

magic lvl - [N] - Defines the magic level of the item, which can affect how magical item modifiers that can appear on the item (AutoMagic.txt)

auto prefix - [N] - Automatically picks an item affix name from a designated group value from AutoMagic.txt. Applies to all item qualities, excluding sets and uniques.

alternategfx - [O] - Uses a unique 3 letter/number code similar to the defined code fields to determine what in-game graphics to display on the player character when the item is equipped

normcode - [O] - Links to the Code field to determine the normal version of the item

ubercode - [O] - Links to a Code field to determine the Exceptional version of the item

ultracode - [O] - Links to a Code field to determine the Elite version of the item

component - [N] - Determines the layer of player animation when the item is equipped. This uses a Token entry from Composit.txt

invwidth & invheight - [N] - Defines the width and height of grid cells that the item occupies in the player inventory

hasinv - [B] - Determines if an item can be socketed with runes, jewels or Gems. (1 = Socketable | 0 = Not Socketable)

Gemsockets - [N] - Controls the maximum number of sockets allowed on this item. This is limited by the item's size based on the invwidth and invheight fields. This also compares with the MaxSockets1 field(s) in the ItemTypes.txt file.

gemapplytype - [N] - Determines which affect from a gem or rune will be applied when it is socketed into this item (Gems.txt)

flippyfile - [O] - Controls which DC6 file to use for displaying the item in the game world when it is dropped on the ground (uses the file name as the input). *Legacy View Only

invfile - [O] - Controls which DC6 file to use for displaying the item graphics in the inventory (uses the file name as the input). *Legacy View Only

uniqueinvfile - [O] - Controls which DC6 file to use for displaying the item graphics in the inventory when it is a Unique quality item (uses the file name as the input). *Legacy View Only (Any text required in field to use entry from uniques.JSON for D2R view)

setinvfile - [O] - Controls which DC6 file to use for displaying the item graphics in the inventory when it is a Set quality item (uses the file name as the input). *Legacy View Only

useable - [B] - If equals 1, then the item can be used with the right-click mouse button command (this only works with specific belt items or quest items). If equals 0, then ignore this

stackable - [B] - If equals 1, then the item will use a quantity field and handle stacking functionality. This can depend on if the item type is throwable, is a type of ammunition, or is some other kind of miscellaneous item. If equals 0, then the item cannot be stacked

minstack - [N] - Controls the minimum stack count or quantity that is allowed on the item. This field depends on the stackable field being enabled

maxstack - [N] - Controls the maximum stack count or quantity that is allowed on the item. This field depends on the stackable field being enabled

spawnstack - [N] - Controls the stack count or quantity that the item can spawn with. This field depends on the stackable field being enabled

Transmogrify - [X] [B] - If equals 1, then the item will use the transmogrify function. If equals 0, then ignore this. This field depends on the "useable" field being enabled. Does not function at all

TMogType - [X] [O] - Links to a "code" field to determine which item is chosen to transmogrify this item to. Does not function at all

TMogMin - [X] [N] - Controls the minimum quantity that the transmogrify item will have. This depends on what item was chosen in the "TMogType" field, and that the transmogrify item has quantity. Does not function at all

TMogMax - [X] [N] - Controls the minimum quantity that the transmogrify item will have. This depends on what item was chosen in the "TMogType" field, and that the transmogrify item has quantity. Does not function at all

type - [O] - Points to an Code defined in the ItemTypes.txt file, which controls how the item functions

type2 - [O] - Points to a secondary Item Type defined in the ItemTypes.txt file, which controls how the item functions. This is optional but can add more functionalities and possibilities with the item

dropsound - [O] - Points to a sound defined in the Sounds.txt file. Used when the item is dropped on the ground

dropsfxframe - [N] - Defines which frame in the flippyfile animation to play the dropsound when the item is dropped on the ground

usesound - [O] - Points to sound defined in the Sounds.txt file. Used when the item is moved in the inventory or used

unique - [B] - If equals 1, then the item can only spawn as a Unique quality type. If equals 0, then the item can spawn as other quality types

transparent - [B] - If equals 1, then the item will be drawn transparent on the player model (similar to ethereal models). If equals 0, then the item will appear solid on the player model

transtbl - [N] - Controls what type of transparency to use (if the above transparent field is enabled). Referenced by the Code value of the Transparency Table

lightradius - [N] - Controls the value of the light radius that this item can apply on the monster. This only affects monsters with this item equipped, not other types of units. This is ignored if the item's component on the monster is "lit", "med", or "hvy"

belt - [N] - Controls which belt type to use for belt items only. This field determines what index entry in the Belts.txt file to use

quest - [N] - Controls what quest class is tied to the item which can enable certain item functionalities for a specific quest. Any value greater than 0 will also mean the item is flagged as a quest item, which can affect how it is displayed in tooltips, how it is traded with other players, its item rarity, and how it cannot be sold to an NPC. If equals 0, then the item will not be flagged as a quest item. Referenced by the Code value of the Quests Table

questdiffcheck - [B] - If equals 1 and the quest field is enabled, then the game will check the current difficulty setting and will tie that difficulty setting to the quest item. This means that the player can have more than 1 of the same quest item as long each they are obtained per difficulty mode (Normal / Nightmare / Hell). If equals 0 and the "quest" field is enabled, then the player can only have 1 count of the quest item in the inventory, regardless of difficulty

missiletype - [O] - Points to the *ID field from the Missiles.txt file, which determines what type of missile is used when using the throwing weapons

durwarning - [N] - Controls the threshold value for durability to display the low durability warning UI. This is only used if the item has durability

qntwarning - [N] - Controls the threshold value for quantity to display the low quantity warning UI. This is only used if the item has stacks

mindam - [N] - The minimum physical damage provided by the item

maxdam - [N] - The maximum physical damage provided by the item

StrBonus - [N] - The percentage multiplier that gets multiplied the player's current Strength attribute value to modify the bonus damage percent from the equipped item. If this equals 1, then default the value to 100

DexBonus - [N] - The percentage multiplier that gets multiplied the player's current Dexterity attribute value to modify the bonus damage percent from the equipped item. If this equals 1, then default the value to 100

gemoffset - [N] - Determines the starting index of possible gem/rune options based on the gemapplytype field and the Gems.txt entries. For example, if this value equals 9, then the game will start with index 9 ("Chipped Emerald") and ignore lower-indexed entries, meaning the item cannot roll these options

bitfield1 - [N] - Controls different flags that can affect the item. Uses an integer value to check against different bit fields by using the "&" operator. For example, if the value equals 5 (binary = 101) then that returns true for both the 4 (binary = 100) and 1 (binary = 1) bit field values.

The following fields are separated per NPC in each Act:

[NPC]Min - [N] - Minimum amount of this item type in Normal rarity that the NPC can sell at once

[NPC]Max - [N] - Maximum amount of this item type in Normal rarity that the NPC can sell at once. This must be equal to or greater than the minimum amount

[NPC]MagicMin - [N] - Minimum amount of this item type in Magical rarity that the NPC can sell at once

[NPC]MagicMax - [N] - Maximum amount of this item type in Magical rarity that the NPC can sell at once. This must be equal to or greater than the minimum amount

[NPC]MagicLvl - [N] - Maximum magic level allowed for this item type in Magical rarity; Where [NPC] is one of the following:

Transform - [O] - Controls the color palette change of the item for the character model graphics. Referenced by the Code value of the Inventory Transform Table

InvTrans - [N] - Controls the color palette change of the item for the inventory graphics. Referenced by the Code value of the Inventory Transform Table

SkipName - [B] - If equals 1 and the item is Unique rarity, then skip adding the item's base name in its title. If equals 0, then ignore this

NightmareUpgrade - [O] - Links to another item's Code field. Used to determine which item will replace this item when being generated in the NPC's store while the game is playing in Nightmare difficulty. If this field's code equals "xxx", then this item will not change in this difficulty

HellUpgrade - [O] - Links to another item's Code field. Used to determine which item will replace this item when being generated in the NPC's store while the game is playing in Hell difficulty. If this field's code equals "xxx", then this item will not change in this difficulty

Nameable - [B] - If equals 1, then the item's name can be personalized by Anya for the Act 5 Betrayal of Harrogath quest reward. If equals 0, then the item cannot be used for the personalized name reward

PermStoreItem - [B] - If equals 1, then this item will always appear on the NPC's store. If equals 0, then the item will randomly appear on the NPC's store when appropriate

diablocloneweight - [N] - The amount of weight added to the diablo clone progress when this item is sold. When offline, selling this item will instead immediately spawn diablo clone.

Armor.txt only

minac - [N] - The minimum amount of Defense that an armor item type can have

maxac - [N] - The maximum amount of Defense that an armor item type can have

block - [N] - Controls the block percent chance that the item provides (out of 100, but caps at 75)

rArm - [N] - Controls the character's graphics and animations for the Right Arm component when wearing the armor, where the value 0 = Light or "lit", 1 = Medium or "med", and 2 = Heavy or "hvy"

lArm - [N] - Controls the character's graphics and animations for the Left Arm component when wearing the armor, where the value 0 = Light or "lit", 1 = Medium or "med", and 2 = Heavy or "hvy"

Torso - [N] - Controls the character's graphics and animations for the Torso component when wearing the armor, where the value 0 = Light or "lit", 1 = Medium or "med", and 2 = Heavy or "hvy"

Legs - [N] - Controls the character's graphics and animations for the Legs component when wearing the armor, where the value 0 = Light or "lit", 1 = Medium or "med", and 2 = Heavy or "hvy"

rSPad - [N] - Controls the character's graphics and animations for the Right Shoulder Pad component when wearing the armor, where the value 0 = Light or "lit", 1 = Medium or "med", and 2 = Heavy or "hvy"

lSPad - [N] - Controls the character's graphics and animations for the Left Shoulder Pad component when wearing the armor, where the value 0 = Light or "lit", 1 = Medium or "med", and 2 = Heavy or "hvy"

Misc.txt only

autobelt - [B] - If equals 1, then the item will automatically be placed is a free slot in the belt when picked up, if possible. If equals 0, then ignore this

bettergem - [O] - Links to another item's Code field. Also used by Function 18 from the Code field in Shrines.txt to specify which gem is the upgraded version

multibuy - [B] - If equals 1, then use the multi-buy transaction function when holding the shift key and buying this item from an NPC store. This multi-buy function will automatically purchase enough of the item to fill up to a full quantity stack or fill the available belt slots if the item is has the autobelt field enabled. If equals 0, then ignore this

spellicon - [N] - Determines the icon asset for displaying the item's spell. This uses an ID value based on the global skillicon file. If this value equals -1, then the item's spell will not display an icon. Used as a parameter for a PSpell function

pspell - [N] - Uses the Code value to select a spell from the Player Spell Table when the item is used. This depends on the item type.

state - [O] - Links to a State field defined in the States.txt file. It signifies what state will be applied to the player when the item is used. Used as a parameter for a PSpell function

cstate1 - [O] - Links to a State field defined in the States.txt file. It signifies what state will be removed from the player when the item is used. Used as a parameter for a PSpell function

len - [N] - Calculates the frame length of a state. Used as a parameter for a PSpell function

stat1 - [N] - Controls the stat modifier when the item is used (Uses the Code field from Properties.txt). Used as a parameter for a PSpell function

calc1 - [C] - Calculates the value of the above stat1 field. Used as a parameter for a PSpell function

spelldesc - [N] - Uses the code value from the below table to format and display string for the item's tooltip:

spelldescstr - [O] - Defines the primary string key used by the above spelldesc table

spelldescstr2 - [O] - Defines the secondary string key used by the above spelldesc table

spelldesccalc - [C] - Value applied or used by the above spelldesc table

spelldesccolor - [N] - Uses the Code value from the below table, for the above spelldesc table.

Weapons.txt only

1or2handed - [B] - If equals 1, then the item will be treated as a one-handed and two-handed weapon by the Barbarian class. If equals 0, then the Barbarian can only use this weapon as either one-handed or two-handed, but not both

2handed - [B] - If equals 1, then the item will be treated as two-handed weapon. If equals 0, then the item will be treated as one-handed weapon

2handedwclass - [O] - Defines the two-handed weapon class, which controls what character animations are used when the weapon is equipped. Referenced by the Code value of the Weapon Class Table

2handmindam - [N] - The minimum physical damage provided by the weapon if the item is two-handed. This relies on the 2handed field being enabled

2handmaxdam - [N] - The maximum physical damage provided by the weapon if the item is two-handed. This relies on the 2handed field being enabled

hit class - [O] - Defines the hit class of the weapon which is used to know what SFX to use when the weapon hits an enemy. Referenced from the Code column in HitClass.txt

minmisdam - [N] - The maximum physical damage provided by the item if it is a throwing weapon

maxmisdam - [N] - The maximum physical damage provided by the item if it is a throwing weapon

rangeadder - [N] - Adds extra range in grid spaces for melee attacks while the melee weapon is equipped. The baseline melee range is 1, and this field adds to that range

wclass - [O] - Defines the one-handed weapon class, which controls what character animations are used when the weapon is equipped. Referenced by the Code value of the Weapon Class Table

AutoMagic.txt

This file controls what item affixes (groups of item modifiers) are automatically applied to items, regardless of their quality type. These item affixes will not change the quality of the item.

An example can be class based items like a paladin shield that can be Normal Quality but still have Paladin skill bonuses without changing the item's name.

This file is loaded together with other similar files in the following order: magicsuffix.txt, magicprefix.txt, AutoMagic.txt. These combined files form the Item Mods structure.

Data Fields

Name - [O] - Defines the item affix name; it does not need to be uniquely named

version - [N] - Defines which game version to use this item affix (0 = Classic mode | 100 = Expansion mode)

spawnable - [B] - If equals 1, then this item affix is used as part of the game's randomizer for assigning item modifiers when an item spawns. If equals 0, then this item affix is never used.

rare - [B] - If equals 1, then this item affix can be used when randomly assigning item modifiers when a rare item spawns. If equals 0, then this item affix is not used for rare items.

level - [N] - The minimum item level required for this item affix to spawn on the item. If the item level is below this value, then the item affix will not spawn on the item.

maxlevel - [N] - The maximum item level required for this item affix to spawn on the item. If the item level is above this value, then the item affix will not spawn on the item.

levelreq - [N] - The minimum character level required to equip an item that has this item affix

classspecific - [O] - Controls if this item affix should only be used for class specific items. Specified by the Code column in PlayerClass.txt

class - [O] - Controls which character class is required for the class specific level requirement specified in the below classlevelreq field. Specified by the Code column in PlayerClass.txt

classlevelreq - [N] - The minimum character level required for a specific class in order to equip an item that has this item affix. This relies on the class specified in the above class field. If equals null, then the class will default to using the levelreq field

frequency - [N] - Controls the probability that the affix appears on the item (a higher value means that the item affix will appear on the item more often). This value gets summed together with other frequency values from all possible item affixes that can spawn on the item, and then is used as a denominator value for the randomizer. Whichever item affix is randomly selected will be the one to appear on the item. The formula is calculated as the following: [Item Affix Selected] = ["frequency"] / [Total Frequency]. If the item has a magic lvl, then the magic level value is multiplied with this value. If equals 0, then this item affix will never appear on an item

group - [N] - Assigns an item affix to a specific group number. Items cannot spawn with more than 1 item affix with the same group number. This is used to guarantee that certain item affixes do not overlap on the same item. If this field is null, then the group number will default to group 0

mod1code - [O] - Controls the item properties for the item affix using the Code value from Properties.txt

mod1param - [N] - The "parameter" value associated with the listed property (mod). Usage depends on the (Function ID field from Properties.txt)

mod1min - [N] - The "min" value to assign to the listed property (mod). Usage depends on the (Function ID field from Properties.txt)

mod1max - [N] - The "max" value to assign to the listed property (mod). Usage depends on the (Function ID field from Properties.txt)

transformcolor - [N] - Controls the color change of the item after spawning with this item affix. If empty, then the item affix will not change the item's color. Referenced from the Code column in colors.txt

itype1 - [O] - Controls what Item Types are allowed to spawn with this item affix. Uses the Code field from ItemTypes.txt

etype1 - [O] - Controls what Item Types are forbidden to spawn with this item affix. Uses the Code field from ItemTypes.txt

multiply - [N] - Multiplicative modifier for the item's buy and sell costs, based on the item affix (Calculated in 1024ths for buy cost and 4096ths for sell cost)

add - [N] - Flat integer modification to the item's buy and sell costs, based on the item affix

AutoMap.txt

This file controls how the Automap in game will display the discovered parts of the area level and store this progress in character save files.

The Automap is composed of many different image files depicted as small icons to convey what part of the area level is being displayed. This file will assign these image files to their related map cells, which will properly build the Automap as the player explores the area.

Not all tiles will have image files assigned to them, and in these cases, those parts of the Automap will remain blank.

Data Fields

LevelName - [O] - Uses a string format system to define the Act number and name of the level type. Level types are static defined values that cannot be added. The number at the start of the string defines the Act number, and the word that follows this number defines the level type. This data should stay grouped by level.

TileName - [O] - Uses defined string codes to control the tile orientations on the Automap

Style - [N] - Defines a group numeric ID for the range of cells, meaning that the game will try to use cells that matc the same style value, after determining the Level Type and Tile Type. If this value is equal to 255, then the style is ignored in the "Cel#" field selection

StartSequence - [N] - The start index value for valid Cel1 field(s) to choose for displaying on the Automap. If this value is equal to 255, then both the "StartSequence" and "EndSequence" are ignored in the Cel1 field(s) field selection. If this value is equal to -1, then this field is ignored in the Cel1 field(s) field selection

EndSequence - [N] - The end index value for a valid Cel1 field(s) to choose for displaying on the Automap. If this value is equal to -1, then this field is ignored in the Cel1 field(s) selection

Cel1 - [N] - Determines the unique image frame to use from the MaxiMap.dc6 file that will be used to display on the Automap for that position of the level tile. There are multiple of these fields because they can be randomly chosen to give image variety in the Automap display. If the value equals -1, then this cell is not valid and will be ignored. If no cell is chosen overall, then nothing will be drawn in this area on the Automap.

Belts.txt

This file controls the statistics for how belts and their various item slots work.

This file relies on the belt field from the Armor.txt file. Each belt entry in this file defines a belt type that controls how many slots the belt item provides.

The game uses the 3rd entry is defined as the "default" belt, meaning that the player has no belt equipped, and the game will use this entry's stats to determine how to handle the belt slots.

Data Fields

name - [O] - This is a reference field to define the belt type

numboxes - [N] - This integer field defines the number of item slots in the belt. This is used when inserting items into the belt and also for handling the removal of items when the belt item is unequipped.

box1left - [N] - Specifies the belt slot left side coordinates. This is use for Server verification purposes and does not affect the local box UI in the client.

box1right - [N] - Specifies the belt slot right side coordinates. This is use for Server verification purposes and does not affect the local box UI in the client.

box1top - [N] - Specifies the belt slot left top coordinates. This is use for Server verification purposes and does not affect the local box UI in the client.

box1bottom - [N] - Specifies the belt slot bottom side coordinates. This is use for Server verification purposes and does not affect the local box UI in the client.

defaultItemTypeCol1 - [O] - Specifies the default item type used for the populate belt and auto-use functionality on controller.

defaultItemCodeCol1 - [O] - Specifies the default item code used for the populate belt and auto-use functionality on controller. Leaving this blank uses no code and instead relies entirely on the item type.

Books.txt

This file controls functionalities of book items (also called Tomes). This includes how they interact with their related scroll items.

Data Fields

Name - [O] - This is a reference field to define the book

ScrollSpellCode - [O] - Uses an item's code to define as the scroll item for the book

BookSpellCode - [O] - Uses an item's code to define as the book item

pSpell - [N] - Defines the item spell function to use when using the book. Referenced by the Code value of the Player Spell Table

SpellIcon - [O] - Controls which DC6 file to display for the mouse cursor when using the scroll or book (Uses numeric indices to pick the DC6 file. Example: When using Identify, use icon 1 or buysell.DC6)

ScrollSkill - [O] - Defines which Skill to use for the scroll item (Uses the skill field from Skills.txt)

BookSkill - [O] - Defines which Skill to use for the book item (Uses the skill field from Skills.txt)

BaseCost - [N] - The starting gold cost to buy the book from an NPC

CostPerCharge - [N] - The additional gold cost added with the book's "BaseCost" value, based on how many charges the book has

Charstats.txt

This file controls the starting stats for each of the classes

Data Fields

class - [O] - The name of the character class (this cannot be changed)

str - [N] - Starting amount of the Strength attribute

dex - [N] - Starting amount of the Dexterity attribute

int - [N] - Starting amount of the Energy attribute

vit - [N] - Starting amount of the Vitality attribute

stamina - [N] - Starting amount of Stamina

hpadd - [N] - Bonus starting Life value (This value gets added with the vit field value to determine the overall starting amount of Life)

ManaRegen - [N] - Number of seconds to regain max Mana. (If this equals 0 then it will default to 300 seconds)

ToHitFactor - [N] - Starting amount of Attack Rating

WalkVelocity - [N] - Base Walk movement speed

RunVelocity - [N] - Base Run movement speed

RunDrain - [N] - Rate at which Stamina is lost while running

LifePerLevel - [N] - Amount of Life added for each level gained (Calculated in fourths and is divided by 256)

StaminaPerLevel - [N] - Amount of Stamina added for each level gained (Calculated in fourths and is divided by 256)

ManaPerLevel [N] - Amount of Mana added for each level gained (Calculated in fourths and is divided by 256)

LifePerVitality - [N] - Amount of Life added for each point in Vitality (Calculated in fourths and is divided by 256)

StaminaPerVitality - [N] - Amount of Stamina added for each point in Vitality (Calculated in fourths and is divided by 256)

ManaPerMagic - [N] - Amount of Mana added for each point in Energy (Calculated in fourths and is divided by 256)

StatPerLevel - [N] - Amount of Attribute stat points earned for each level gained

SkillsPerLevel - [N] - Amount of Skill points earned for each level gained

LightRadius - [N] - Baseline radius size of the character's Light Radius

BlockFactor - [N] - Baseline percent chance for Blocking

MinimumCastingDelay - [N] - Global delay on all Skills after using a Skill with a Casting Delay (Calculated in Frames, where 25 Frames = 1 Second)

StartSkill - [O] - Controls what skill will be added by default to the character's starting weapon and will be slotted in the Right Skill selection (Uses the skill field from Skills.txt)

Skill 1 - [O] - Skill that the character starts with and will always have available (Uses the skill field from Skills.txt)

StrAllSkills - [O] - String key for displaying the item modifier bonus to all skills for the class (Ex: "+1 to Barbarian Skill Levels")

StrSkillTab1 - [O] - String key for displaying the item modifier bonus to all skills for the class's first to third skill tab (Ex: "+1 to Warcries")

StrClassOnly - [O] - String key for displaying on item modifier exclusive to the class or for class specific items (Ex: "Barbarian only")

HealthPotionPercent - [N] - This scales the amount of Life that a Healing potion will restore based on the class

ManaPotionPercent - [N] - This scales the amount of Mana that a Mana potion will restore based on the class

baseWClass - [O] - Base weapon class that the character will use by default when no weapon is equipped. Referenced by the Code value of the Weapon Class Table

item1 - [O] - Item that the character starts with (Uses the code field from Weapons.txt, Armor.txt or Misc.txt)

item1loc - [O] - Location where the related item will be placed in the character's inventory. Referenced from the Code column in BodyLocs.txt

item1count - [N] - The amount of the related item that the character starts with

item1quality - [O] - Controls the quality level of the related item using the below table:

Cubemain.txt

This file controls the recipes for the Horadric Cube

Data Fields

description - [O] - This is a reference field to define the cube recipe

enabled - [B] - If equals 1, then the recipe can be used in-game. If equals 0, then the recipe cannot be used in-game

ladder - [B] - If equals 1, then the recipe can only be used on Ladder realm games. If equals 0, then the recipe can be used in all game types

min diff - [N] - The minimum game difficulty to use the recipe (0 = All Game Difficulties | 1 = Nightmare and Hell Difficulty only | 2 = Hell Difficulty only)

version - [N] - Defines which game version to use this recipe (0 = Classic mode | 100 = Expansion mode)

op - [N] - Uses a function as an additional input requirement for the recipe. (See param and value)

param - [N] - Integer value used as a possible parameter for the op function. Normally uses the *ID field from ItemStatCost.txt for the param value

value - [N] - Integer value used as a possible parameter for the op function. Normally used to compare against the *ID linked in param

class - [O] - Defines the recipe to be only usable by a defined class. Referenced from the Code column in PlayerClass.txt

numinputs - [N] - Controls the number of items that need to be inside the cube for the recipe

input 1 - [O] - Controls what items are required for the recipe. Uses either the item's unique code or a combination of pre-defined codes from the table below, separated by commas if needed. (hiq,noe)

output - [O] - Controls the first to third output items. Uses either the item's unique code or a combination of pre-defined codes from the table below, separated by commas if needed. (hiq,noe).

lvl - [N] - Forces the output item level to be a specific level. If this field is used, then ignore the below plvl and ilvl fields

plvl - [N] - This is a numeric ratio that gets multiplied with the current player's level, to add to the output item's level requirement

ilvl - [N] - This is a numeric ratio that gets multiplied with input 1's item's level, to add to the output item's level requirement

mod 1 - [O] - Controls the output item properties (Uses the Code field from Properties.txt)

mod 1 chance - [N] - The percent chance that the property will be assigned. If this equals 0, then the Property will always be assigned

mod 1 param - [N] - The "parameter" value associated with the listed property (mod). Usage depends on the (Function ID field from Properties.txt)

mod 1 min - [N] - The "min" value to assign to the listed property (mod). Usage depends on the (Function ID field from Properties.txt)

mod 1 max - [N] - The "max" value to assign to the listed property (mod). Usage depends on the (Function ID field from Properties.txt)

DifficultyLevels.txt

This file controls global parameters for game rules and how they work between each difficulty mode

Users cannot add new difficulty modes from this file

Data Fields

Name - [O] - This is a reference field to define the difficulty mode

ResistPenalty - [N] - Defines the baseline starting point for a player character's resistances for Expansion mode

ResistPenaltyNonExpansion - [N] - Defines the baseline starting point for a player character's resistances for Non-Expansion mode

DeathExpPenalty - [N] - Modifies the percentage of current level Experience lost when a player character dies

MonsterSkillBonus - [N] - Adds additional skill levels to skills used by monsters (Only applies to monsters with skills assigned via the Skill1 column(s) in MonStats.txt)

MonsterFreezeDivisor - [N] - Divisor that affects all Freeze Length values on monsters. The attempted Freeze Length value is divided by this divisor to determine the actual Freeze Length

MonsterColdDivisor - [N] - Divisor that affects all Cold Length values on monsters. The attempted Cold Length value is divided by this divisor to determine the actual Cold Length

AiCurseDivisor - [N] - Divisor that affects all durations of Curses on monsters. The attempted Curse duration is divided by this divisor to determine the actual Curse duration

LifeStealDivisor - [N] - Divisor that affects the amount of Life Steal that player characters gain. The attempted Life Steal value is divided by this divisor to determine the actual Life Steal

ManaStealDivisor - [N] - Divisor that affects the amount of Mana Steal that player characters gain. The attempted Mana Steal value is divided by this divisor to determine the actual Mana Steal

UniqueDamageBonus - [N] - Percentage modifier for a Unique monster's overall Damage and Attack Rating. This is applied after calculating the monster's other modifications

ChampionDamageBonus - [N] - Percentage modifier for a Champion monster's overall Damage and Attack Rating. This is applied after calculating the monster's other modifications

PlayerDamagePercentVSPlayer - [N] - Percentage modifier for the total damage a player deals to another player

PlayerDamagePercentVSMercenary - [N] - Percentage modifier for the total damage a player deals to another player's mercenary

PlayerDamagePercentVSPrimeEvil - [N] - Percentage modifier for the total damage a player deals to a Prime Evil boss

PlayerHitReactBufferVSPlayer - [N] - The frame length for the amount of time a player cannot be placed into another hit react from a player (25 frames = 1 second)

PlayerHitReactBufferVSMonster - [N] - The frame length for the amount of time a player cannot be placed into another hit react from a monster (25 frames = 1 second)

MercenaryDamagePercentVSPlayer - [N] - Percentage modifier for the total damage a player's mercenary deals to another player

MercenaryDamagePercentVSMercenary - [N] - Percentage modifier for the total damage a player's mercenary deals to another player's mercenary

MercenaryDamagePercentVSBoss - [N] - Percentage modifier for the total damage a player's mercenary deals to a boss monster

MercenaryMaxStunLength - [N] - The frame length for the maximum stun length allowed on a player's mercenary (25 Frames = 1 second)

PrimeEvilDamagePercentVSPlayer - [N] - Percentage modifier applied to the total damage a Prime Evil boss deals to a player

PrimeEvilDamagePercentVSMercenary - [N] - Percentage modifier for the total damage a Prime Evil boss deals to a player's mercenary

PrimeEvilDamagePercentVSPet - [N] - Percentage modifier for the total damage a Prime Evil boss deals to a player's pet

PetDamagePercentVSPlayer - [N] - Percentage modifier for the total damage a player's pet deals to another player

MonsterCEDamagePercent - [N] - Percentage modifier that affects how much damage is dealt to a player by a Monster's version of Corpse Explosion. For example, when certain monsters die and explode on death

MonsterFireEnchantExplosionDamagePercent - [N] - Percentage modifier that affects how much damage is dealt to a player by a Monster's Fire Enchant explosion. The Fire Enchant death explosion uses the same Corpse Explosion functionality and this value is applied after the "MonsterCEDamagePercent" value

StaticFieldMin - [N] - Percentage modifier for capping the amount of current Life damage dealt to monsters by the Sorceress Static Field skill. This field only affects games in Expansion mode

GambleRare - [N] - The odds to obtain a Rare item from gambling. The game rolls a random number between 0 to 100000. If that rolled number is less than this value, then the gambled item will be a Rare item

GambleSet - [N] - The odds to obtain a Set item from gambling. The game rolls a random number between 0 to 100000. If that rolled number is less than this value, then the gambled item will be a Set item

GambleUnique - [N] - The odds to obtain a Unique item from gambling. The game rolls a random number between 0 to 100000. If that rolled number is less than this value, then the gambled item will be a Unique item

GambleUber - [N] - The odds to make the gambled item be an Exceptional Quality item. The game rolls a random number between 0 to 10000. This rolled number is then compared to the following formula:
([Item Level] - [Base Item Level]) * ["GambleUber"] + 1. If the rolled number is less than this value, then the item becomes an Exceptional Quality item, and the game will roll for upgrading it to Elite Quality ("GambleUltra")

GambleUltra - [N] - The odds to make the gambled item be an Elite Quality item. The game rolls a random number between 0 to 10000. This rolled number is then compared to the following formula:
([Item Level] - [Base Item Level]) * ["GambleUltra"] + 1. If the rolled number is less than this value, then the item is upgraded to an Elite Quality item. This only happens if the item successfully rolled for Exceptional Quality.

Experience.txt

This file controls the Experience required for each level by each class

Data Fields

Level - [O] - This is a reference field to define the level

Amazon - [N] - Controls the Experience required for each level with the Amazon class

Sorceress - [N] - Controls the Experience required for each level with the Sorceress class

Necromancer - [N] - Controls the Experience required for each level with the Necromancer class

Paladin - [N] - Controls the Experience required for each level with the Paladin class

Barbarian - [N] - Controls the Experience required for each level with the Barbarian class

Druid - [N] - Controls the Experience required for each level with the Druid class

Assassin - [N] - Controls the Experience required for each level with the Assassin class

ExpRatio - [N] - This multiplier affects the percentage of Experienced earned, based on the level (Calculated in 1024ths by default, but this can be changed by updating the "10" value in the "Maxlvl" row)

Gamble.txt

This file controls what Item Types will appear as possible items to purchase in the Gambling UI

Item Types can be added to this list as a potential option for the Gambling system

Data Fields

name - [O] - This is a reference field to describe the Item

code - [O] - This is a pointer to code field from Weapons.txt/Armor.txt/Misc.txt

Gems.txt

This file controls the item modifiers of Gems and runes for each item type

This file is used by the following files: Weapons.txt, Armor.txt, Misc.txt

Data Fields

name - [O] - This is a reference field to define the gem/rune name

letter - [O] - Defines the string that is concatenated together in the item tooltip when a rune is socketed into an item

transform - [N] - Controls the color change of the item after being socketed by the gem/rune. Referenced from the Index value in colors.txt

code - [O] - Defines the unique item code used to create the gem/rune

weaponMod1Code - [O] - Controls the item properties that the gem/rune provides when socketed into an item with a "gemapplytype" value that equals 0 (Uses the Code field from Properties.txt)

weaponMod1Param - [N] - The stat's "parameter" value associated with the listed property (weaponMod1Code). Usage depends on the (Function ID field from Properties.txt)

weaponMod1Min - [N] - The stat's "min" value associated with the listed property (weaponMod1Code). Usage depends on the (Function ID field from Properties.txt)

weaponMod1Max - [N] - The stat's "max" value to assign to the listed property (weaponMod1Code). Usage depends on the (Function ID field from Properties.txt)

helmMod1Code - [O] - Controls the item properties that the gem/rune provides when socketed into an item with a "gemapplytype" value that equals 1 (Uses the Code field from Properties.txt)

helmMod1Param - [N] - The stat's "parameter" value associated with the listed property (helmMod1Code). Usage depends on the (Function ID field from Properties.txt)

helmMod1Min - [N] - The stat's "min" value associated with the listed property (helmMod1Code). Usage depends on the (Function ID field from Properties.txt)

helmMod1Max - [N] - The stat's "max" value to assign to the listed property (helmMod1Code). Usage depends on the (Function ID field from Properties.txt)

shieldMod1Param - [N] - The stat's "parameter" value associated with the listed property (shieldMod1Code). Usage depends on the (Function ID field from Properties.txt)

shieldMod1Min - [N] - The stat's "min" value associated with the listed property (shieldMod1Code). Usage depends on the (Function ID field from Properties.txt)

shieldMod1Max - [N] - The stat's "max" value to assign to the listed property (shieldMod1Code). Usage depends on the (Function ID field from Properties.txt)

Hireling.txt

This file controls the unit statistics for player mercenaries and their related functions

Data Fields

Hireling - [O] - This is a reference field to define the Hireling name

Version - [N] - Defines which game version to use this hireling (0 = Classic mode | 100 = Expansion mode)

ID - [N] - The unique identification number to define each hireling type

Class - [N] - This refers to the hcIDx field in MonStats.txt, which defines the base type of unit to use for the hireling

Act - [N] - The Act that the hireling belongs to (values 1 to 5 equal Act 1 to Act 5, respectively)

Difficulty - [N] - The difficulty mode associated with the hireling (1 = Normal | 2 = Nightmare | 3 = Hell)

Level - [N] - The starting level of the unit

Seller - [N] - This refers to the hcIDx field in MonStats.txt, which defines the unit NPC that sells this hireling

NameFirst & NameLast - [O] - These fields define a string key which the game uses as a sequential range of string IDs from "NameFirst" to "NameLast" to randomly generate as hireling names. (Max name length is 48 characters)

Gold - [N] - The initial cost of the hireling. This is used in the following calculation to generate the full hire price: Cost = ["Gold"] * (100 + 15 * [Difference of Current Level and "Level"]) / 100

Exp/Lvl - [N] - This modifier is used in the following calculation to determine the amount of Experience need for the hireling's next level: [Current Level] + [Current Level] * [Current Level + 1] * ["Exp/Lvl"]

HP - [N] - The starting amount of Life at base Level

HP/Lvl - [N] - The amount of Life gained per Level

Defense - [N] - The starting amount of Defense at base Level

Def/Lvl - [N] - The amount of Defense gained per Level

Str - [N] - The starting amount of Strength at base Level

Str/Lvl - [N] - The amount of Strength gained per Level (Calculated in 8ths)

Dex - [N] - The starting amount of Dexterity at base Level

Dex/Lvl - [N] - The amount of Dexterity gained per Level (Calculated in 8ths)

AR - [N] - The starting amount of Attack Rating at base Level

AR/Lvl - [N] - The amount of Attack Rating gained per Level

Dmg-Min - [N] - The starting amount of minimum Physical Damage for attacks

Dmg-Max - [N] - The starting amount of maximum Physical Damage for attacks

Dmg/Lvl - [N] - The amount of Physical Damage gained per level, to be added to "Dmg-Min" and "Dmg-Max" (Calculated in 8ths)

ResistFire - [N] - The starting amount of Fire Resistance at base Level

ResistFire/Lvl - [N] - The amount of Fire Resistance gained per Level (Calculated in 4ths)

ResistCold - [N] - The starting amount of Fire Resistance at base Level

ResistCold/Lvl - [N] - The amount of Fire Resistance gained per Level (Calculated in 4ths)

ResistLightning - [N] - The starting amount of Fire Resistance at base Level

ResistLightning/Lvl - [N] - The amount of Fire Resistance gained per Level (Calculated in 4ths)

ResistPoison - [N] - The starting amount of Fire Resistance at base Level

ResistPoison/Lvl - [N] - The amount of Fire Resistance gained per Level (Calculated in 4ths)

HireDesc - [O] - This accepts a string key, which is used to display as the special description of the hireling in the hire UI window (local/lng/strings/mercenaries.JSON)

DefaultChance - [N] - This is the chance for the hireling to attack with his/her weapon instead of using a Skill. All Chance values are summed together as a denominator value for a random roll to determine which skill to use

Skill1 - [O] - Points to a skill from the skill field in the Skills.txt file. This gives the hireling the Skill to use (requires "Mode#", "Chance#", "ChancePerLvl#")

Mode1 - [O] - Uses a monster mode to determine the hireling's behavior when using the related Skill. Referenced from the Index value in MonMode.txt

Chance1 - [N] - This is the base chance for the hireling to use the related Skill. All Chance values are summed together as a denominator value for a random roll to determine which skill to use

ChancePerLvl1 - [N] - This is the chance for the hireling to use the related Skill, affected by the difference in the hireling's current Level and the hireling's Level field. All Chance values are summed together as a denominator value for a random roll to determine which skill to use. Each skill Chance is calculated with the following formula: ["Chance#"] + ["ChancePerLvl#"] * [Difference of Current Level and "Level"] / 4

Level1 - [N] - The starting Level for the related Skill

LvlPerLvl1 - [N] - A modifier to increase the related Skill level for every Level gained. This is used in the following calculated to determine the current skill level: [Current Skill Level] = FLOOR(["Level"] + ((["LvlPerLvl"] * [Difference of Current Level and "Level"]) / 32))

HiringMaxLevelDifference - [N] - This is used to generate a range with this value plus and minus with the player's current Level. In the hiring UI window, hirelings start with a random Level that is between this range

resurrectcostmultiplier - [N] - A modifier used to calculate the hireling's current resurrect cost. Used in the following formula: [Resurrect Cost] = [Current Level] * [Current Level] / ["resurrectcostdivisor"] * ["resurrectcostmultiplier"]

resurrectcostdivisor - [N] - A modifier used to calculate the hireling's current resurrect cost. Used in the following formula: [Resurrect Cost] = [Current Level] * [Current Level] / ["resurrectcostdivisor"] * ["resurrectcostmultiplier"]

resurrectcostmax - [N] - This is the maximum Gold cost to resurrect this hireling

equivalentcharclass - [O] - Determines what class this hireling is treated like under the hood when calculating skill level bonuses and gear restrictions.

HirelingDesc.txt

This file controls attributes about player mercenaries that relate to the monster class but not the specific statblocks.

Data Fields

id - [N] - The id of the hireling monster class as defined in monstats.txt

alternateVoice - [B] - If equals 1, then the hireling will use the alternate (feminine) voice type for voice lines. If equals 0, then it will use the masculine voice type.

Inventory.txt

This file controls the grid sizes of the inventory slots for the game's various UI windows.

These values are measured in pixels on the screen.

Data Fields

class - [O] - This is a reference field to define the type of inventory screen

invLeft - [N] - Starting X coordinate pixel position of the inventory panel

invRight - [N] - Ending X coordinate pixel position of the inventory panel (Includes the "invLeft" value with the inventory width size)

invTop - [N] - Starting Y coordinate pixel position of the inventory panel

invBottom - [N] - Ending Y coordinate pixel position of the inventory panel (Includes the "invTop" value with the inventory height size)

gridX - [N] - Column number size of the inventory grid, measured in the number of grid boxes to use

gridY - [N] - Column row size of the inventory grid, measured in the number of grid boxes to use

gridLeft - [N] - Starting X coordinate location of the inventory's left grid side

gridRight - [N] - Ending X coordinate location of the inventory's right grid side (Includes the "gridLeft" value with the grid width size)

gridTop - [N] - Starting Y coordinate location of the inventory's top grid side

gridBottom - [N] - Ending Y coordinate location of the inventory's bottom grid side (Includes the "gridTop" value with the grid height size)

gridBoxWidth - [N] - Width size of an inventory's box cell

gridBoxHeight - [N] - Height size of an inventory's box cell

rArmLeft - [N] - Starting X coordinate location of the Right Weapon Slot

rArmRight - [N] - Ending X coordinate location of the Right Weapon Slot (Includes the "rArmLeft" value with the "rArmWidth" value)

rArmTop - [N] - Starting Y coordinate location of the Right Weapon Slot

rArmBottom - [N] - Ending Y coordinate location of the Right Weapon Slot (Includes the "rArmTop" value with the "rArmHeight" value)

rArmWidth - [N] - The pixel width of the Right Weapon Slot

rArmHeight - [N] - The pixel Height of the Right Weapon Slot

torsoLeft - [N] - Starting X coordinate location of the Body Armor Slot

torsoRight - [N] - Ending X coordinate location of the Body Armor Slot (Includes the "torsoLeft" value with the "torsoWidth" value)

torsoTop - [N] - Starting Y coordinate location of the Body Armor Slot

torsoBottom - [N] - Ending Y coordinate location of the Body Armor Slot (Includes the "torsoTop" value with the "torsoHeight" value)

torsoWidth - [N] - The pixel width of the Body Armor Slot

torsoHeight - [N] - The pixel Height of the Body Armor Slot

lArmLeft - [N] - Starting X coordinate location of the Left Weapon Slot

lArmRight - [N] - Ending X coordinate location of the Left Weapon Slot (Includes the "lArmLeft" value with the "lArmWidth" value)

lArmTop - [N] - Starting Y coordinate location of the Left Weapon Slot

lArmBottom - [N] - Ending Y coordinate location of the Left Weapon Slot (Includes the "lArmTop" value with the "lArmHeight" value)

lArmWidth - [N] - The pixel width of the Left Weapon Slot

lArmHeight - [N] - The pixel Height of the Left Weapon Slot

headLeft - [N] - Starting X coordinate location of the Helm Slot

headRight - [N] - Ending X coordinate location of the Helm Slot (Includes the "headLeft" value with the "headWidth" value)

headTop - [N] - Starting Y coordinate location of the Helm Slot

headBottom - [N] - Ending Y coordinate location of the Helm Slot (Includes the "headTop" value with the "headHeight" value)

headWidth - [N] - The pixel width of the Helm Slot

headHeight - [N] - The pixel Height of the Helm Slot

neckLeft - [N] - Starting X coordinate location of the Amulet Slot

neckRight - [N] - Ending X coordinate location of the Amulet Slot (Includes the "neckLeft" value with the "neckWidth" value)

neckTop - [N] - Starting Y coordinate location of the Amulet Slot

neckBottom - [N] - Ending Y coordinate location of the Amulet Slot (Includes the "neckTop" value with the "neckHeight" value)

neckWidth - [N] - The pixel width of the Amulet Slot

neckHeight - [N] - The pixel Height of the Amulet Slot

rHandLeft - [N] - Starting X coordinate location of the Right Ring Slot

rHandLeft - [N] - Ending X coordinate location of the Right Ring Slot (Includes the "rHandLeft" value with the "rHandWidth" value)

rHandTop - [N] - Starting Y coordinate location of the Right Ring Slot

rHandBottom - [N] - Ending Y coordinate location of the Right Ring Slot (Includes the "rHandTop" value with the "rHandHeight" value)

rHandWidth - [N] - The pixel width of the Right Ring Slot

rHandHeight - [N] - The pixel Height of the Right Ring Slot

lHandLeft - [N] - Starting X coordinate location of the Left Ring Slot

lHandRight - [N] - Ending X coordinate location of the Left Ring Slot (Includes the "lHandLeft" value with the "lHandWidth" value)

lHandTop - [N] - Starting Y coordinate location of the Left Ring Slot

lHandBottom - [N] - Ending Y coordinate location of the Left Ring Slot (Includes the "lHandTop" value with the "lHandHeight" value)

lHandWidth - [N] - The pixel width of the Left Ring Slot

lHandHeight - [N] - The pixel Height of the Left Ring Slot

beltLeft - [N] - Starting X coordinate location of the Belt Slot

beltRight - [N] - Ending X coordinate location of the Belt Slot (Includes the "beltLeft" value with the "beltWidth" value)

beltTop - [N] - Starting Y coordinate location of the Belt Slot

beltBottom - [N] - Ending Y coordinate location of the Belt Slot (Includes the "beltTop" value with the "beltHeight" value)

beltWidth - [N] - The pixel width of the Belt Slot

beltHeight - [N] - The pixel Height of the Belt Slot

feetLeft - [N] - Starting X coordinate location of the Boots Slot

feetRight - [N] - Ending X coordinate location of the Boots Slot (Includes the "feetLeft" value with the "feetWidth" value)

feetTop - [N] - Starting Y coordinate location of the Boots Slot

feetBottom - [N] - Ending Y coordinate location of the Boots Slot (Includes the "feetTop" value with the "feetHeight" value)

feetWidth - [N] - The pixel width of the Boots Slot

feetHeight - [N] - The pixel Height of the Boots Slot

glovesLeft - [N] - Starting X coordinate location of the Gloves Slot

glovesRight - [N] - Ending X coordinate location of the Gloves Slot (Includes the "glovesLeft" value with the "glovesWidth" value)

glovesTop - [N] - Starting Y coordinate location of the Gloves Slot

glovesBottom - [N] - Ending Y coordinate location of the Gloves Slot (Includes the "glovesTop" value with the "glovesHeight" value)

glovesWidth - [N] - The pixel width of the Gloves Slot

glovesHeight - [N] - The pixel Height of the Gloves Slot

ItemRatio.txt

This file determines the quality of items when being spawned. After the game determines what Item Type should spawn, it then uses this file to calculate the quality of that item.

These Item Quality checks are used for most item drops in the game such as monster drops and chest drops.

The following files related to these calculations: ItemTypes.txt, Weapons.txt, Armor.txt, Misc.txt, Uniqueitems.txt, SetItems.txt, monstats.txt, TreasureClassEx.txt

Data Fields

Function - [O] - This is a reference field to define the item ratio name

Version - [N] - Defines which game version to use this item ratio (0 = Classic mode | 100 = Expansion mode)

Uber - [B] - If equals 1, then the item ratio will apply to items with Exceptional or Elite Quality. If equals 0, then the item ratio will apply to Normal Quality items (This is determined by the normcode, ubercode and ultracode fields in Armor/Weapons.txt)

Class Specific - [B] - If equals 1, then the item ratio will apply to class-based items (This will compare to the Item Type's Class field from ItemTypes.txt to determine if the item is class specific)

Unique - [N] - Base value for calculating the Unique Quality chance. Higher value means rarer chance. (Calculated first)

UniqueDivisor - [N] - Modifier for changing the Unique Quality chance, based on the difference between the Monster Level and the Item's base level

UniqueMin - [N] - The minimum value of the probability denominator for Unique Quality. This is compared to the calculated Unique Quality value after Magic Find calculations and is chosen if it is greater than that value. (Calculated in 128ths)

Set - [N] - Base value for calculating the Set Quality chance. Higher value means rarer chance. (Calculated after Unique)

SetDivisor - [N] - Modifier for changing the Set Quality chance, based on the difference between the Monster Level and the Item's base level

SetMin - [N] - The minimum value of the probability denominator for Set Quality. This is compared to the calculated Set Quality value after Magic Find calculations and is chosen if it is greater than that value. (Calculated in 128ths)

Rare - [N] - Base value for calculating the Rare Quality chance. Higher value means rarer chance. (Calculated after Set)

RareDivisor - [N] - Modifier for changing the Rare Quality chance, based on the difference between the Monster Level and the Item's base level

RareMin - [N] - The minimum value of the probability denominator for Rare Quality. This is compared to the calculated Rare Quality value after Magic Find calculations and is chosen if it is greater than that value. (Calculated in 128ths)

Magic - [N] - Base value for calculating the Magic Quality chance. Higher value means rarer chance. (Calculated after Rare)

MagicDivisor - [N] - Modifier for changing the Magic Quality chance, based on the difference between the Monster Level and the Item's base level

MagicMin - [N] - The minimum value of the probability denominator for Magic Quality. This is compared to the calculated Magic Quality value after Magic Find calculations and is chosen if it is greater than that value. (Calculated in 128ths)

HiQuality - [N] - Base value for calculating the High Quality (Superior) chance. Higher value means rarer chance. (Calculated after Magic)

HiQualityDivisor - [N] - Modifier for changing the High Quality (Superior) chance, based on the difference between the Monster Level and the Item's base level

Normal - [N] - Base value for calculating the Normal Quality chance. Higher value means rarer chance. (Calculated after Normal, and if this does not succeed in rolling, then the item is defaulted to Low Quality)

NormalDivisor - [N] - Modifier for changing the Normal Quality chance, based on the difference between the Monster Level and the Item's base level

Calculations

Item Quality is determined by first calculating the roll chance for a specific Quality. Then the game will attempt a random roll for that Item Quality. If that roll fails, then the game will calculate for the next lower Item Quality.

The order of Item Quality calculations is the following: Unique > Set > Rare > Magic > High Quality (Superior) > Normal > Low Quality

The following information details how the game uses the Data Fields in its calculations.

Step 1: Calculate the Base Probability

The first part of the calculations is to obtain the base probability for rolling the item quality with the following formula:

Probability = ( Quality - ( mlvl - ilvl ) / Divisor ) * 128

This probability value is a ratio divisor, meaning that there is a 1 in probability chance of the game choosing that Item Quality, so the lower the probability value, then the better the chance the item will successfully roll that Item Quality. The multiplication with 128 is for decreasing rounding errors. The Quality value is the "Unique"/"Set"/"Rare"/"Magic"/"HiQuality"/"Normal" Data Field. The mlvl value is the Monster Level, which depends on the current area level and game difficulty (this can also be the level for the chest drop). The ilvl value is the Base Item Level (the "level" field in the Weapons.txt/Armor.txt/Misc.txt or the "lvl" field in UniqueItems.txt/SetItems.txt). The Divisor value is the "UniqueDivisor"/"SetDivisor"/"RareDivisor"/"MagicDivisor"/"HiQualityDivisor"/"NormalDivisor" Data Field

Step 2: Calculate Magic Find

The game will then obtain the character's magic find bonus from items. If the current calculation is for Unique/Set/ Rare Quality items and the magic find item bonus exceeds 110%, then the character's magic find will be modified with diminishing returns:

MagicFind = 100 + MF * dim / (MF + dim)

The MF value is the character's magic find bonus percentage value plus the baseline default 100 value ("item_magicbonus" in ItemStatCost.txt). The dim value is a special modifier for adding diminishing returns to the magic find bonus, which differs based on the Item Quality being calculated (Unique = 250, Set = 500, Rare = 600)

After calculating the proper magic find value, the probability value is modified with the following formula:

Probability = Probability * 100 / MagicFind

This will reduce the Probability value, giving the Item Quality a higher chance to be successfully rolled

Step 3: Calculate Probability with Treasure Class

After calculating the baseline probability with the magic find bonus, the game will then compare this value with the minimum value for the Item Quality to cap it from reducing any further ("UniqueMin"/"SetMin"/"RareMin"/"MagicMin" Data Fields). High Quality (Superior) and Normal Quality do not have a minimum value.

The game will then modify the probability with the value from the related Treasure Class:

Probability = Probability - Probability * TreasureClass / 1024

The TreasureClass value is a modifier for this Item Quality based on the Treasure Class being used (the "Unique"/"Set"/"Rare"/"Magic" field from the TreasureClassEx.txt file)

Step 4: Roll for the Item Quality

Finally, after calculating the overall value of the probability for the Item Quality, the game will then find a random number between 0 and the probability value. If that random value is between 0 and 128, then the item has successfully rolled that specific Item Quality. Otherwise, the calculations will move on to checking for the next lower Item Quality.

ItemStatCost.txt

Thisfile controls the functionalities for each possible stat on a unit

Thesedefined stats are used to form modifiers for the Properties.txt file

Anycolumn field name starting with "*" is considered a comment field and is notused by the game

Data Fields

Stat - [O] - Defines the unique pointer for this stat, which is used in other files

*ID - [N] - This field is not read directly, but can be used as an Index for stats

Send Other - [B] - If equals 1, then only add the stat to a new monster if the that has no state and has an item mask. If equals 0, then ignore this

Signed - [B] - If equals 1, then the stat will be treated as a signed integer, meaning that it can be either a positive or negative value. If equals 0, then stat will be treated as an unsigned integer, meaning that it can only be a positive value. This only affects stats with state bits

Send Bits - [N] - Controls how many bits of data for the stat to send to the game client, essentially controlling the max value possible for the stat. Signed values should have less than 32 bits, otherwise they will be treated as unsigned values

Send Param Bits - [N] - Controls how many bits of data for the stat's parameter value to send to the client for a unit. This value is always treated as a signed integer

UpdateAnimRate - [B] - If equals 1, then the stat will notify that game to handle and adjust the speed of the unit when the stat changes. If equals 0, then ignore this. This is only checked for stats with States or for specific skill server functions including 30, 61, 71

Saved - [B] - If equals 1, then this state will be inserted in the change list to be stored in the Character Save file. If equals 0, then ignore this

CSvSigned - [B] - If equals 1, then the stat will be saved as a signed integer in the Character Save file. If equals 0, then the stat will be saved as an unsigned integer in the Character Save file. This is only used if the "Saved" field is enabled

CSvBits - [N] - Controls how many bits of data for the stat to send to save in the Character Save file. Signed values should have less than 32 bits, otherwise they will be treated as unsigned values. This is only used if the "Saved" field is enabled

CSvParam - [N] - Controls how many bits of data for the stat's parameter value to save in the Character Save file. This value is always treated as a signed integer. This is only used if the "Saved" field is enabled

fCallback - [B] - If equals 1, then any changes to the stat will call the Callback function which will update thgecharacter's States, skills, or item events based on the changed stat value. If equals 0, then ignore this

fMin - [B] - If equals 1, then the stat will have a minimum value that cannot be reduced further than that value ("MinAccr" field). If equals 0, then ignore this

MinAccr - [N] - The minimum value of a stat. This is only used if the "fMin" field is enabled

Encode - [N] - Controls how the stat will modify an item's buy, sell, and repair costs. This field uses a code value to select a function to handle the calculations. This field relies on the "Add", "Multiply" and "ValShift" fields. The baseline Stat Value is first modified using the "ValShift" field to shift the bits. This Stat Value is then used in the calculations by one of the selected functions.

Add - [N] - Used as a possible parameter value for the "Encode" function. Flat integer modification to the Unique item's buy, sell, and repair costs. This is added after the "Multiply" field has modified the costs

Multiply - [N] - Used as a possible parameter value for the "Encode" function. Multiplicative modifier for the item's buy, sell, and repair costs. The way this value is used depends on the Encode function selected

ValShift - [N] - Used to shift the stat's input value by a number of bits to obtain the actual value when performing calculations (such as for the "Encode" function)

1.09-Save Bits - [N] - Controls how many bits of data are allocated for the overall size of the stat when saving/reading an item from a Character Save. This value can be treated as a signed or unsigned integer, depending on the stat. This field is only used for items saved in a game version of Patch 1.09d or older

1.09-Save Add - [N] - Controls how many bits of data are allocated for the stat's value when saving/reading an item from a Character Save. This value is treated as a signed integer. This field is only used for items saved in a game version of Patch 1.09d or older

Save Bits - [N] - Controls how many bits of data are allocated for the overall size of the stat when saving/reading an item from a Character Save. This value can be treated as a signed or unsigned integer, depending on the stat

Save Add - [N] - Controls how many bits of data are allocated for the stat's value when saving/reading an item from a Character Save. This value is treated as a signed integer

Save Param Bits - [N] - Controls how many bits of data for the stat's parameter value to use when saving/reading an item from a Character Save. This value is always treated asan unsigned integer

keepzero - [B] - If equals 1, then this stat will remain on the stat change list, when being updated, even if that stat value is 0. If equals 0, then ignore this

op - [N] - This is the stat operator, used for advanced stat modification when calculating the value of a stat. This can involves using this stat and its value to modify another stat's value. This use a function ID to determine what to calculate.

op param - [N] - Used as a possible parameter value for the "op" function

op base - [N] - Used as a possible parameter value for the "op" function

op stat1 - [N] - Used as a possible parameter value for the "op" function

direct - [B] - If equals 1, then when the stat is being updated in certain skill functions having to do with state changes, the stat will update in relation to its "maxstat" field to ensure that it never exceeds that value. If equals 0, then ignore this, and the stat will simply update in these cases. This only applies to skills that use skill server function 65, 66, 81, and 82

maxstat - [O] - Controls which stat is associated with this stat to be treated as the maximum version of this stat. This means that 2 stats are essentially linked so that there can be a current version of the stat and a maximum version to control the cap of stat's value. This is used for Life, Mana, Stamina, and Durability. This field relies on the "direct" field to be enabled unless it is being used for the healing potion item spell

damagerelated - [B] - If equals 1, then this stat will be exclusive to the item and will not add to the unit. If equals 0, then ignore this, and the stat will always add to the unit. This is typically used for weapons and is important when dual wielding weapons so that when a unit attacks, then one weapon's stats do not stack with another weapon's stats

itemevent1 - [N] - Uses an event that will activate the specified function defined by "itemeventfunc#". Referenced from the event column in Events.txt

itemeventfunc1 - [N] - Specifies the function to use after the related item event occurred. Functions are defined by a numeric ID code. This is only applied based on the "itemevent#" field definition. Referenced by the Code value of the Event Functions Table

descpriority - [N] - Controls how this stat is sorted in item tooltips. This field is compared to the same field on other stats to determine how to order the stats. The higher the value means that the stat will be sorted higher than other stats. If more than 1 stat has the same "descpriority" value, then they will be listed in the order defined in this data file

descfunc - [N] - Controls how the stat is displayed in tooltips. Uses the Code value from the below table to format the string value using the specified function

descval - [N] - Used as a possible parameter value for the descfunc function. This controls the how the value of the stat is displayed.

descstrpos - [O] - Used as a possible parameter value for the descfunc function. This uses a string to display the item stat in a tooltip when its value is positive

descstrneg - [O] - Used as a possible parameter value for the descfunc function. This uses a string to display the item stat in a tooltip when its value is negative

descstr2 - [O] - Used as a possible parameter value for the descfunc function. This uses a string to append to an item stat's string in a tooltip

dgrp - [N] - Assigns the stat to a group ID value. If all stats with a matching "dgrp" value are applied on the unit, then instead of displaying each stat individually, the group description will be applied instead (dgrpfunc field below)

dgrpfunc - [N] - Controls how the shared group of stats is displayed in tooltips. Uses an ID value to select a description function to format the string value. This function IDs are exactly the same as the descfunc field

dgrpval - [N] - Used as a possible parameter value for the dgrpfunc function. This controls the how the value of the stat is displayed. (Functions the same as the "descval" field)

dgrpstrpos - [O] - Used as a possible parameter value for the dgrpfunc function. This uses a string to display the item stat in a tooltip when its value is positive

dgrpstrneg - [O] - Used as a possible parameter value for the dgrpfunc function. This uses a string to display the item stat in a tooltip when its value is negative

dgrpstr2 - [O] - Used as a possible parameter value for the dgrpfunc function. This uses a string to append to an item stat's string in a tooltip

stuff - [N] - Used as a bit shift value for handling the conversion of skill IDs and skill levels to bit values for the stat. Controls the numeric range of possible skill IDs and skill levels for charge based items. This value cannot be less than or equal to 0, or greater than 8, otherwise it will default to 6. The row that this value appears in the data file is unrelated, since this is a universally applied value

advdisplay - [N] - Controls how the stat appears in the Advanced Stats UI

ItemTypes.txt

This file controls the general statistics for each type of item, which is then used for the item type fields in other files

Data Fields

ItemType - [O] - This is a reference field to define the Item Type name

Code - [O] - Defines the unique pointer for this Item Type, which is used by various data files

Equiv1 - [O] - Points to the index of another Item Type to reference as a parent. This is used to create a hierarchy for Item Types where the parents will have more universal settings shared across the related children

Repair - [B] - If equals 1, then the item can be repaired by an NPC in the shop UI. If equals 0, then the item cannot be repaired

Body - [B] - If equals 1, then the item can be equipped by a character (Also uses the BodyLoc1 field(s) as parameters). If equals 0, then the item can only be carried in the inventory, stash, or Horadric Cube

BodyLoc1 - [O] - These are required parameters if the Body field is enabled. These fields specify the inventory slots where the item can be equipped. Referenced from the Code column in BodyLocs.txt

Shoots - [N] - Points to the index of another Item Type as the required equipped Item Type to be used as ammo

Quiver - [N] - Points to the index of another Item Type as the required equipped Item Type to be used as this ammo's weapon

Throwable - [B] - If equals 1, then it determines that this item is a throwing weapon. If equals 0, then ignore this

Reload - [B] - If equals 1, then the item (considered ammo in this case) will be automatically transferred from the inventory to the required BodyLoc1 when another item runs out of that specific ammo. If equals 0, then ignore this

ReEquip - [B] - If equals 1, then the item in the inventory will replace a matching equipped item if that equipped item was destroyed. If equals 0, then ignore this

AutoStack - [B] - If equals 1, then if the player picks up a matching Item Type, then they will try to automatically stack together. If equals 0, then ignore this

Magic - [B] - If equals 1, then this item will always have the Magic quality (unless it is a Quest item). If equals 0, then ignore this

Rare - [B] - If equals 1, then this item can spawn as a Rare quality. If equals 0, then ignore this

Normal - [B] - If equals 1, then this item will always have the Normal quality. If equals 0, then ignore this

Beltable - [B] - If equals 1, then this item can be placed in the character's belt slots. If equals 0, then ignore this

MaxSockets1 - [N] - Determines the maximum possible number of sockets that can be spawned on the item when the item level is greater than or equal to 1 and less than or equal to the matching MaxSocketsLevelThreshold1 value(s). The number of sockets is also determined by the Gemsockets value from AMW.txt

MaxSocketsLevelThreshold1 - [N] - Defines the item level thresholds using the above MaxSockets1 field(s)

TreasureClass - [B] - If equals 1, then allow this Item Type to be used in default treasure classes. If equals 0, then ignore this

Rarity - [N] - Determines the chance for the item to spawn with stats, when created as a random Weapon/Armor/Misc item. Used in the following formula: IF RANDOM(0, (["Rarity"] - [Current Act Level]))> 0, THEN spawn stats

StaffMods - [O] - Determines if the Item Type should have class specific item skill modifiers. Grants skills to the class listed using the Code column in PlayerClass.txt

Class - [O] - Determines if this item should be useable only by a specific class. Referenced from the Code column in PlayerClass.txt

VarInvGfx - [N] - Tracks the number of inventory graphics used for this item type. This number much match the number of InvGfx1 field(s) used

InvGfx1 - [O] - Defines a DC6 file to use for the item's inventory graphics. The entry amount should equal the value used in above VarInvGfx

StorePage - [O] - Uses a code to determine which UI tab page on the NPC shop UI to display this Item Type, such as after it is sold to the NPC. Referenced from the Code column in StorePage.txt

LevelGroups.txt

This file controls how the game groups levels together. This has currently no gameplay purpose and is mainly used for condensing level names in desecrated (terror) zone messaging.

Data Fields

Name - [O] - Defines the unique name pointer for the level group, which is used in other files

ID - [N] - Defines the unique numeric ID for the level group, which is used in other files

GroupName - [O] - String Field. Used for displaying the name of the level group, such as when all levels in a group have been desecrated (Terrorized)

Levels.txt

This file controls how the game controls the area levels, including how the level is built, what rules are allowed on the level, and what monsters/objects can spawn on the level.

This file uses the following files: AutoMap.txt, LevelGroups.txt, LvlMaze.txt, LvlPrest.txt, LvlSub.txt, LvlTypes.txt, LvlWarp.txt, monstats.txt, Objgroup.txt

Data Fields

Name - [O] - Defines the unique name pointer for the area level, which is used in other files

ID - [N] - Defines the unique numeric ID for the area level, which is used in other files

Pal - [N] - Defines which palette file to use for the area level. This uses index values from 0 to 4 to convey Act 1 to Act 5

Act - [N] - Defines the Act number that the area level is a part of. This uses index values from 0 to 4 to convey Act 1 to Act 5

QuestFlag - [N] - Controls what quest record that the player needs to have completed before being allowed to enter this area level, while playing in Classic Mode. Each quest can have multiple quest records, and this field is looking for a specific quest record from a quest. Referenced by the Code value of the Quest Flags Table

QuestFlagEx - [N] - Controls what quest record that the player needs to have completed before being allowed to enter this area level, while playing in Expansion Mode. Each quest can have multiple quest records, and this field is looking for a specific quest record from a quest. Referenced by the Code value of the Quest Flags Table

Layer - [N] - Defines a unique numeric ID that is used to identify which Automap data belongs to which area level when saving and loading data from the character save

SizeX - [N] - Specifies the Length tile size values of an entire area level, which are used for determining how to build the level, for Normal, Nightmare, and Hell Difficulty, respectively

SizeY - [N] - Specifies the Width tile size values of an entire area level, which are used for determining how to build the level, for Normal, Nightmare, and Hell Difficulty, respectively

OffsetX & OffsetY - [N] - Specifies the location offset coordinates (measured in tile size) for the origin point of the area level in the world. Must not overlap with other level offsets

Depend - [N] - Assigns another level to be this area level's depended level, which controls this area level's position and how it starts building its tiles. Uses the level ID field. If this equals 0, then ignore this

Teleport - [N] - Controls the functionality of the Sorceress Teleport skill and the Assassin Dragon Flight skill on the area level

Rain - [B] - If equals 1, then allow rain to play its effects on the area level. If the level is part of Act 5, then it will snow on the area level, instead of rain. If equals 0, then it will never rain on the area level

Mud - [B] - If equals 1, then random bubbles will animate on the tiles that are flagged as water tiles. If equals 0, then ignore this

NoPer - [B] - If equals 1, then allow the use of display option of Perspective Mode while the player is in the level. If equals 0, then disable the option of Perspective Mode and force the player to use Orthographic Mode while the player is in the level

LOSDraw - [B] - If equals 1, then the level will check the player's line of sight before drawing monsters. If equals 0, then ignore this

FloorFilter - [B] - If equals 1 and if the floor's layer in the area level equals 1, then draw the floor tiles with a linear texture sampler. If equals 0, then draw the floor tiles with a nearest texture sampler

BlankScreen - [B] - If equals 1, then draw the area level screen. If equals 0, then do not draw the area level screen, meaning that the level will be a blank screen

DrawEdges - [B] - If equals 1, then draw the areas in levels that are not covered by floor tiles. If equals 0, then ignore this

DrlgType - [N] - Determines the type of Dynamic Random Level Generation used for building and handling different elements of the area level. Uses the Code from the table below to handle which type of DRLG is used.

LevelType - [N] - Defines the Level Type used for this area level. Uses the ID field from LvlTypes.txt

SubType - [N] - Controls the group of tile substitutions for the area level (LvlSub.txt). There are defined sub-types to choose from, listed below.

SubTheme - [N] - Controls which theme number to use in a Level Substitution. The allowed values are 0 to 4, which convey which Prob0, Trials0, and Max0 field to use from the LvlSub.txt file. If this equals -1, then there is no sub theme for the area level

SubWaypoint - [N] - Controls the level substitutions for adding waypoints in the area level (LvlSub.txt). This uses a defined sub type to choose from and also depends on the room having a waypoint tile

SubShrine - [N] - Controls the level substitutions for adding Shrines in the area level (LvlSub.txt). This uses a defined sub type to choose from and also depends on the room allowing for a shrine to spawn

Vis0 - [N] - Defines the visibility of other area levels involved with this area level, allowing for travel functionalities between levels. This uses the ID field of another defined area level to link with this area level. If this equals 0, then no area level is specified

Warp0 - [N] - Uses the ID field from LvlWarp.txt, which defines which Level Warp to use when exiting the area level. This is connected with the definition of the related Vis0 field. If this equals -1, then no Level Warp is specified which should also mean that the related Vis0 field is not defined

Intensity - [N] - Controls the intensity value of the area level's ambient colors. This affects brightness of the room's RGB colors. Uses a value between 0 and 128. If all these related fields equal 0, then the game ignores setting the area level's ambient colors

Red - [N] - Controls the red value of the area level's ambient colors. Uses a value between 0 and 255

Green - [N] - Controls the green value of the area level's ambient colors. Uses a value between 0 and 255

Blue - [N] - Controls the blue value of the area level's ambient colors. Uses a value between 0 and 255

Portal - [B] - If equals 1, then this area level will be flagged as a portal level, which is saved in the player's information and can be used for keeping track of the player's portal functionalities. If equals 0, then ignore this

Position - [B] - If equals 1, then enable special casing for positioning the player on the area level. This can mean that the player could spawn on a different location on the area level, depending on the level room's position type. An example can be when the player spawns in a town when loading the game, or using a waypoint, or using a town portal. If equals 0, then ignore this

SaveMonsters - [B] - If equals 1, then the game will save the monsters in the area level, such as when all players leave the area level. If equals 0, then monsters will not be saved and will be removed. This is usually disabled for areas where monsters do not spawn

Quest - [N] - Controls what quest record is attached to monsters that spawn in this area level. This is used for specific quests handling lists of monsters in the area level. Referenced by the Code value of the Quest Flags Table

WarpDist - [N] - Defines the minimum pixel distance from a Level Warp that a monster is allowed to spawn near. Tile distance values are converted to game pixel distance values by multiplying the tile distance value by 160 / 32, where 160 is the width of pixels of a tile

MonLvl - [N] - Controls the overall monster level for the area level for Normal, Nightmare, and Hell Difficulty, respectively. This is for Classic mode only. This can affect the highest item level allowed to drop in this area level

MonLvlEx - [N] - Controls the overall monster level for the area level for Normal, Nightmare, and Hell Difficulty, respectively. This is for Expansion mode only. This can affect the highest item level allowed to drop in this area level

MonDen - [N] - Controls the monster density on the area level for Normal, Nightmare, and Hell Difficulty, respectively. This is a random value out of 100000, which will determine whether to spawn or not spawn a monster pack in the room of the area level. If this value equals 0, then no random monsters will populate on the area level

MonUMin - [N] - Defines the minimum number of Unique Monsters that can spawn in the area level for Normal, Nightmare, and Hell Difficulty, respectively. This field depends on the related MonDen fields being defined

MonUMax - [N] - Defines the maximum number of Unique Monsters that can spawn in the area level for Normal, Nightmare, and Hell Difficulty, respectively. This field depends on the related MonDen field being defined. Each room in the area level will attempt to spawn a Unique Monster with a 5/100 random chance, and this field's value will cap the number of successful attempts for the entire area level

MonWndr - [B] - If equals 1, then allow Wandering Monsters to spawn on this area level (WanderingMon.txt). This field depends on the related MonDen field being defined. If equals 0, then ignore this

MonSpcWalk - [N] - Defines a distance value, used to handle monster pathing AI when the level has certain pathing blockers, such as jail bars or rivers. In these cases, monsters will walk randomly until a player is located within this distance value or when the monsters find a possible path to target the player. If this equals 0, then ignore this field

NumMon - [N] - Controls the number of different monsters randomly spawn in the area level. The maximum value is 13. This controls the number of random selections from the 25 related mon1 and nmon1 fields or umon1 fields, depending on the game difficulty and monster type

mon1 - [O] - Defines which monsters can spawn on the area level for Normal Difficulty. Uses the monster ID field from MonStats.txt

rangedspawn - [B] - If equals 1, then for the first monster, try to pick a ranged type. If equals 0, then ignore this

nmon1 - [O] - Defines which monsters can spawn on the area level for Nightmare Difficulty and Hell Difficulty. Uses the monster ID field from MonStats.txt

umon1 - [O] - Defines which monsters can spawn as Unique monsters on this area level for Normal Difficulty. Uses the monster ID field from MonStats.txt

cmon1 - [O] - Defines which Critter monsters can spawn on the area level. Uses the monster ID field from MonStats.txtCritter monsters are determined by the critter field from MonStats2.txt

cpct1 - [N] - Controls the percent chance (out of 100) to spawn a Critter monster on the area level

camt1 - [N] - Controls the amount of Critter monsters to spawn on the area level after they succeeded their random spawn chance from the above cpct1 field

Themes - [N] - Controls the type of theme when building a level room. This value is a summation of possible values to build a bit mask for determining which themes to use when building a level room. For example, a value of 60 means that the area level can have the following themes: 32, 16, 8, 4.

SoundEnv - [N] - Uses the Index field from SoundEnviron.txt, which controls what music is played while the player is in the area level

Waypoint - [N] - Defines the unique numeric ID for the Waypoint in the area level. If this value is greater than or equal to 255, then ignore this field

LevelName - [O] - Used for displaying the name of the area level, such as when in the UI when the Automap is being viewed

LevelWarp - [O] - Used for displaying the entrance name of the area level on Level Warp tiles that link to this area level. For example, when the player mouse hovers over a tile to warp to the area level, then this string is displayed

LevelEntry - [O] - Used for displaying the UI popup title string when the player enters the area level

ObjGrp0 - [N] - Uses a numeric *ID Index to define which possible Object Groups to spawn in this area level (ObjGroup.txt). The game will go through each of these fields, so there can be more than 1 Object Group used in an area level. If this value equals 0, then ignore this

ObjPrb0 - [N] - Determines the random chance (out of 100) for each Object Group to spawn in the area level. This field depends on the related "ObjGrp#" field being defined

LevelGroup - [O] - Defines what group this level belongs to. Used for condensing level names in desecrated (terror) zones messaging. See LevelGroups.txt.

LvlMaze.txt

This file controls the sizes of the underground area levels. This file uses the levels from Levels.txt and specifies the sizes for each room, which can mean how many Level Presets to use to build out the entire randomly generated area.

Data Fields

Name - [O] - This is a reference field to describe the area level. IDeally this should match the name of the area level from the Levels.txt file

Level - [N] - This refers to the ID field from the Levels.txt file

Rooms - [N] - Controls the total number of rooms that a Level Maze will generate when playing the game in Normal Difficulty, Nightmare Difficulty, and Hell Difficulty, respectively

SizeX & SizeY - [N] - Controls the length and width sizes of each room (DS1 map files) that are added to the Level Maze. This is measured in tile sizes

Merge - [N] - This value affects the probability that a room gets an adjacent room linked next to it. This is a random chance out of 1000.

LvlPrest.txt

This file controls the values for each Level Preset. A Level Preset is a static area composed of tiles that is used to construct entire area levels found in the game.

Data Fields

Name - [O] - This is a reference field to define the Level Preset

Def - [N] - Defines the unique numeric ID for the Level Preset. This is referenced in other files

LevelID - [N] - This refers to the ID field from the Levels.txt file. If this value is not equal to 0, then this Level Preset is used to build that entire area level. If this value is equal to 0, then the Level Preset does not define the entire area level and is used as a part of constructing area levels

Populate - [B] - If equals 1, then units are allowed to spawn in the Level Preset. If equals 0, then units will never spawn in the Level Preset

Logicals - [B] - If equals 1, then the Level Preset allow for wall transparency to function. If equals 0, then walls will always appear solid

Outdoors - [B] - If equals 1, then the Level Preset will be classified as an outdoor area, which can mean that lighting will function differently. If equals 0, then the Level Preset will be classified as an indoor area

Animate - [B] - If equals 1, then the game will animate the tiles in the Level Preset. If equals 0, then ignore this

KillEdge - [B] - If equals 1, then the game will remove tiles that border the size of the Level Preset. If equals 0, then ignore this

FillBlanks - [B] - If equals 1, then all blank tiles in the Level Preset will be filled with unwalkable tiles. If equals 0, then ignore this

SizeX & SizeY - [N] - Specifies the Length and Width tile size values of the Level Preset, which are used for determining how big to build area levels. These values are equal to 0 for Level Presets that are static

AutoMap - [B] - If equals 1, then this Level Preset will be automatically completely revealed on the Automap. If equals 0, then this Level Preset will be hidden on the Automap and will need to be explored

Scan - [B] - If equals 1, then this Level Preset will allow the usage of warping with waypoints (This requires that the Level Preset has a waypoint object). If equals 0, then ignore this

Pops - [N] - Defines how many Pop tiles are defined in the Level Preset file. These Pop tiles are mainly used for controlling the roof and wall popping when a player enters a building in an area

PopPad - [N] - Determines the size of the Pop tile area, by using an offset value. This offset value can increase or decrease the size of the Pop tile size if it has a positive or negative value

Files - [N] - Determines the number of different versions to use for the Level Preset. This value acts as a range, which the game will use for randomly choosing one of the File1 fields to build the Level Preset. This is how the Level Presets have variety when the area level is being built

File1 - [O] - Specifies the name of which ds1 file to use. The ds1 files contain data for building Level Presets. If this value equals 0, then this field will be ignored. The number of these defined fields should match the value used in the "Files" field

Dt1Mask - [N] - This functions as a bit field mask with a size of a 32 bit value. This explains to the ds1 file which of the 32 dt1 tile files to use from a Level Type when assembling the Level Preset. Each File 1 field value from LevelTypes.txt is assigned a bit value, up to the 32 possible bit values. (For example: File1 = 1, File2=2, File3 = 4, File4=8, File5=16….File32 = 2147483648). To build the "Dt1Mask", you would add their associated bit values together for a total value. This total value is the bitmask value.

LvlSub.txt

This file controls how tiles can be substituted in for other tiles. The game will divide the level into clusters and iterate through these clusters to randomly substitute tiles with different ones for more visual diversity.

Data Fields

Name - [O] - This is a reference field to describe the Level Substitution

Type - [N] - This refers to the SubType field from the Levels.txt file. This defines a group that multiple substitutions can share

File - [O] - Specifies the name of which ds1 file to use. The ds1 files contain data for building Level Presets

CheckAll - [B] - If equals 1, then substitute each tile in the room. If equals 0, then substitute random tiles in the room.

BordType - [N] - This controls how often substituting tiles can work for border tiles

GridSize - [N] - Controls the tile size of a cluster for substituting tiles. This evenly affects both the X and Y size values of a room

Dt1Mask - [N] - This functions as a bit field mask with a size of a 32 bit value. This explains to the ds1 file which of the 32 dt1 tile files to use from a Level Type when assembling the Level Preset. Each File 1 field value from LevelTypes.txt is assigned a bit value, up to the 32 possible bit values. (For example: File1 = 1, File2=2, File3 = 4, File4=8, File5=16….File32 = 2147483648). To build the "Dt1Mask", you would add their associated bit values together for a total value. This total value is the bitmask value.

Prob0 - [N] - This value affects the probability that the tile substitution is used. This is a random chance out of 100. Which "Prob#" field that is checked depends on the SubTheme value from the Levels.txt file

Trials0 - [N] - Controls the number of times to randomly substitute tiles in a cluster. If this value equals -1, then the game will try to do as many tile substitutions that can be allowed based on the cluster and tile size. This field depends on the CheckAll field being equal to 0

Max0 - [N] - The maximum number of clusters of tiles to substitute randomly. This field depends on the CheckAll field being equal to 0.

LvlTypes.txt

This file controls which files containing tile graphics are used for creating maps. This looks at dt1 files, which contain tile images of the environments foundin the game. Each line in this file defines a Level Type and what files it uses.

The order of each Level Type defined in this file will convey what ID value it has, which is referenced by the following files: Levels.txt, LvlPrest.txt

The order of these Level Types should not be changed

Data Fields

Name - [O] - This is a reference field to define the name of each Level Type

ID - [N] - This is a reference field to define the index of each Level Type

File 1 - [O] - Specifies the name of which dt1 file to use. The dt1 files contain the images for each area tile found in each Act. If this value equals 0, then this field will be ignored

Act - [N] - Defines which Act is related to the Level Type. When loading an Act, the game will only use the Level Types associated with that Act number. Uses a decimal number to convey each Act number (Ex: A value of 3 means Act 3)

LvlWarp.txt

This file controls how the player is moved to different area levels, such as entrances and exits between different areas. This player transportation of between levels is defined as a Level Warp. Level Warps function as special tiles that are added to the area for controlling the location for where to transport the player.

This file is used by the Levels.txt file.

Data Fields

Name - [O] - This is a reference field to define the Level Warp

ID - [N] - Defines the numeric ID for the type of Level Warp. This ID can be shared between multiple Level Warps if those Level Warps want to use the same functionality. This is referenced in other files

SelectX & SelectY - [N] - These values define the horizontal and vertical offsets (respectively) of the starting left corner position of the Level Warp area. This is treated as the starting position to select the interactable Level Warp area in the area level. This value is measured in pixels

SelectDX & SelectDY - [N] - These values define the horizontal and vertical offsets (respectively) of the offset from the starting position of the Level Warp area. This is added with the SelectX & SelectY fields (respectively) to determine the overall size and position of the Level Warp in the area level. This value is measured in pixels

ExitWalkX & ExitWalkY - [N] - These values define the horizontal and vertical positions (respectively) of the destination location where the player will walk to after exiting to this Level Warp. This value is measured with a sub-tile offset from the base position of the Level Warp. One full tile on a level is composed of a grid of 5x5 sub-tiles

OffsetX & OffsetY - [N] - These values define the horizontal and vertical positions (respectively) of the sub-tile for the Level Warp, where the player will appear when exiting to this area level. This value is measured with a sub-tile offset from the base position of the Level Warp. One full tile on a level is composed of a grid of 5x5 sub-tiles

LitVersion - [B] - If equals 1, then Level Warp tiles will change their appearance when highlighted. If equals 0, then the Level Warp tiles will not change appearance when highlighted

Tiles - [N] - Defines an index offset to determine which tile to use in the tile set for the highlighted version of the Level Warp. These tiles are loaded and hidden/revealed when the player mouse hovers over the Level Warp tiles. This relies on LitVersion being enabled

NoInteract - [B] - If equals 1, then the Level War cannot be directly interacted by the player. If equals 0, then the player can interact with the Level Warp

Direction - [O] - Defines the orientation of the Level Warp. Uses a specific string code.

UniqueID - [N] - Defines the unique numeric ID for the Level Warp. Each Level Warp should have a unique ID so that the game can handle loading that specific Level Warp's related files.

MagicPrefix.txt, MagicSuffix.txt

These files control the possible magic stat modifiers applied as either a prefix or suffix to the item.

These item affixes will appear at the start or end of an item's name respectively

This file is loaded together with other similar files in the following order: magicsuffix.txt, magicprefix.txt, AutoMagic.txt

These stat modifiers may only appear on magical or higher quality items, excluding sets and uniques.

Data Fields

Name - [O] - Defines the item affix name

version - [N] - Defines which game version to use this item affix (<100 = Classic mode | 100 = Expansion mode)

spawnable - [B] - If equals 1, then this item affix is used as part of the game's randomizer for assigning item modifiers when an item spawns. If equals 0, then this item affix is never used

rare - [B] - If equals 1, then this item affix can be used when randomly assigning item modifiers when a rare item spawns. If equals 0, then this item affix is not used for rare items

level - [N] - The minimum item level required for this item affix to spawn on the item. If the item level is below this value, then the item affix will not spawn on the item

maxlevel - [N] - The maximum item level required for this item affix to spawn on the item. If the item level is above this value, then the item affix will not spawn on the item

levelreq - [N] - The minimum character level required to equip an item that has this item affix

classspecific - [O] - Controls if this item affix should only be used for class specific items. This relies on the Class specified from ItemTypes.txt, for the specific item. Referenced from the Code column in PlayerClass.txt

class - [O] - Controls which character class is required for the class specific level requirement (classlevelreq field). Referenced from the Code column in PlayerClass.txt

classlevelreq - [N] - The minimum character level required for a specific class in order to equip an item that has this item affix. This relies on the class specified. If equals null, then the class will default to using the levelreq field

frequency - [N] - Controls the probability that the affix appears on the item (a higher value means that the item affix will appear on the item more often). This value gets summed together with other "frequency" values from all possible item affixes that can spawn on the item, and then is used as a denominator value for the randomizer. Whichever item affix is randomly selected will be the one to appear on the item. The formula is calculated as the following: [Item Affix Selected] = ["frequency"] / [Total Frequency]. If the item has a magic level (from the "magic lvl" field in Weapons.txt/Armor.txt/Misc.txt) then the magic level value is multiplied with this value. If equals 0, then this item affix will never appear on an item

group - [N] - Assigns an item affix to a specific group number. Items cannot spawn with more than 1 item affix with the same group number. This is used to guarantee that certain item affixes do not overlap on the same item. If this field is null, then the group number will default to group 0

mod1code - [O] - Controls the item properties for the item affix (Uses the Code field from Properties.txt)

mod1param - [N] - The "parameter" value associated with the listed property (mod). Usage depends on the (Function ID field from Properties.txt)

mod1min - [N] - The "min" value to assign to the listed property (mod). Usage depends on the (Function ID field from Properties.txt)

mod1max - [N] - The "max" value to assign to the listed property (mod). Usage depends on the (Function ID field from Properties.txt)

transformcolor - [O] - Controls the color change of the item after spawning with this item affix. If empty, then the item affix will not change the item's color. Referenced from the Code column in Colors.txt

itype1 - [O] - Controls what Item Types are allowed to spawn with this item affix. Uses the Code field from ItemTypes.txt

etype1 - [O] - Controls what Item Types are excluded to spawn with this item affix. Uses the Code field from ItemTypes.txt

multiply - [N] - Multiplicative modifier for the item's buy and sell costs, based on the item affix (Calculated in 1024ths for buy cost and 4096ths for sell cost)

add - [N] - Flat integer modification to the item's buy and sell costs, based on the item affix

Missiles.txt

This file controls the different functions for all missiles and their statistics. Missiles are projectiles used throughout the game for attacks, skills, and special effects.

Data Fields

Missile - [O] - Defines the unique name ID for the missile, which is how other files can reference the missile. The order of defined missiles will determine their ID numbers, so they should not be reordered

pCltDoFunc - [N] - Uses an ID value from the below table, to select a function for the missile's behavior that will be active every frame on the client side. This is more about handling the local graphics while the missile is moving.

pCltHitFunc - [N] - Uses an ID value from the below table, to select a specialized function for the missile's behavior when hitting something on the client side. This is more about handling the local graphics at the moment of missile collision.

pSrvDoFunc - [N] - Uses an ID value from the below table, to select a specialized function for the missile's behavior while active every frame on the server side

pSrvHitFunc - [N] - Uses an ID value from the below table, to select a specialized function for the missile's behavior when hitting something on the server side

pSrvDmgFunc - [N] - Uses an ID value from the below table, to select a specialized function that gets called before damaging a unit on the server side

SrvCalc1 - [C] - Used as a parameter for the pSrvDoFunc field

Param1 - [N] - Used as a parameter for the pSrvDoFunc field

CltCalc1 - [C] - Used as a parameter for the pCltDoFunc field

CltParam1 - [N] - Used as a parameter for the pCltDoFunc field

SHitCalc1 - [C] - Used as a parameter for the pSrvHitFunc field

sHitPar1 - [N] - Used as a parameter for the pSrvHitFunc field

CHitCalc1 - [C] - Used as a parameter for the pCltHitFunc field

cHitPar1 - [N] - Used as a parameter for the pCltHitFunc field

DmgCalc1 - [C] - Used as a parameter for the pSrvDmgFunc field

dParam1 - [N] - Used as a parameter for the pSrvDmgFunc field

Vel - [N] - The baseline velocity of the missile, which is the speed at which the missile moves in the game world. This is measured by distance in pixels traveled per frame

MaxVel - [N] - The maximum velocity of the missile. If the missile's current velocity increases (based on other fields), then this field controls how high the velocity is allowed to go

VelLev - [N] - Adds extra velocity based on the caster unit's level. Each level gained beyond level 1 will add this value to the baseline Vel field

Accel - [N] - Controls the acceleration of the missile's movement. A positive value will increase the missile's velocity per frame. A negative value will decrease the missile's velocity per frame. The bigger positive or negative values will cause the velocity to change faster per frame

Range - [N] - Controls the baseline duration that the missile will exist for after it is created. This is measured in frames where 25 Frames = 1 second

LevRange - [N] - Adds extra duration based on the caster unit's level. Each level gained beyond level 1 will add this value to the baseline Range field

Light - [N] - Controls the missile's Light Radius size (measured in grid sub-tiles)

Flicker - [N] - If greater than 0, then every 4th frame while the missile is active, the Light Radius will randomly change in size between base size to its base size plus this value (measured in grid sub-tiles)

Red - [N] - Controls the red color value of the missile's Light Radius (Uses a value from 0 to 255)

Green - [N] - Controls the green color value of the monster's Light Radius (Uses a value from 0 to 255)

Blue - [N] - Controls the blue color value of the monster's Light Radius (Uses a value from 0 to 255)

InitSteps - [N] - The number of frames the missile needs to be alive until it becomes visible on the game client. If the missile's current duration in frame count is less than this value, then the missile will appear invisible

Activate - [N] - The number of frames the missile needs to be alive until it becomes active. If the missile's current duration in frame count is less than this value, then the missile will not collide

LoopAnim - [B] - If equals 1, then the missile's animation will repeat once the previous animation finishes. If equals 0, then the missile's animation will only play once, which can cause the missile to appear invisible at the end of the animation, but it will still be alive

CelFile - [O] - Defines which DCC missile file to use for the visual graphics of the missile

animrate - [N] - Controls the visual speed of the missile's animation graphics. The overall missile animation rate is calculated as the following: 256 * ["animrate"] / 1024

AnimLen - [N] - Defines the length of the missile's animation in frames where 25 Frames = 1 second. This field can sometimes be used to calculate the missile animation rate, depending on the missile function used

AnimSpeed - [N] - Controls the visual speed of the missile's animation graphics on the client side (Measured in 16ths, where 16 equals 1 frame per second). This can be overridden by certain missile functions

RandStart - [N] - If this value is greater than 0, then the missile will start at a random frame between 0 and this value when it begins its animation

SubLoop - [B] - If equals 1, then the missile will use a specific sequence of its animation while it is alive, depending on its creation. If equals 0, then the missile will not use a sequenced animation

SubStart - [N] - The starting frame of the sequence animation. This requires that the SubLoop field is enabled

SubStop - [N] - The ending frame of the sequence animation. After reaching this frame, then the sequenced animation will loop back to the SubStart frame. This requires that the SubLoop field is enabled

CollideType - [N] - Defines the missile's collision type, which controls what units, objects, or parts of the environment that the missile can impact

CollideKill - [B] - If equals 1, then the missile will be destroyed when it collides with something. If equals 0, then the missile will not be destroyed when it collides with something

CollideFriend - [B] - If equals 1, then the missile can collide with friendly units, including the caster. If equals 0, then the missile will ignore friendly units

LastCollide - [B] - If equals 1, then the missile will track the last unit that it collided with, which is useful for making sure the missile does not hit the same unit twice. If equals 0, then ignore this

Collision - [B] - If equals 1, then the missile will have a missile type path placement collision mask when it is initialized or moved. If equals 0, then the missile will have no placement collision mask when it is created or moved

ClientCol - [B] - If equals 1, then the missile will check collision on the client, depending on the missile's CollideType field. If equals 0, then ignore this

ClientSend - [B] - If equals 1, then the server will create the missile on the client. This can be used when reloading area levels or transitioning units between areas. If equals 0, then ignore this

NextHit - [B] - If equals 1, then the missile will use the next delay. If equals 0, then ignore this

NextDelay - [N] - Controls the delay in frame length until the missile is allowed to hit the same unit again. This field relies on the NextHit field being enabled

xoffset & yoffset & zoffset - [N] - Specifies the X, Y, and Z location coordinates (measured in pixels) to offset to visually draw the missile based on its actual location. This will only offset the visual graphics of the missile, not the missile itself. The Z axis controls the visual height of the missile

Size - [N] - Defines the diameter in sub-tiles (for both the X and Y axis) that the missile will occupy. This affects how the missile will collide with something or how the game will handle placement for the missile

SrcTown - [B] - If equals 1, then the missile will be destroyed if the caster unit is located in an act town. If equals 0, then ignore this

CltSrcTown - [N] - If this value is greater than 0 and the LoopAnim field is disabled, then this field will control which frame to set the missile's animation when the player is in town. This value gets subtracted from the AnimLen value to determine the frame to set the missile's animation.

CanDestroy - [B] - If equals 1, then the missile can be attacked and destroyed. If equals 0, then the missile cannot be attacked

ToHit - [B] - If equals 1, then this missile will use the caster's Attack Rating stat to determine if the missile should hit its target. If equals 0, then the missile will always hit its target

AlwaysExplode - [B] - If equals 1, then the missile will always process an explosion when it is killed, which can use the pSrvHitFunc, HitSound and ExplosionMissile fields on the client side. If equals 0, then the missile will only rely on proper collision hits to process an explosion

Explosion - [B] - If equals 1, then the missile will be classified as an explosion which will make it use different handlers for finding nearby units and dealing damage. If equals 0, then ignore this

Town - [B] - If equals 1, then the missile is allowed to be alive when in a town area. If equals 0, then the missile will be immediately destroyed when located within a town area

NoUniqueMod - [B] - If equals 1, then the missile will not receive bonuses from Unique monster modifiers. If equals 0, then the missile will receive bonuses from Unique monster modifiers

NoMultiShot - [B] - If equals 1, then the missile will not be affected by the Multi-Shot monster modifier. If equals 0, then the missile will be affected by theMulti-Shot monster modifier

Holy - [N] - Controls a bit field flag where each value is a code to allow the missile to damage a certain type of monster

CanSlow - [B] - If equals 1, then the missile can be affected by the "slowmissiles" state (States.txt). If equals 0, then the missile will ignore the "slowmissiles" state

ReturnFire - [B] - If equals 1, then missile can trigger the Sorceress Chilling Armor event function. If equals 0, then this missile will not trigger that function

GetHit - [B] - If equals 1, then the missile will cause the target unit to enter the Get Hit mode (GH), which acts as the hit recovery mode. If equals 0, then ignore this

SoftHit - [B] - If equals 1, then the missile will cause a soft hit on the unit, which can trigger a blood splatter effect, hit flash, and/or a hit sound. If equals 0, then ignore this

KnockBack - [N] - Controls the percentage chance (out of 100) that the target unit will be knocked back when hit by the missile

Trans - [N] - Controls the alpha mode for how the missile is displayed, which can affect transparency and blending

Pierce - [B] - If equals 1, then allow the Pierce modifier function to work with this missile. If equals 0, then do not allow Pierce to work with this missile

MissileSkill - [B] - If equals 1, then the missile will look up the skill that created it and use that skill's damage instead of the missile damage. If equals 0, then ignore this

Skill - [O] - Links to the "skill" field from the Skills.txt file. This will look up the specified skill's damage and use it for the missile instead of using the missile's defined damage

ResultFlags - [N] - Controls different flags that can affect how the target reacts after being hit by the missile. Uses an integer value to check against different bit fields by using the "&" operator. For example, if the value equals 5 (binary = 101) then that returns true for both the 4 (binary = 100) and 1 (binary = 1) bit field values. Referenced by the Bit Field Value of the Result Flags Table

HitFlags - [N] - Controls different flags that can affect the damage dealt when the target is hit by the missile. Uses an integer value to check against different bit fields by using the "&" operator. For example, if the value equals 6 (binary = 110) then that returns true for both the 4 (binary = 100) and 2 (binary = 10) bit field values. Referenced by the Bit Field Value of the Hit Flags Table

HitShift - [N] - Controls the percentage modifier for the missile's damage. This value cannot be less than 0 or greater than 8. This is calculated in 256ths, where 8=256/256, 7=128/256, 6=64/256, 5=32/256, 4=16/256, 3=8/256, 2=4/256, 1=2/256, and 0=1/256

ApplyMastery - [B] - If equals 1, then apply the caster's elemental mastery bonus modifiers to the missile's elemental damage. If equals 0, then ignore this

SrcDamage - [N] - Controls how much of the source unit's damage should be added to the missile's damage. This is calculated in 128ths and acts as a percentage modifier for the source unit's damage that added to the missile. If equals -1 or 0, then the source damage is not included

Half2HSrc - [B] - If equals 1 and the source unit is currently wielding a 2-Handed weapon, then the SrcDamage is reduced by 50%. If equals 0, then ignore this

SrcMissDmg - [N] - If the missile was created by another missile, then this controls how much of the source missile's damage should be added to this missile's damage. This is calculated in 128ths and acts as a percentage modifier for the source missile's damage that added to this missile. If equals 0, then the source damage is not included

MinDamage - [N] - Minimum baseline physical damage dealt by the missile

MinLevDam1 - [N] - Controls the additional minimum physical damage dealt by the missile, calculated using the leveling formula between 5 level thresholds of the missile's current level. The level thresholds are levels 2-8, 9-16, 17-22, 23-28, 29 and beyond. These 5 level thresholds correlate to each field

MaxDamage - [N] - Maximum baseline physical damage dealt by the missile

MaxLevDam1 - [N] - Controls the additional maximum physical damage dealt by the missile, calculated using the leveling formula between 5 level thresholds of the missile's current level. The level thresholds are levels 2-8, 9-16, 17-22, 23-28, 29 and beyond. These 5 level thresholds correlate to each field

DmgSymPerCalc - [C] - Determines the percentage increase to the physical damage dealt by the missile based on specified skill levels

EType - [O] - Defines the type of elemental damage dealt by the missile. If this field is empty, then the related elemental fields below will not be used. Referenced by the Code value of the Elemental Types Table

EMin - [N] - Minimum baseline elemental damage dealt by the missile

MinELev1 - [N] - Controls the additional minimum elemental damage dealt by the missile, calculated using the leveling formula between 5 level thresholds of the missile's current level. The level thresholds are levels 2-8, 9-16, 17-22, 23-28, 29 and beyond. These 5 level thresholds correlate to each field number

EMax - [N] - Maximum baseline elemental damage dealt by the missile

MaxELev1 - [N] - Controls the additional maximum elemental damage dealt by the missile, calculated using the leveling formula between 5 level thresholds of the missile's current level. The level thresholds are levels 2-8, 9-16, 17-22, 23-28, 29 and beyond. These 5 level thresholds correlate to each field

EDmgSymPerCalc - [C] - Determines the percentage increase to the elemental damage dealt by the missile based on specified skill levels

ELen - [N] - The baseline elemental duration dealt by the missile. This is calculated in frame lengths where 25 Frames = 1 second. These fields only apply to appropriate elemental types with a duration

ELevLen1 - [N] - Controls the additional elemental duration added by the missile, calculated using the leveling formula between 3 level thresholds of the missile's current level. The level thresholds are levels 2-8, 9-16, 17 and beyond. These 3 level thresholds correlate to each field. These fields only apply to appropriate elemental types with a duration

HitClass - [N] - Defines the missile's own hit class into the damage routines, mainly used for determining hit sound effects and overlays. This field only handles the hit class layers, so values beyond these defined bits are ignored. Uses an integer value to check against different bit fields by using the "&" operator. For example, if the value equals 6 (binary = 110) then that returns true for both the 4 (binary = 100) and 2 (binary = 10) bit field values.

NumDirections - [N] - The number of directions allowed by the missile, based on the DCC file used (CelFile). This value should be within the power of 2, with a minimum value of 1 or up to a maximum value of 64

LocalBlood - [B] - If equals 1, then change the color of blood missiles to green. If equals 0, then keep the blood missiles colored the default red

DamageRate - [N] - Controls the "damage_framerate" stat (Calculated in 1024ths), which acts as a percentage multiplier for the physical damage reduction and magic damage reduction stat modifiers, when performing damage resistance calculations. This is only enabled if the value is greater than 0

TravelSound - [O] - Points to a Sound field defined in the Sounds.txt file. Used when the missile is created and while it is alive

HitSound - [O] - Points to a Sound field defined in the Sounds.txt file. Used when the collides with a target

ProgSound - [O] - Points to a Sound field defined in the Sounds.txt file. Used for a programmed special event based on the client function

ProgOverlay - [O] - Points to the overlay field defined in the Overlay.txt file. Used for a programmed special event based on the server or client function

ExplosionMissile - [O] - Points to the Missile field for another missile. Used for the missile created on the client when this missile explodes

SubMissile1 - [O] - Points to the Missile field for another missile. Used for creating a new missile based on the server function used

HitSubMissile1 - [O] - Points to the Missile field for another missile. Used for a new missile after a collision, based on the server function used

CltSubMissile1 - [O] - Points to the Missile field for another missile. Used for creating a new missile based on the client function used

CltHitSubMissile1 - [O] - Points to the Missile field for another missile. Used for a new missile after a collision, based on the client function used.

MonEquip.txt

This file controls how a monster may be created with specific type of inventory equipment items

These equipment items are randomly generated on the monster, based on the specified parameters in this file

This data relies on the "inventory" field being enabled for the listed monster, found in the monstats.txt file

Data Fields

monster - [O] - Defines the monster that should be equipped. Points to the matching ID value in the MonStats.txt file. If the monster has multiple defined equipment possibilities, then they should always be grouped together. The game will go through the list in order to match what is best to use for the monster

oninit - [B] - Defines if the monster equipment is added on initialization during the monster's creation, depending how the monster is spawned. Monsters created by a skill have this value set to 0. Monsters created by a level have this value set to 1

level - [N] - Defines the level requirement for the monster in order to gain this equipment. The game will prefer the highest level allowed, so the order of these equipment should be from highest level to lowest level

item1 - [O] - Item code that can be equipped on the monster

loc1 - [O] - Specifies the inventory slot where the item will be equipped. Once an item is equipped on that body location, then the game will skip any duplicate calls to equipping the same body location. This is another reason why the equipment should be ordered from highest level to lowest level. Referenced from the Code column in BodyLocs.txt

mod1 - [N] - Controls the quality level of the related item

MonLvl.txt

This file controls how monster statistics increase per level based on the current game type and difficulty

The "(N)" text in field names signifies to use that specific value for games in Nightmare difficulty

The "(H)" text in field names signifies to use that specific value for games in Hell difficulty

This file is used by MonStats.txt for all of these values

Data Fields

Level - [N] - An integer value to determine how to scale the monster's statistics when at a specific level

The following are used for D2R Classic:

AC & AC(N) & AC(H) - [N] - Percentage multiplier for increasing the Monster's Defense (multiplies with the AC field)

TH & TH(N) & TH(H) - [N] - Percentage multiplier for increasing the Monster's Attack Rating (multiplies with the A1TH and A2TH fields)

HP & HP(N) & HP(H) - [N] - Percentage multiplier for increasing the Monster's Life (multiplies with the minHP and maxHP fields)

DM & DM(N) & DM(H) - [N] - Percentage multiplier for increasing the Monster's Damage (multiplies with the A1MinD, A1MaxD, A2MinD, A2MaxD, El1MinD and El1MaxD fields)

XP & XP(N) & XP(H) - [N] - Percentage multiplier for increasing the Experience provided to the player when killing the Monster (multiplies with the Exp fields)

The following are used for D2R Expansion:

L-AC & L-AC(N) & L-AC(H) - [N] - Percentage multiplier for increasing the Monster's Defense (multiplies with the AC field)

L-TH & L-TH(N) & L-TH(H) - [N] - Percentage multiplier for increasing the Monster's Attack Rating (multiplies with the A1TH and A2TH fields)

L-HP & L-HP(N) & L-HP(H) - [N] - Percentage multiplier for increasing the Monster's Life (multiplies with the minHP and maxHP fields)

L-DM & L-DM(N) & L-DM(H) - [N] - Percentage multiplier for increasing the Monster's Damage (multiplies with the A1MinD, A1MaxD, A2MinD, A2MaxD, El1MinD and El1MaxD fields)

L-XP & L-XP(N) & L-XP(H) - [N] - Percentage multiplier for increasing the Experience provided to the player when killing the Monster (multiplies with the Exp fields)

MonPreset.txt

This file controls which monsters are preloaded in a preset, based on the Act number

Data Fields

Act - [N] - Defines the Act number used for each Monster Preset. Uses values between 1 to 5

Place - [O] - Defines a Super Unique monster from SuperUniques.txt, a monster from MonStats.txt or a place from MonPlace.txt. This defines the Monster Preset which is used for preloading, such as during level transitions

MonProp.txt

This file controls special properties that can be added to a monster, based on the game difficulty

The "(N)" text in field names signifies to use that specific value for games in Nightmare difficulty

The "(H)" text in field names signifies to use that specific value for games in Hell difficulty

This file is used by the monstats.txt file

Data Fields

ID - [N] - Defines the monster that should gain the Property. Points to the matching "ID" value in the monstats.txt file

prop1 - [O] - Defines with Property to apply to the monster (Uses the "code field from Properties.txt)

chance1 - [N] - The percent chance that the related property (prop#) will be assigned. If this value equals 0, then the Property will always be applied

par1 - [N] - The "parameter" value associated with the related property (prop#). Usage depends on the (Function ID field from Properties.txt)

min1 - [N] - The "min" value to assign to the related property (prop#). Usage depends on the (Function ID field from Properties.txt)

max1 - [N] - The "max" value to assign to the related property (prop#). Usage depends on the (Function ID field from Properties.txt)

MonSeq.txt

This file controls the sequence table used for specifying events during certain animation frames, such as when using skills.

A sequence is divided into multiple lines in this file to define each frame in the animation and to determine which event to use during a specific frame.

Data Fields

sequence -[N] - Establishes the Monster Sequence index. An entire monster sequence can be composed of multiple sequence lines, which means that each line needs to have matching "sequence" fields and must be in contiguous order

mode - [O] - Defines which monster mode animation to use for the sequence. Referenced from the Code column in MonMode.txt

frame - [N] - The in-game frame number for the animation. For the first line in the sequence, this value will establish where the starting frame for the animation. These values should be in contiguous order for the sequence

dir - [N] - Defines the numeric animation direction that the frame use. Most animations have between 8 to 64 maximum directions

event - [N] - Defines what type of event will be used when the frame triggers

MonStats.txt

This file controls the main functionalities and statistics for every monster in the game. This includes enemy monsters, pets, and NPC units.

This file is connected to the MonStats2.txt file, so additional functionalities can be found in that file. This means that this file's number and order of entries should be identical with the MonStats2.txt file.

The "(N)" text in field names signifies to use that specific value for games in Nightmare difficulty

The "(H)" text in field names signifies to use that specific value for games in Hell difficulty

Data Fields

ID - [N] - Controls the unique name ID to define the monster

*hcIDx - [*] - This field is not read directly, but can be used as an index entry for the monsters.

BaseID - [O] - Points to the ID of another monster to define the monster's base type. This is to create groups of monsters which are considered the same type

NextInClass - [O] - Points to the ID of another monster to signify the next monster in the group of this monster's type. This is to continue the groups of monsters which are considered the same type. The order should be contiguous

TransLvl - [N] - Defines the color transform level to use for this monster, which affects what color palette that the monster will use

NameStr - [O] Used to define the monster's name, such as in the Life bar UI when it is being targeted

MonStatsEx - [O] - Controls a pointer to the ID from MonStats2.txt

MonProp - [O] - Points to the ID field from MonProp.txt. Used to add special modifiers to the monster

MonType - [O] - Points to the type field from MonType.txt. Used to handle the monster's classification

AI - [O] - Points to a type of AI script to use for the monster (MonAI.txt)

DescStr - [O] Used to add a string to appear as an additional description below the Life bar UI when the monster is being targeted

Code - [O] - Controls the token used for choosing the proper cells to display the monster's graphics

enabled - [B] - If equals 1, then this monster is allowed to spawn in the game. If equals 0, then this monster will never spawn in the game

rangedtype - [B] - If equals 1, then the monster will be classified as a ranged type. If equals 0, then the monster will be classified as a melee type

placespawn - [B] - If equals 1, then this monster will be treated as a spawner, so monsters that spawn can be initially placed within this monster. If equals 0, then ignore this

spawn - [O] - Points to the ID of another monster to control what kind of monster is spawned from this monster. This is only used if the placespawn field is enabled

spawnx & spawny - [N] - Controls the X & Y offsets for where another monster is displaced when being spawned by this monster

spawnmode - [O] - Defines the animation mode that the spawned monsters will be initiated with. Referenced from the Token column in MonMode.txt

minion1 - [O] - Points to the ID of another monster to control what kind of monster is spawned with this monster when it is spawned, like a monster pack. The minion1 field is also used for spawning a monster when this monster is killed while it has the SplEndDeath field enabled

SetBoss - [B] - If equals 1, then set the monster AI to use the Boss AI type, which can affect the monster's behaviors. If equals 0, then ignore this

BossXfer - [B] - If equals 1, then the monster's AI will transfer its boss recognition to another monster, which can affect the minion monster behaviors after this boss is killed. If equals 0, then ignore no boss AI will transfer and minion monsters will behave differently after the boss is killed. This field relies on the SetBoss field being enabled

PartyMin - [N] - The minimum number of minions that can spawn with this monster. Uses the minion1 fields. The actual number is a random value chosen between the "PartyMin" and "PartyMax" field values

PartyMax - [N] - The maximum number of minions that can spawn with this monster. Uses the minion1 fields. The actual number is a random value chosen between the "PartyMin" and "PartyMax" field values

MinGrp - [N] - The minimum number of duplicates of this monster that can spawn together. The actual number is a random value chosen between the "MinGrp" and "MaxGrp" field values

MaxGrp - [N] - The maximum number of duplicates of this monster that can spawn together. The actual number is a random value chosen between the "MinGrp" and "MaxGrp" field values

sparsePopulate - [N] - If this value is greater than 0, then it controls the percent chance that this monster does not spawn, and another monster will spawn in its place. (Out of 100)

Velocity - [N] - Determines the movement velocity of the monster, which can be the monster's baseline walk speed

Run - [N] - Determines the run speed of the monster as opposed to walk speed. This is only used if the monster has a Run mode

Rarity - [N] - Modifies the chance that this monster will be chosen to spawn in the area level. The higher the value is, then the more likely this monster will be chosen. This value acts as a numerator and a denominator. All "Rarity" values of possible monsters get summed together to give a total denominator, used for the random roll. For example, if there are 3 possible monsters that can spawn, and their "Rarity" values are 1, 2, 2, then their chances to be chosen are 1/5, 2/5, and 2/5 respectively. If this value equals 0, then this monster is never randomly selected to spawn in an area level

Level - [N] - Determines the monster's level. This value for Nightmare and Hell difficulty can be overridden by the area level's MonLvl or MonLvlEx values from Levels.txt, unless the monster's boss and noRatio fields are enabled

MonSound - [O] - Points to the ID field of a monster sound from MonSounds.txt. This is used to control the monsters assigned sounds, when the monster is spawned as a Normal monster

UMonSound - [O] - Points to the ID field of a monster sound from MonSounds.txt. This is used to control the monsters assigned sounds, when the monster is spawned as a Unique or Champion monster

threat - [N] - Controls the AI threat value of the monster which can affect the targeting priorities of enemy Ais for this monster. The higher this value is, then the more likely that enemy AI will target this monster

aidel - [N] - Controls the delay in frame length for how often the monster's AI will update its commands. A lower delay means that the monster will perform commands more often without as long of a pause in between

aidist - [N] - Controls the maximum distance (measured in tiles) between the monster and an enemy until the monster's AI becomes aggressive. If equals 0, then default to 35

aip1 - [N] - Defines numeric parameters used to control various functions of the monster's AI. These fields depend on which AI script is being used (MonAI.txt, and the AI field in MonStats.txt)

MissA1 - [O] - Points to the Missile field from Missiles.txt to determine which missile to use when the monster is in Attack 1 & Attack 2 mode

MissS1 - [O] - Points to the Missile field from Missiles.txt to determine which missile to use when the monster is in Skill 1 (to Skill 4) mode

MissC - [O] - Points to the Missile field from Missiles.txt to determine which missile to use when the monster is in Cast mode

MissSQ - [O] - Points to the Missile field from Missiles.txt to determine which missile to use when the monster is in Sequence mode

Align - [N] - Controls the monster's alignment, which determines if the monster will be an enemy, ally, or neutral party to the player.

isSpawn - [B] - If equals 1, then the monster is allowed to spawn in an area level. If equals 0, then the monster will not be spawned automatically in an area level

isMelee - [B] - If equals 1, then the monster is classified as a melee only type, which can affect its AI behaviors and what monster modifiers are allowed on the monster. If equals 0, then ignore this

npc - [B] - If equals 1, then the monster is classified as an NPC (Non-Playable Character), which can affect its AI behaviors and how the player treats this monster. If equals 0, then ignore this

interact - [B] - If equals 1, then the monster is interactable, meaning that the player can click on the monster to perform an interact command instead of attacking. If equals 0, then ignore this

inventory - [B] - If equals 1, then monster will have an inventory with randomly generated items, such as an NPC with shop items (if the interact field is enabled) or a summoned unit with random equipped items (MonEquip.txt). If equals 0, then ignore this

inTown - [B] - If equals 1, then the monster is allowed to be in town. If equals 0, then the monster is not allowed to be in town, which can affect or disable their AI or collision from entering towns

lUndead - [B] - If equals 1, then the monster is treated as a Low Undead, meaning that the monster is classified as an Undead type and can be resurrected by certain AI. If equals 0, then ignore this

hUndead - [B] - If equals 1, then the monster is treated as a High Undead, meaning that the monster is classified as an Undead type but cannot be resurrected by certain AI. If equals 0, then ignore this

demon - [B] - If equals 1, then the monster is classified as a Demon type. If equals 0, then ignore this

flying - [B] - If equals 1, then the monster is flagged as a flying type, which can affect its collision with the area level and how it is spawned. If equals 0, then ignore this

opendoors - [B] - If equals 1, then the monster will use its AI to open doors if necessary. If equals 0, then the monster cannot open doors and will treat doors as another type of collision

boss - [B] - If equals 1, then the monster is classified as a Boss type, which can affect boss related AI and functions. If equals 0, then ignore this

primeevil - [B] - If equals 1, then the monster is classified as a Prime Evil type, or an Act End boss, which can affect various skills, AI, and damage related functions. If equals 0, then ignore this

killable - [B] - If equals 1, then the monster can be killed, damage, and be put in a Death or Dead mode. If equals 0, then the monster cannot be damaged or killed

switchai - [B] - If equals 1, then monster's AI can switched, such as by the Assassin's Mind Blast ability. If equals 0, then the monster AI cannot be switched

noAura - [B] - If equals 1, then the monster cannot be affected by friendly auras. If equals 0, then the monster can be affected by friendly auras

nomultishot - [B] - If equals 1, then the monster is not allowed to spawn with the Multi-Shot unique monster modifier (MonUMod.txt). If equals 0, then ignore this

neverCount - [B] - If equals 1, then the monster is not counted on the list of the active monsters in the area, which affects spawning and saving functions. If equals 0, then the monster will be accounted for, and can be part of the active or inactive list functions

petIgnore - [B] - If equals 1, then pet AI scripts will ignore this monster (MonAI.txt). If equals 0, then pet AI will attack this monster

deathDmg - [B] - If equals 1, then the monster will explode on death. This has special cases for the "bonefetish1" and "siegebeast1" monster classes, otherwise the monster will use a general death damage function to damage nearby units based on the monster's health percentage. If equals 0, then ignore this

genericSpawn - [B] - If equals 1, the monster is flagged as a possible selection for the AI generic spawner function. There are defaults for using the If equals 0, then ignore this

zoo - [B] - If equals 1, then the monster will be flagged as a zoo type monster, which will give it the AI zoo behavior. If equals 0, then ignore this

CannotDesecrate - [B] - If equals 1, then the monster will not be able to be desecrated when inside a desecrated level. If equals 0, then ignore this

rightArmItemType - [O] - Determines what type of items the monster is allowed to hold in its right arm (ItemTypes.txt). A blank value means it can hold any item

leftArmItemType - [O] - Determines what type of items the monster is allowed to hold in its left arm (ItemTypes.txt). A blank value means it can hold any item

canNotUseTwoHandedItems - [B] - If equals 1, then the monster can not items marked as two handed (Weapons.txt)

SendSkills - [N] - Determines which of the monster's skill's level should be sent to the client. Uses a byte value, where the code tests each bit to determine which of the monster's skills to check

Skill1 - [O] - Points to the Skill field from Skills.txt file. This gives the monster the skill to use for Sk1Mode

Sk1mode - [O] - Determines the monster's animation mode when using the related skill. Outside of the standard animation mode inputs, the field can also point to a sequence from MonSeq.txt, which handles a specific set of frames to place a sequence animation. Referenced from the Code column in MonMode.txt

Sk1lvl - [N] - Controls the base skill level of the related skill on the monster

Drain - [N] - Controls the monster's overall Life and Mana steal percentage. This can also be affected by the LifeStealDivisor and ManaStealDivisor fields from DifficultyLevels.txt. If equals 0, then the monster will not have Life or Mana steal

coldeffect - [N] - Sets the percentage change in movement speed and attack rate when the monster if chilled by a cold effect. If this equals 0, then the monster will be immune to the cold effect

ResDm - [N] - Sets the monster's Physical Damage Resistance stat

ResMa - [N] - Sets the monster's Magic Resistance stat

ResFi - [N] - Sets the monster's Fire Resistance stat

ResLi - [N] - Sets the monster's Lightning Resistance stat

ResCo - [N] - Sets the monster's Cold Resistance stat

ResPo - [N] - Sets the monster's Poison Resistance stat

DamageRegen - [N] - Controls the monster's Life regeneration per frame. This is calculated based on the monster's maximum life: Regeneration Rate = (Life * "DamageRegen") / 16

SkillDamage - [N] - Points to a skill from the "skill" field in the Skills.txt file. This changes the monster's min physical damage, max physical damage, and Attack Rating to be based off the values from the linked skill and its current level from the monster's owner (usually the player who summoned the monster)

noRatio - [B] - If equals 1, then use this file's fields to determine the monster's baseline stats (minHP, maxHP, AC, Exp, A1MinD, A1MaxD, A1TH, A2MinD, A2MinD, A2TH, S1MinD, S1MaxD, S1TH). If equals 0, then use MonLvl.txt to determine the monster's baseline stats

ShieldBlockOverride - [N] - If equals 1, then the monster can block without a shield (the block chance stat will take effect even without a shield equipped). If equals 2, then the monster cannot block at all, even with a shield equipped. If equals 0, then ignore this

ToBlock - [N] - The monster's percent chance to block an attack

Crit - [N] - The percent chance for the monster to score a critical hit when attacking an enemy, which causes the attack to deal double damage

minHP - [N] - The monster's minimum amount of Life when spawned

maxHP - [N] - The monster's maximum amount of Life when spawned

AC - [N] - The monster's Defense value

Exp - [N] - The amount of Experience that is rewarded to the player when the monster is killed

A1MinD - [N] - The minimum damage dealt by the monster when it is using the Attack 1 (A1) animation mode

A1MaxD - [N] - The maximum damage dealt by the monster when it is using the Attack 1 (A1) animation mode

A1TH - [N] - The monster's Attack Rating when it is using the Attack 1 (A1) animation mode

A2MinD - [N] - The minimum damage dealt by the monster when it is using the Attack 2 (A2) animation mode

A2MaxD - [N] - The maximum damage dealt by the monster when it is using the Attack 2 (A2) animation mode

A2TH - [N] - The monster's Attack Rating when it is using the Attack 2 (A2) animation mode

S1MinD - [N] - The minimum damage dealt by the monster when it is using the Skill 1 (S1) animation mode

S1MaxD - [N] - The maximum damage dealt by the monster when it is using the Skill 1 (S1) animation mode

S1TH - [N] - The monster's Attack Rating when it is using the Skill 1 (S1) animation mode

El1Mode - [O] - Determines which animation mode will trigger an additional elemental damage type when used. Referenced from the Code column in MonMode.txt

El1Type - [O] - Defines the type of elemental damage. This field is used when El#Mode is not null. Referenced by the Code value of the Elemental Types Table

El1Pct - [N] - Controls the random percent chance (out of 100) that the monster will append the element damage to the attack. This field is used when El#Mode is not null

El1MinD - [N] - The minimum element damage applied to the attack. This field is used when El#Mode is not null

El1MaxD - [N] - The maximum element damage applied to the attack. This field is used when El#Mode is not null

El1Dur - [N] - Controls the duration of the related element mode in frame lengths (25 Frames = 1 Second). This is only applicable for the Cold, Poison, Stun, Burning, Freeze elements. There are special cases when evaluating the elements, where Poison min and max damage are multiplied by 10, and Poison duration is multiplied by 2. This field is used when El#Mode is not null

TreasureClass - [O] - Defines which Treasure Class is used by the monster when a Normal monster type is killed; for each difficulty respectively

TreasureClassChamp - [O] - Defines which Treasure Class is used by the monster when a Champion monster type is killed; for each difficulty respectively

TreasureClassUnique - [O] - Defines which Treasure Class is used by the monster when a Unique monster type is killed; for each difficulty respectively

TreasureClassQuest - [O] - Defines which Treasure Class is used by the monster when a Quest-Enabled monster type is killed; for each difficulty respectively. Based on the TCQuestID and TCQuestCP fields

TCQuestID - [N] - Checks to see if the player has does not have a quest flag progress. If not, then use the TreasureClassQuest field, based on the game's current difficulty. Referenced by the Code value of the Quest Flags Table

TCQuestCP - [N] - Controls which Quest Checkpoint, or current progress within a quest (based on the TCQuestID value), is needed to use the TreasureClassQuest field, based on the game's current difficulty

SplEndDeath - [N] - Controls a special case death handler for the monster that is ran on the server side

SplGetModeChart - [B] - If equals 1, then check special case handlers of certain monsters with specific BaseID fields while they are using certain a mode and perform a function. If equals 0, then ignore this.

SplEndGeneric - [B] - If equals 1, then check special case handlers of monsters with specific BaseID fields while they are ending certain modes and perform a function. If equals 0, then ignore this.

SplClientEnd - [B] - If equals 1, then on the client side, check special case handlers of monsters with specific BaseID fields while they are ending certain modes and perform a function. If equals 0, then ignore this.

MonStats2.txt

This file controls additional functionalities and statistics for every monster in the game.

Data Fields

ID - [O] - Controls the unique name ID to define the monster. This must match the same value in the monstats.txt file

Height - [N] - Determines the height of the monster. This has 2 purposes. The first purpose is to act as an index value for selecting which icebreak missile to use when the monster dies while frozen. The second purpose is to select a code which affects what attack animation the player characters will use when attacking the monster (Attack1 and or Attack2). See each code description types below.

OverlayHeight - [N] - Determines the height value of overlays (Overlay.txt) for the monster

pixHeight - [N] - Determines the pixel height value for the damage bar when the monster is selected

SizeX & SizeY - [N] - Determines the tile grid size of the monster which is use for handling placement when the monster spawns or uses movement skills

spawnCol - [N] - Controls the method for spawning the monster based on the collisions in the environment

MeleeRng - [N] - Controls the range of the monster's melee attack, which can affect also affect certain AI pathing. If this value equals 255, then refer to the monster's weapon class ("BaseW")

BaseW - [O] - Defines the monster's base weapon class, which can affect how the monster attacks. Referenced by the Code value of the Weapon Class Table

HitClass - [O] - Defines the specific class of an attack when the monster successfully hits with an attack. This can affect the sound and overlay display of the attack hit. Referenced from the Index value in HitClass.txt

The following are formula fields that define the types of visual graphics to use for the specific component field. Users can add input parameters by adding a comma "," to the input and using a code. For a list of possible component inputs, see the compcode.txt file

HDv - [O] - Head visual

TRv - [O] - Torso visual

LGv - [O] - Legs visual

RAv - [O] - Right Arm visual

LAv - [O] - Left Arm visual

RHv - [O] - Right Hand visual

LHv - [O] - Left Hand visual

SHv - [O] - Shield visual

S1v (to S8v) - [O] - Special 1 to Special 8 visual

The following fields are Boolean fields, which control which specific component piece is enabled for the monster. If equals 1, then the component is enabled. If equals 0, then the monster does not have that component.

HD - [B] - Head

TR - [B] - Torso

LG - [B] - Legs

RA - [B] - Right Arm

LA - [B] - Left Arm

RH - [B] - Right Hand

LH - [B] - Left Hand

SH - [B] - Shield

S1 - [B] - Special 1 to Special 8

TotalPieces - [N] - Defines the total amount of component pieces that the monster uses. This value should match the number of enabled Boolean fields listed above

mDT - [B] - If equals 1, then enable the Death Mode for the monster. If equals 0, then this mode is disabled

mNU - [B] - If equals 1, then enable the Neutral Mode for the monster. If equals 0, then this mode is disabled

mWL - [B] - If equals 1, then enable the Walk Mode for the monster. If equals 0, then this mode is disabled

mGH - [B] - If equals 1, then enable the Get Hit Mode for the monster. If equals 0, then this mode is disabled

mA1 - [B] - If equals 1, then enable the Attack 1 (and Attack 2) Mode for the monster. If equals 0, then this mode is disabled

mBL - [B] - If equals 1, then enable the Block Mode for the monster. If equals 0, then this mode is disabled

mSC - [B] - If equals 1, then enable the Cast Mode for the monster. If equals 0, then this mode is disabled

mS1 - [B] - If equals 1, then enable the Skill 1 (to Skill4) Mode for the monster. If equals 0, then this mode is disabled

mDD - [B] - If equals 1, then enable the Dead Mode for the monster. If equals 0, then this mode is disabled

mKB - [B] - If equals 1, then enable the Knockback Mode for the monster. If equals 0, then this mode is disabled

mSQ - [B] - If equals 1, then enable the Sequence Mode for the monster. If equals 0, then this mode is disabled

mRN - [B] - If equals 1, then enable the Run Mode for the monster. If equals 0, then this mode is disabled

dDT - [N] - Defines the number of directions that the monster can face during Death Mode

dNU - [N] - Defines the number of directions that the monster can face during Neutral Mode

dWL - [N] - Defines the number of directions that the monster can face during Walk Mode

dGH - [N] - Defines the number of directions that the monster can face during Get Hit Mode

dA1 - [N] - Defines the number of directions that the monster can face during Attack 1 (and Attack 2) Mode

dBL - [N] - Defines the number of directions that the monster can face during Block Mode

dSC - [N] - Defines the number of directions that the monster can face during Cast Mode

dS1 - [N] - Defines the number of directions that the monster can face during Skill 1 (to Skill 4) Mode

dDD - [N] - Defines the number of directions that the monster can face during Dead Mode

dKB - [N] - Defines the number of directions that the monster can face during Knockback Mode

dSQ - [N] - Defines the number of directions that the monster can face during Sequence Mode

dRN - [N] - Defines the number of directions that the monster can face during Run Mode

A1mv - [B] - If equals 1, then enable the Attack 1 (and Attack 2) Mode while the monster is moving with the Walk mode or Run mode. If equals 0, then this mode is disabled while the monster is moving

SCmv - [B] - If equals 1, then enable the Cast Mode while the monster is moving with the Walk mode or Run mode. If equals 0, then this mode is disabled while the monster is moving

S1mv - [B] - If equals 1, then enable the Skill 1 (to Skill 4) Mode while the monster is moving with the Walk mode or Run mode. If equals 0, then this mode is disabled while the monster is moving

noGfxHitTest - [B] - If equals 1, then enable the mouse selection bounding box functionality around the monster. If equals 0, then the monster cannot be selected by the mouse

htTop - [N] - Define the pixel top offset around the monster for the mouse selection bounding box functionality. This field relies on the noGfxHitTest field being enabled

htLeft - [N] - Define the pixel left offset around the monster for the mouse selection bounding box functionality. This field relies on the noGfxHitTest field being enabled

htWidth - [N] - Define the pixel right offset around the monster for the mouse selection bounding box functionality. This field relies on the noGfxHitTest field being enabled

htHeight - [N] - Define the pixel bottom offset around the monster for the mouse selection bounding box functionality. This field relies on the noGfxHitTest field being enabled

restore - [N] - Determines if the monster should be placed on the inactive list, to be saved when the level unloads. If equals 0, then do not save the monster. If equals 1, then rely on other checks to determine to save the monster. If equals 2, then force save the monster

automapCel - [N] - Controls what index of the Automap tiles to use to display this monster on the Automap. This field relies on the noMap field being disabled

noMap - [B] - If equals 1, then the monster will not appear on the Automap. If equals 0, then the monster will normally appear on the Automap

noOvly - [B] - If equals 1, then no looping overlays will be drawn on the monster. If equals 0, then overlays will be drawn on the monster. (Overlay.txt)

isSel - [B] - If equals 1, then the monster is selectable and can be targeted. If equals 0, then the monster cannot be selected

alSel - [B] - If equals 1, then the player can always select the monster, regardless of being an ally or enemy. If equals 0, then ignore this

noSel - [B] - If equals 1, then the player can never select the monster. If equals 0, then ignore this

shiftSel - [B] - If equals 1, then the player can target this monster when holding the Shift key and clicking to use a skill. If equals 0, then the monster cannot be targeted while the player is holding the Shift key

corpseSel - [B] - If equals 1, then the monster's corpse can be with the mouse cursor. If equals 0, then the monster's corpse cannot be selected with the mouse cursor

isAtt - [B] - If equals 1, then the monster can be attacked. If equals 0, then the monster cannot be attacked

revive - [B] - If equals 1, then the monster is allowed to be revived by the Necromancer Revive skill. If equals 0, then the monster cannot be revived by the Necromancer Revive skill

limitCorpses - [B] - If equals 1, then the monster's corpse will be placed into a pool with all other corpses with this field checked. Once that pool reaches the max (50), the corpses at the beginning of the pool start getting removed

critter - [B] - If equals 1, then the monster will be flagged as a critter, which gives some special case handling such as not creating impact sounds and differently handling its spawn placement in presets. If equals 0, then ignore this

small - [B] - If equals 1, then the monster will be classified as a small type, which can affect what types of missiles can be used on the monster (Example: Barbarian Grim Ward size) or how the monster is knocked back. If equals 0, then ignore this. If this field is enabled, then the large field should be disabled, to avoid confusion

large - [B] - If equals 1, then the monster will be classified as a large type, which can affect what types of missiles can be used on the monster (Example: Barbarian Grim Ward size) or how the monster is knocked back. If equals 0, then ignore this. If this field is enabled, then the small field should be disabled, to avoid confusion

soft - [B] - If equals 1, then the monster's corpse is classified as soft bodied, meaning that its corpse can be used by certain corpse skills such as Barbarian Find Potion, Find Item, or Grim Ward. If equals 0, then the monster's corpse cannot be used for these skills

inert - [B] - If equals 1, then the monster will never attack its enemies. If equals 0, then ignore this

objCol - [B] - If equals 1 and the monster class is "barricadedoor", "barricadedoor2", or "evilhut", then the monster will place an invisible object with collision. If equals 0, then ignore this

deadCol - [B] - If equals 1, then the monster's corpse will have collision with other units. If equals 0, then the monster's corpse will not have collision