Monster defense

From Kolmafia
Jump to navigation Jump to search

Function Syntax

int monster_defense()

int monster_defense(monster check_me )

  • check_me is the (optional) monster to get the defense value of

Returns the defense value of the specified monster check_me. If check_me is not specified, it will use the current monster if you are in a fight (i.e. you're calling the function from an In-combat Consulting script), or the last monster you encountered otherwise.

When the function is given a monster as a parameter it will return the monster's defense at the start of a fight including all monster level modifications. This means that for monsters with unknown defense, the return value will be equivalent to monster_level_adjustment(). If the zero parameter version is called and the character is currently in a fight, then the function will include all current combat deleveling modifiers from the current combat.

If you want to know the monster's raw defense without being modified by monster level adjustments, it is available through the monster.raw_defense proxy field.

Code Samples

Following is an example of a function that determines your chance to hit a monster based on its defense.

void hitcheck(string monstername) {
   float fumble;
   int def = monster_defense(to_monster(monstername));
   int weaponstat = buffed_hit_stat();
   int basehitchance = weaponstat-def;
   if (basehitchance <= -6)
      print("You will always miss "+monstername+".", "red");
   else if (basehitchance >= 5) {
      if (numeric_modifier("fumble") > 0)
         fumble = 100-4.545*numeric_modifier("fumble");
      else fumble = 100-4.545;
      print("You will always hit, except for fumbles (Hit "+fumble+"% of the time)", "green");
   else {
      float hitchance;
      if (numeric_modifier("fumble") > 0)
         hitchance = (6.0+weaponstat-def)/11*(100-4.545*numeric_modifier("fumble"));
      else hitchance = ((6.0+weaponstat-def)/11)*(100-4.545);   
      print("Monster "+monstername+" will get hit by you ~"+round(hitchance)+"% of the time.", "blue");

Note: The example does not take skills that increase hit chance and the formula may be out of date. For more information about hitting see KoL's Wiki Hit Chance.

See Also

monster_attack() | monster_initiative() | monster_element() | monster_hp()

More Information

For the current discussion of what's being tracked in-combat for monster level adjustments, please see this thread.


If no monster is specified and no monster has been fought in this session, this function returns 0. This is because mafia forgets the value of last_monster() when it logs out.