A listing of some commonly used tables and value mappings.

ItemDef mType
ItemDef mEquipType
ItemDef mArmorType
ItemDef mWeaponType
ItemDef mBindingType
ItemDef mIvType
CreatureDef Rarity
CreatureDef defHints
Equipped Item Slot Mapping
CreatureDef profession
CreatureDef stats
Status Effects

ItemDef mType

ItemDef files require the numerical values for the needed type.

ItemDef mType values mType
UNKNOWN 0
SYSTEM 1
WEAPON 2
ARMOR 3
CHARM 4
CONSUMABLE 5
CONTAINER 6
BASIC 7
SPECIAL 8
QUEST 9
RECIPE 10

ItemDef mEquipType

ItemDef files require the numerical values for the needed type.

Name Value
NONE 0
WEAPON_1H 1
WEAPON_1H_UNIQUE 2
WEAPON_1H_MAIN 3
WEAPON_1H_OFF 4
WEAPON_2H 5
WEAPON_RANGED 6
ARMOR_SHIELD 7
ARMOR_HEAD 8
ARMOR_NECK 9
ARMOR_SHOULDER 10
ARMOR_CHEST 11
ARMOR_ARMS 12
ARMOR_HANDS 13
ARMOR_WAIST 14
ARMOR_LEGS 15
ARMOR_FEET 16
ARMOR_RING 17
ARMOR_RING_UNIQUE 18
ARMOR_AMULET 19
FOCUS_FIRE 20
FOCUS_FROST 21
FOCUS_MYSTIC 22
FOCUS_DEATH 23
CONTAINER 24
COSEMETIC_SHOULDER 25
COSEMETIC_HIP 26
RED_CHARM 27
GREEN_CHARM 28
BLUE_CHARM 29
ORANGE_CHARM 30
YELLOW_CHARM 31
PURPLE_CHARM 32

ItemDef mArmorType

ItemDef files require the numerical values for the needed type.

These values are mostly obsolete. The value for shields is still important though.

ItemDef mArmorType values mArmorType
NONE 0
CLOTH 1
LIGHT 2
MEDIUM 3
HEAVY 4
SHIELD 5

ItemDef mWeaponType

ItemDef files require the numerical values for the needed type.

ItemDef mWeaponType values mWeaponType
NONE 0
SMALL 1
ONE_HAND 2
TWO_HAND 3
POLE 4
WAND 5
BOW 6
THROWN 7
ARCANE_TOTEM 8

ItemDef mBindingType

ItemDef files require the numerical values for the needed type.
ItemDef mBindingType values mBindingType
BIND_NEVER 0
BIND_ON_PICKUP 1
BIND_ON_EQUIP 2

ItemDef mIvType

ItemDef files require the numerical values for the needed type.

Name Values
NONE 0
STACKING 1
DURABILITY 2
CHARGES 3
CAPACITY 4
QUEST_ID 5
RESULT_ITEM 6
KEY_COMPONENT 7
REQUIRE_ROLLING 8
LIFETIME 9
BONUS_VALUE 10

CreatureDef Rarity

CreatureDef files require the numerical values for the needed type.
Rarity Name Rarity Value Health/Drop Multiplier
Normal 0 1
Heroic 1 2.5
Epic 2 5
Legendary 3 10

CreatureDef defHints

CreatureDef files require the numerical values for the needed type.

Multiple flags can be combined by adding their values together.

Name Bit Mask Value Notes
CDEF_HINT_PERSONA 1 Player characters only.
CDEF_HINT_COPPER_SHOPKEEPER 2 Standard vendor minimap icons and interacts.
CDEF_HINT_CREDIT_SHOPKEEPER 4 Doesn't seem to be used.
CDEF_HINT_ESSENCE_VENDOR 8 All chests which trade tokens or essences for loot.
CDEF_HINT_QUEST_GIVER 16 Must be set on any NPCs that give quests, otherwise the icon won't show. Keep this in mind if making quests for new NPCs.
CDEF_HINT_QUEST_ENDER 32 It's used, but not sure if technically needed.
CDEF_HINT_CRAFTER 64 For crafting of weapon/armor plans. See the TRANSFORMER status effect for refashioners.
CDEF_HINT_CLANREGISTRAR 128 Clans are currently not implemented.
CDEF_HINT_VAULT 256 Item vault. Definition present from 0.8.6+
CDEF_HINT_CREDIT_SHOP 512 Not used in the official creature list. Definition present from 0.8.6+

Equipped Item Slot Mapping

For equipped items, these are the slot numbers they occupy.

