Restore mp: Difference between revisions

From Kolmafia
Jump to navigation Jump to search
imported>Bale
target 0
imported>Bale
mNo edit summary
Line 6: Line 6:


name={{#var:name}}|
name={{#var:name}}|
function_category=Skills and Effects|


function1={{Function|
function1={{Function|
Line 35: Line 34:
cli_equiv=The CLI command "restore" has similar functionality.|
cli_equiv=The CLI command "restore" has similar functionality.|
}}
}}
[[Category:Skills and Effects]]

Revision as of 22:15, 21 May 2010

Function Syntax

boolean restore_mp(int target )

  • target is the minimum MP desired after the function is run.

Restores your MP, following your current recovery settings as closely as possible. This function only attempts to surpass target, not to arrive as closely as possible to it. If your current KoLmafia recovery settings are lower than your current MP (or off), this function will restore the bare minimum necessary to reach target using the restores you have checked. If, however, you have your recovery setting set to "Try to recover up to 100% mana," this function will follow that preference if possible.

If target is zero then it will restore MP according to KoLmafia's recovery settings.

This function will do nothing and return false if you have not checked any restore items. Otherwise, this function returns true if your MP is at or equal to target when finished. If target is set above your current max MP, this function will attempt to restore to that amount and report its success based on that goal, not the number used for target.

Code Sample

This sample attempts to restore your MP to full.

if (my_mp() < my_maxmp()) {
   restore_mp(my_maxmp());
}

CLI Equivalent

The CLI command "restore" has similar functionality.

See Also

my_hp() | my_mp() | my_maxhp() | my_maxmp() | restore_hp()