- check_me is the (optional) monster to get the HP of
Returns the HP of the specified monster check_me. If check_me is not specified, it will return the HP of the current monster if you are in a fight (i.e. you're calling the function from an In-combat Consulting script), or the HP of the last monster you encountered otherwise. If you are in a fight, this will return the monster's current HP to the best of KoLmafia's knowledge.
The return value includes monster level modifications. This means that for monsters with unknown HP, the return value will initially be equivalent to monster_level_adjustment().
If you want to know the monster's raw HP without being modified by monster level adjustments, it is available through the monster.raw_hp proxy field.
Following code is a simplified function of weapon damage. It will tell how many rounds it takes to kill a monster based on its HP.Note: The example does not take crits/fumbles/hit chances into account. For more information on weapon damage see Weapon Damage.
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.