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 values | mType |
UNKNOWN | 0 |
SYSTEM | 1 |
WEAPON | 2 |
ARMOR | 3 |
CHARM | 4 |
CONSUMABLE | 5 |
CONTAINER | 6 |
BASIC | 7 |
SPECIAL | 8 |
QUEST | 9 |
RECIPE | 10 |
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 |
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 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 values | mBindingType |
BIND_NEVER | 0 |
BIND_ON_PICKUP | 1 |
BIND_ON_EQUIP | 2 |
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 |
Rarity Name | Rarity Value | Health/Drop Multiplier |
Normal | 0 | 1 |
Heroic | 1 | 2.5 |
Epic | 2 | 5 |
Legendary | 3 | 10 |
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+ |
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 |
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 |
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 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. |