Help:To Do List

From Kolmafia
Revision as of 22:50, 13 March 2012 by imported>Bale (→‎Missing Stuff)
Jump to navigation Jump to search

"To Do" List

This is a list of stuff that is missing from the wiki or else needs major work. Please help!


If you need tips for editing the wiki, find that here: Help:Editing.

  • CLI Commands are usually only added to the CLI Reference. Only very complicated commands require their own page.
  • ASH commands need to be listed on their category page as well as on the Ash Functions list.
    • It is not necessary to always create a code sample, although it is preferred.
    • If you don't add a code sample, please remember to add needscode=yes| to the page.


Missing Stuff

r10025: Added "choice" CLI command, to resolve manual or unsupported choiceadventures 
Added "choice" CLI command, to resolve manual or unsupported choice
adventures without having to visit the relay browser - which might be
inconvenient if you're already in the CLI, and don't need to see the full
adventure text to decide which option you want. With no parameter, "choice"
just lists the options. With a numeric parameter, it picks that option. 
With any other parameter, it picks the first option containing that text (in
either the actual button text, or mafia's spoiler text).

r10033:  a new command 'graygui' (or 'greygui' if you prefer that spelling) 
has been added to the CLI, which will print out all the entry points for all
the stuff that still has a known open request sequence.


I would like to list all valid adventuring conditions somewhere: (Is this all of them?)

  • X item will be fulfilled when you have X of item.
  • +X item will be fulfilled when you have X more of the item than you previously possessed.
  • X choiceadv will be fulfilled when you encounter X choice adventures.
  • X autostop will be fulfilled when you encounter X autostop adventures.
  • X pirate insult will be fulfilled when you have learned X pirate insults.
  • X arena flyer ml will be fulfilled when you have flyered X ML worth of monsters.
  • X any itemtype will be fulfilled when you have X items that all have a partial match to itemtype, such as 8 any paper strip or 14 any fish meat.
  • level X will be fulfilled when your character is level X. This is useful for automated power leveling.
  • X muscle, X mysticality and X moxie will be fulfilled when the specified stat is at X.
  • Special conditions exist for several locations.
    • outfit is only valid in the Cobb's Knob Harem, Cobb's Knob Treasury, Frat House, Hippy Camp, Pirate Cove, Itznotyerzitz Mine, and eXtreme Slope.
    • castle map items is only valid in the Giant's Castle.

If you leave off the quantity X, then it is assumed to be 1. Remainder of possible conditions:

  • X meat
  • X health/mana
  • X% health/mana
  • X anything but Y (opposite of any)
  • any/anything but can take multiple item names separated by | or /.
  • outfit can be preceded by the name of certain outfits, or the location where one normally drops, to specify a non-default outfit. I'm not sure if there's any place where that's actually useful.
  • castle map items is technically valid everywhere; it's only non-stupid in the Giant's Castle.

--Jasonharper 04:39, 3 December 2011 (EST) 


There's also a "location" command, which allows new zones to work like normal with the rest of mafia.

location 274 Lollipop Forest

Be careful, if you add the same location twice it can make a mess. 
Luckily, locations added this way are not remembered, so you can quit and restart if you mess it up.



10078: ash function format_dtg
10081: ash function format_dtg renamed to be
string format_date_time(inFormat, dtg, outFormat)
more info: http://kolmafia.us/showthread.php?8451-time_to_string()-with-parameter&p=64058&viewfull=1#post64058

Modify examples on proxy record page because of:
10122: Add the boolean "fancy" and "candy" fields to item proxy records.
10147: Initial support for "Crimbo 2011" coinmaster: trade candy for Candy Credits

10227: Add the "closet empty" CLI command, and the empty_closet() ASH function.

10250: kingLiberatedScript called when you break the prism.

10786: Add afterAdventureScript, which is executed after each automated adventure 
before checking if goals have been satisfied.
 - I did "set afterAdventureScript=use * small box;use * large box"
 - I set my goal to be "+1 potion of inebriety"
 - I told KoLmafia to go to the Dungeon of Doom for 20 adventures.
 After each adventure which yielded a small box or a large box, my script used the box. 
 As soon as I got a potion of inebriety, KoLmafia stopped automating, with 
 "Conditions satisfied after 5 adventures".

r10281 Add a "faxbot cmd" command which sends "cmd" to the first configure faxbot.

r9181, 9183, 9184 & r9190: moods per slyz's summary here: http://kolmafia.us/showthread.php?8852-Composable-Moods

r10343 "baron" CLI command to find the baron. "tavern" finds the faucet, as before
r10344 Add tavern( string goal ) ASH function. 
goal can be "faucet", "baron", or  "explore" (to explore all remaining unexplored squares). 
r10345 Add ASH tavern( "fight" ) to explore cellar until the Baron's mansion is found 
and then go in to fight him.

r10396 Add "relayRunsBeforeBattleScript" to control whether manual adventuring will
execute your "betweenBattleScript" (which is actually a "beforeBattleScript",
either automated or manual)

r10412: Add $skill proxy records: .dailylimit and .timescast

r10753-6 get_goals() returns a string[int] containing all the conditions that KoLmafia will 
try to satisfy. Add goal_exists() where you can pass in a goal type (choiceadv, autostop, 
meat, health, mana, item) and KoLmafia will tell you if there are any goals that match.

static scope is added!
r10765: Add a "final" scope type to ASH which allows data/commands to be executed only 
once per session.
r10772: A final declaration can either take a block, surrounded by {}, or a single
command or declaration.
r10774: ASH: "final" -> "static"

Needs Major Work

Proxy Records is only slightly better than a placeholder. 

In r10047, the adventure tab interface was altered. Fix SinginSally's guide on pages...

http://wiki.kolmafia.us/index.php?title=KoLmafia_Guide:_Attack_Script
http://wiki.kolmafia.us/index.php?title=KoLmafia_Guide:_Custom_Combat_Script
http://wiki.kolmafia.us/index.php?title=KoLmafia_Guide:_Goal-Oriented_Adventuring

Information on moods calling other moods: http://kolmafia.us/showthread.php?8852-Composable-Moods&p=66468&viewfull=1#post66468

Needs Code Samples

There is a list of all pages that require code samples: Category:Needs Code Sample

Information on how to create a code sample: Template:CodeSample

Retrieved from "https://wiki.kolmafia.us/index.php?title=Help:To_Do_List&oldid=7579"