Your Character

From Kolmafia
Revision as of 23:08, 28 February 2010 by imported>Grotfang
Jump to navigation Jump to search

The Basics


We'll start with a long look in the mirror. Here's how to tell about you.

string my_name() - returns your character’s name in all-lowercase.

string my_id() - returns your character’s id.

class my_class() - returns your class. (Sample: Seltzer)

int my_level() - returns your level. (Sample: Battlefield_gather)

int my_adventures() - returns the number of adventures that you have remaining. (Sample:Hedging)

int my_turncount() - returns the number of adventures used so far in this ascension.

int my_inebriety() - returns your current drunkenness.
int inebriety_limit() - returns your maximum safe drukenness level.

int my_spleen_use() - returns your current spleen use.
int spleen_limit() - returns your spleen limit.

int my_fullness() - returns how full you are.
int fullness_limit() - returns your maximum possible fullness.

boolean can_eat()
boolean can_drink()
boolean can_interact()
boolean in_hardcore()
Tells you about your limitations due to ronin, hardcore, or voluntary dietary restrictions

Basic Stats


stat my_primestat() - returns the stat associated with your class. (Sample: Seltzer)

boolean in_moxie_sign()
boolean in_muscle_sign()
boolean in_mysticality_sign()
Returns whether your ascension sign is associated with a specific stat zone.

int my_hp() - returns your current HP.
int my_mp() - returns your current MP.
int my_maxhp() - returns your current maximum HP.
int my_maxmp() - returns your current maximum MP.
int my_basestat( stat st ) - returns your current base value in the given stat. Passing $stat[SubMuscle], $stat[SubMysticality], or $stat[SubMoxie] to this function will return total substat points.
int my_buffedstat( stat st ) - returns your current buffed value in the given stat.

int current_mcd() - returns the current level of your mind-control device.
boolean change_mcd( int level ) - sets your mind-control device to the specified level.

stat stat_bonus_today()
stat stat_bonus_tomorrow()
Returns the stat that is benefitted by the moon phases today or tomorrow. If it is an “ordinary” day, the return value is $stat[none].

More Advanced Stats


stat current_hit_stat() - returns the stat that is currently used to calculate hit percentages.
int buffed_hit_stat() - returns the current buffed value of your hit stat. Identical to my_buffedstat(current_hit_stat()).

int raw_damage_absorption() - returns the total DA of all your gear and effects.
float damage_absorption_percent() - returns the percentage of damage that is blocked by all your gear and effects.
int damage_reduction() - returns the amount of damage deducted from successful attacks due to the DR of your gear and effects.

float elemental_resistance( element elem ) - returns the percentage of damage reduction from the indicated elemental damage.

float combat_rate_modifier() - returns the adjustment to your percentage of combat adventures.
float initiative_modifier() - returns the adjustment to your chance of winning initiative in battle.
float experience_bonus() - returns the amount of bonus experience you receive.
float meat_drop_modifier() - returns the adjustment to your amount of meat dropped.
float item_drop_modifier() - returns the adjustment to your percentage of item drops.

int monster_level_adjustment() - returns your total +ML (including the MCD).