Character Equipped Item Slots Value
NONE -1
WEAPON_MAIN_HAND 0
WEAPON_OFF_HAND 1
WEAPON_RANGED 2
ARMOR_HEAD 3
ARMOR_NECK 4
ARMOR_SHOULDER 5
ARMOR_CHEST 6
ARMOR_ARMS 7
ARMOR_HANDS 8
ARMOR_WAIST 9
ARMOR_LEGS 10
ARMOR_FEET 11
ARMOR_RING_L 12
ARMOR_RING_R 13
ARMOR_AMULET 14
FOCUS_FIRE 15
FOCUS_FROST 16
FOCUS_MYSTIC 17
FOCUS_DEATH 18
CONTAINER_0 19
CONTAINER_1 20
CONTAINER_2 21
CONTAINER_3 22
COSMETIC_SHOULDER_L 23
COSMETIC_HIP_L 24
COSMETIC_SHOULDER_R 25
COSMETIC_HIP_R 26
RED_CHARM 27
GREEN_CHARM 28
BLUE_CHARM 29
ORANGE_CHARM 30
YELLOW_CHARM 31
PURPLE_CHARM 32

CreatureDef profession

CreatureDef files require the numerical values for the needed type.

This is mainly only relevant for players to determine their class. Mobs technically don't have a class, nor do they need them. The abilities they use are determined by their AI scripts and their abilities are not restricted by class.

Profession CreatureDef profession
None 0
Knight 1
Rogue 2
Mage 3
Druid 4
Monster 5

CreatureDef stats

The following table lists all the stat properties that exist in game, and their data types. Not all properties are used. Most of them are self explanatory, but have descriptions to help with other information.

Some stats are modified by abilities, and have example abilities provided. By examining the ability table you can read the descriptions and see how the stats are used, since they vary in quantity. For example, a raw stat value of 10 might translate to 10% effect for one ability, or 1% for another.

Data types:

Stat Data Type Label Notes
appearance string Appearance All body parameters for players and NPCs (include race and gender if applicable), or assets for interact props.
eq_appearance string Equipment Appearance This is only present on characters with equipped items. Maps an item ID to an equipped slot. If this field is present, clothing and attachments in the appearance field above may be ignored.
level short Level
display_name string[64] Display Name
strength short Strength
dexterity short Dexterity
constitution short Constitution
psyche short Psyche
spirit short Spirit
armor_rating short Armor Rating Not used.
melee_attack_speed short Melee Attack Speed Autoattack speed modifier. See abilities like Haste and Concussion. 100 units = 10% speed.
magic_attack_speed short Magic Attack Speed Casting speed modifier. See abilities like Arcane Acceleration and Concussion. 100 units = 10%.
base_damage_melee short Melee Damage Added damage for autoattacks. Used to simulate weapon damage for NPCs.
base_damage_fire short Fire Damage Added damage for autoattacks. See the Blazing ability.
base_damage_frost short Frost Damage Added damage for autoattacks. See the Frozen ability.
base_damage_mystic short Mystic Damage Added damage for autoattacks. See the Mystical ability.
base_damage_death short Death Damage Added damage for autoattacks. See the Deathly ability.
damage_resist_melee short Melee Defense Rating Armor against physical damage.
damage_resist_fire short Fire Defense Rating Armor against fire damage.
damage_resist_frost short Frost Defense Rating Armor against frost damage.
damage_resist_mystic short Mystic Defense Rating Armor against mystic damage.
damage_resist_death short Death Defense Rating Armor against death damage.
base_movement short Movement Not used.
base_luck short Luck Auto adjusted whenever heroism changes. Ranges from 0 to 500.
base_health short Health Bonus to health. See the Vigor of Sargon ability.
will_max short Willpower Max Not used.
will_regen float Willpower Regen Regeneration rate for Will. 1.0 = 100% (normal) speed. See the Wolf Spirit or Shadow Spirit abilities.
might_max short Might Max Not used.
might_regen float Might Regen Regeneration rate for Might. 1.0 = 100% (normal) speed. See the Wolf Spirit or Shadow Spirit abilities.
base_dodge short Dodge Dodge chance. 10 units = 1% chance. See the Elusiveness, Untouchable abilities.
base_deflect short Deflect Not used.
base_parry short Parry Parry chance. 10 units = 1% chance. See the Impenetrable ability.
base_block short Blocking Block chance. 10 units = 1% chance. See the Shield Mastery ability.
base_melee_to_hit short Melee To-Hit Not used.
base_melee_critical short Melee Critical Not used.
base_magic_success short Magic Success Not used.
base_magic_critical short Magic Critical Not used.
offhand_weapon_damage short Off-Hand Weapon Damage Offhand mastery. 10 units = 1%. Default is 500 (50%). See the Balance ability.
casting_setback_chance short Casting Setback Chance Chance that casting will be set back when taking damage. 10 units = 1%. Default is 500 (50%). See the Concentration ability.
channeling_break_chance short Channeling Break Chance Chance that channels will be interrupted when taking damage. 10 units = 1%. Default is 500 (50%). See the Discipline ability.
base_healing short Healing Multiplier to healing spells. 10 units = 1%. See the Healing Specialization ability.
aggro_radius_mod short Aggro Radius Not used.
hate_gain_rate short Hatred Gain Rate Bonus to hate generated by attacks. 1 unit = 1%. See the Turtle, Hit Me abilities.
experience_gain_rate short XP Gain Rate Bonus to experience generated to players on a mob kill. 1 unit = 1%.
coin_gain_rate short Coin Gain Rate Not used.
magic_loot_drop_rate short Magical Item Drops Bonus drop chance for randomized items. 1 unit = 1%.
inventory_capacity short Inventory Capacity Not used.
vis_weapon short Visible Weapon Determines which weapon is visible. Affects client animations only. Must have a valid eq_appearanc. Typically only used by players. Possible values: {0, 1, 2}
sub_name string[64] Sub Name The title or clan name subtext.
alternate_idle_anim string[32] Idle Animation Not used.
selective_eq_override string[32] Selective Equipment Override Not used.
health short Health Only accepts values from 0 to 32767. Negative values are interpreted as death and cause interaction problems in the client.

NOTE: If using a Planet Forever modified client, and if UseIntegerHealth=1 (in ServerConfig.txt) then this will be interpreted as an integer (accepts values from 0 to 2147483647)

will short Will Current Will (0 to 10).
will_charges short Will Charges Current Will Charges (0 to 5).
might short Might Current Might (0 to 10).
might_charges short Might Charges Current Might Charges (0 to 5).
size short Size Not used.
profession short Profession Character class (0=None, 1=Knight, 2=Rogue, 3=Mage, 4=Druid, 5=Mob). Only used by players for ability trees and base stats for level.
weapon_damage_2h short Weapon Damage: Two-Handed Weapon specialization. 10 units = 1%. See the Two Hand Weapon Specialization ability.
weapon_damage_1h short Weapon Damage: One-Handed Weapon specialization. 10 units = 1%. See the One Hand Weapon Specialization ability.
weapon_damage_pole short Weapon Damage: Pole Weapon specialization. 10 units = 1%. See the Pole Weapon Specialization ability.
weapon_damage_small short Weapon Damage: Small Weapon specialization. 10 units = 1%. See the Small Weapon Specialization ability.
weapon_damage_bow short Weapon Damage: Bow Weapon specialization. 10 units = 1%. See the Bow Weapon Specialization ability.
weapon_damage_thrown short Weapon Damage: Thrown Weapon specialization. 10 units = 1%. See the Thrown Weapon Specialization ability.
weapon_damage_wand short Weapon Damage: Wand Weapon specialization. 10 units = 1%. See the Wand Weapon Specialization ability.
extra_damage_fire short Extra Damage: Fire Not used.
extra_damage_frost short Extra Damage: Frost Not used.
extra_damage_mystic short Extra Damage: Mystic Not used.
extra_damage_death short Extra Damage: Death Not used.
appearance_override string Appearance Override Replaces the mob appearance. Only used by the loot system to turn mobs into tombstones or loot bags/chests.
invisibility_distance float Invisibility Distance Remaining travel distance until invisibility effects expire. 10 units = 1 meter.
translocate_destination string Translocate Destination The location name in the Portal: Bind ability tooltip. Information only. Actual bind location data is stored separately in player character files.
lootable_player_ids string Lootable Player ID's Generated by the server on loot generation. A comma separated list of player creature definition IDs that may loot a corpse.
master short Master Not used.
rez_pending short Pending Resurrection Offer Not used.
loot_seeable_player_ids string Loot Seeable Player ID's Generated by the server on loot generation. A comma separated list of player creature definition IDs that may see a loot bag/chest on a corpse. Everyone else sees a tombstone.
loot string[64] Loot Not used.
base_stats string[64] Base Stats A comma separated list of 5 integer values (Str,Dex,Con,Psy,Spi) derived from class and level. Automatically generated by the server. Only used for players.
health_mod short Health Mod Additional bonus health provided by heroism.
heroism short Heroism Main heroism stat. Ranges from 0 to 1000. base_luck is calculated directly from this by dividing it by 2.
experience int Experience Points Total cumulative experience points gained throughout the player's career.
total_ability_points short Total Ability Points Total ability points, calculated by level and event reward points.
current_ability_points short Current Ability Points Unused ability points to allocate to available skills.
copper int Copper Coin. Vendor currency.
credits int Credits Credit shop currency.
ai_module string[64] AI Module Not used.
creature_category string[32] Creature Category Only used by the client. Determines the icon portrait used in the target bar when selecting the object, and minimap dot colors in version 0.8.6 and earlier. Animal, Demon, Divine, Dragonkin, Elemental, Magical, Mortal, Unliving Available types: Animal, Demon, Divine, Dragonkin, Elemental, Magical, Mortal, Unliving
rarity short Rarity Creature rarity. Controls maximum health and rarity icon color. (0=Normal, 1=Heroic, 2=Epic, 3=Legendary)
spawn_table_points short Spawn Table Points Not used.
ai_package string[64] AI Package The AI script name to use. Scripts must be present in the AIScript folder and the script list file.
bonus_health short Bonus Health Damage shield points. See the Frost Shield ability.
dr_mod_melee int Melee Damage Reduction Multiplier to physical defense when calculating final damage reductions. 10 units = 1%. See the Berserk and Turtle abilities.
dr_mod_fire int Fire Damage Reduction Multiplier to fire defense when calculating final damage reductions. 10 units = 1%. See the Berserk and Turtle abilities.
dr_mod_frost int Frost Damage Reduction Multiplier to frost defense when calculating final damage reductions. 10 units = 1%. See the Berserk and Turtle abilities.
dr_mod_mystic int Mystic Damage Reduction Multiplier to mystic defense when calculating final damage reductions. 10 units = 1%. See the Berserk and Turtle abilities.
dr_mod_death int Death Damage Reduction Multiplier to death defense when calculating final damage reductions. 10 units = 1%. See the Berserk and Turtle abilities.
dmg_mod_melee int Melee Damage Modifier Multiplier to outgoing physical damage. 10 units = 1%. See the Turtle, Berserk, and Overstrike abilities.
dmg_mod_fire int Fire Damage Modifier Multiplier to outgoing fire damage. 10 units = 1%. See the Fire Specialization ability.
dmg_mod_frost int Frost Damage Modifier Multiplier to outgoing frost damage. 10 units = 1%. See the Frost Specialization ability.
dmg_mod_mystic int Mystic Damage Modifier Multiplier to outgoing mystic damage. 10 units = 1%. See the Mystic Specialization ability.
dmg_mod_death int Death Damage Modifier Multiplier to outgoing death damage. 10 units = 1%. See the Death Specialization ability.
pvp_team short PvP Team PvP is not properly supported in the server. In the client this appears to control the team color. (0=None, 1=Red, 2=Blue, 3=Yellow, 4=Green)
pvp_kills int PvP Kills Not used by the server. Used in the client PvP score screen.
pvp_deaths int PvP Deaths Not used by the server. Used in the client PvP score screen.
pvp_state string[32] PvP State Not used by the server. Unknown or unused in the client.
pvp_flag_captures integer PvP Flag Captures Not used by the server. Used in the client PvP score screen.
mod_melee_to_hit float Mod Melee To Hit Not used.
mod_melee_to_crit float Mod Melee To Crit The server computes this value as an additive for critical chance on physical damage. 10 units = 1%. The original devs probably intended this to be computed a different way.
mod_magic_to_hit float Mod Magic To Hit Not used.
mod_magic_to_crit float Mod Magic To Crit The server computes this value as an additive for critical chance on elemental damage. 10 units = 1%. The original devs probably intended this to be computed a different way.
mod_parry float Mod Parry Not used.
mod_block float Mod Block Not used.
mod_movement int Mod Movement Additive bonus to movement speed percent. 1 unit = 1% speed. See the Bounder Dash ability.
mod_health_regen float Mod Health Regen The server uses this as a flat additive bonus to health regeneration. The original devs seemed to imagine this stat as a percentage multiplier in the outdated/abandoned stat panel.
mod_attack_speed float Mod Attack Speed Not used by the server. Default is set to the minimum a floating point value can hold. Seems to be used in client legacy calculations of DPS. to perform certain calculations correctly. (1.4013e-045)
mod_casting_speed float Mod Casting Speed Not used by the server. Default is set to the minimum a floating point value can hold. Seems to be used in client legacy calculations of DPS. to perform certain calculations correctly. (1.4013e-045)
mod_healing float Mod Healing Not used by the server. Seems to be used in client legacy calculations of DPS. to perform certain calculations correctly. (1.4013e-045)
total_size float Total Size Additional radius for distance checks. This allows players to hit physically large mobs like Grimfrost from further away. Mobs have an enforced minimum size of 5 units (half a meter) and cannot be lower. Presently this value is for combat distance checks.
aggro_players short Aggro Players If set to 0, the creature's name-board is set to a neutral color. If set to 1, it is red. If not present (important for player characters) is it white.
mod_luck float Mod Luck Percentage modifier to luck. 1 unit = 1%. See the Lady Luck ability.
health_regen short Health Regen Not used.
bleeding short Bleeding Not used.
damage_shield int Damage Shield Damage reflect. See the Reflective Ward ability.
hide_nameboard short Hide Nameboard Not sure which client version started using this. The server sets to 1 while objects are dead.
hide_minimap short Hide Minimap Exists in clients later than 0.8.6. If nonzero, the minimap dot is not drawn for this creature.

Status Effects

Status Effect Notes
DEAD Not alive.
SILENCE Cannot cast spells.
DISARM Cannot use physical damage abilities.
STUN Cannot use any abilities. Mobs won't move, but players can since client 0.8.6 does not restrict movement.
DAZE Cannot use any abilities. Status is removed if attacked.
CHARM Not used.
FEAR Not used.
ROOT Cannot move.
LOCKED Not used.
BROKEN Not used.
CAN_USE_WEAPON_2H Not used server side, uses class check instead.
CAN_USE_WEAPON_1H Not used server side, uses class check instead.
CAN_USE_WEAPON_SMALL Not used server side, uses class check instead.
CAN_USE_WEAPON_POLE Not used server side, uses class check instead.
CAN_USE_WEAPON_BOW Not used server side, uses class check instead.
CAN_USE_WEAPON_THROWN Not used server side, uses class check instead.
CAN_USE_WEAPON_WAND Not used server side, uses class check instead.
CAN_USE_DUAL_WIELD
CAN_USE_PARRY
CAN_USE_BLOCK
CAN_USE_ARMOR_CLOTH Not used.
CAN_USE_ARMOR_LIGHT Not used.
CAN_USE_ARMOR_MEDIUM Not used.
CAN_USE_ARMOR_HEAVY Not used.
INVISIBLE Mage invisibility is active.
ALL_SEEING Not used.
IN_COMBAT_STAND Shows idle combat stance.
INVINCIBLE Nameboard shows green in the client. Cannot be attacked.
FLEE Not used.
NO_AGGRO_GAINED Not used.
UNATTACKABLE Nameboard shows green in the client. Cannot be attacked.
IS_USABLE Requests usability status from the server.
CLIENT_LOADING Not used.
IMMUNE_INTERRUPT Not used.
IMMUNE_SILENCE Not used.
IMMUNE_DISARM Not used.
IMMUNE_BLEED Not used.
IMMUNE_DAMAGE_FIRE Not used.
IMMUNE_DAMAGE_FROST Not used.
IMMUNE_DAMAGE_MYSTIC Not used.
IMMUNE_DAMAGE_DEATH Not used.
IMMUNE_DAMAGE_MELEE Not used.
DISABLED Not used.
AUTO_ATTACK Melee autoattack enabled.
AUTO_ATTACK_RANGED Ranged autoattack enabled.
CARRYING_RED_FLAG Not implemented.
CARRYING_BLUE_FLAG Not implemented.
HENGE Henge destination selection interact.
TRANSFORMER Refashioner.
PVPABLE Can target in PvP. Must be mutual.
IN_COMBAT Considered in combat. Can't interact with objects, regenerates health slower.
WALK_IN_SHADOWS Rogue Walk in Shadows is active.
EVADE Not used.
TAUNTED Not used.
XP_BOOST Not implemented.
REAGENT_GENERATOR Not implemented.
RES_PENALTY Not used.
IMMUNE_STUN Not used.
IMMUNE_DAZE Not used.
GM_FROZEN Not implemented.
GM_INVISIBLE Administrative invisibility. There will be no login or friend list notification broadcasted to other players. Also hidden from the /who command.

NOTE: Some actions may reveal you to other players since they broadcast updates locally to nearby players regardless of invisibility status. These include zone placement (from logging in, changing zones, or entering instances), using skills, or using commands that update the player's position or stats (and in turn broadcast those changes). Revealed characters will disappear from the screens of other players if enough time passes. The client erases inactive characters from view after 30 seconds.

GM_SILENCED Not implemented.