Help:To Do List: Difference between revisions

From Kolmafia
Jump to navigation Jump to search
imported>Bale
r10774: ASH: "final" -> "static"
imported>AlbinoRhino
No edit summary
 
(261 intermediate revisions by 6 users not shown)
Line 16: Line 16:


== Missing Stuff ==
== 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)
  '''test CLI commands:'''
  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.
r14764: add "test xpath" to, well, test xpath expressions
r14767: Expose an xpath function that relay scripts can use after they've invoked visit_url().
http://kolmafia.us/showthread.php?16722-the-DOM-regex-scalability-and-other-jargony-words
http://kolmafia.us/showthread.php?16764-xpath-primer
r14967: Add "test mchat" command which can be used after "test load JSONFILE"
This is how test newitem is used!
http://kolmafia.us/showthread.php?17365-When-detecting-new-items-detect-new-outfits-too&p=119368&viewfull=1#post119368
  r15741, Now "test newitem descId" no longer requires itemId.
r15176: Add "test adventure URL" CLI command to see how we translate the given URL
r15239: Add "test dump_disabled_skills" to the gCLI to aid upcoming debugging
r15606: Add "test encounter URL" command.
r15874: Add "test leet NAME" command to check if KoL monster names get translated successfully from their 1337 versions.
r15883: "test load HTMLFILE" followed by "test aagain" will print the Adventure Again URL from that page.
r16275: "test visit-choice" now prints the various choice options available on the loaded HTML text.
r16309: Add "test manuel" command which will process a loaded HTML file as if it were the response to a visit to Monster Manuel.
http://kolmafia.us/showthread.php?19094-shrine-to-the-Barrel-god-(Sept-2015-IotM)&p=128256&viewfull=1#post128256
r15928: Add "test monster" command to parse the monster out of the saved HTML and save
it where ASH's last_monster() function will fetch it.
r16496: Add "test spleen X" to set your current spleen use to X (as far as KoLmafia knows; obviously it does not actually change KoL's value).
r16508: Add "test numberology adventureDelta spleenDelta"
r16519: Add "test stats X" to set all three stat values to X substats (if X > 0).
r17296: Add "test cookies" command to see values of the "special" cookies we track.
r17446: Soup up "test crop" command to allow specifying current crop and test crop.
Fix crop "is better than" test to only include count when comparing identical crop type
r17507: Experimental: ItemDatabase keeps a set of all item ids for each item name.
> test itemids seal tooth
seal tooth has 1 itemid: 2
> test itemids Staff of Ed
Staff of Ed has 2 itemids: 2325, 7961
> test itemids ancient amulet
ancient amulet has 2 itemids: 2180, 7963
r17520 does the same for effects:
> test effectids Got Milk
Got Milk has 1 effectid: 211
> test effectids A Little Bit Evil
A Little Bit Evil has 6 effectids: 597, 598, 599, 600, 601, 602
 
r15148: Track Xiblaxian holo-wrist-puter drops in '''_holoWristDrops''', and progress toward the next drop in '''_holoWristProgress'''.
 
r15177: Track which keys have been used on the Sorceress Tower door in a setting: '''nsTowerDoorKeysUsed'''
It is a comma separated list.
 
r15238: Provide '''limit_mode()''' function that returns (currently) null or spelunky.
 
  r15354: Move "equip all familiars" function from the FamiliarTrainingFrame to a new
module: FamiliarManager. Let ASH use it via boolean '''equip_all_familiars()'''
 
r15440: Add "'''servants'''" command to list Ed's servants, "'''servant'''" to list status of your current servant,
and "'''servant TYPE'''" to switch to the servant of the specified type.
 
r15441 adds the $servant data type to ASH and the following functions to manipulate them:
int '''to_servant'''( servant )
servant to_servant( int )
servant to_servant( string )
servant '''my_servant'''()
boolean '''have_servant'''( servant )
boolean '''use_servant'''( servant )
Additionally, it has the following proxy fields:
int id
string name
int level
int experience
string image,
string level1_ability
string level7_ability
string level14_ability
string level21_ability
 
r15466: Add '''chew'''(INT,ITEM) to ASH for cnsuming spleen toxins
 
equip [2268] will equip an item by number.
 
r15475: Add '''prefref''' as a built-in gCLI command
 
 
r15676: Make built-in Sorceress Tower scripts available to scripts.
 
CLI: '''maze''' [arg]
CLI: '''door'''
 
'''hedge_maze( string )'''
'''tower_door()'''
The string argument for the maze can be one of:
traps - 4 turns, all traps
gopher or duck - 7 turns gopher and duck
chihuahua or kiwi - 7 turns chihuahua and kiwi
nugglets - 10 turns, all nugglets
 
r15791: The "pvp" command with no arguments will list available stances and their
associated option number. You now can now specify a stance by either name or
number. The "pvp" command now requires you to choose a stance, since it can
no longer choose a reaosnable default based on your stats.
 
r15796: Add ASH function: '''int [string] current_pvp_stances()'''
 
r15840: Provide  ASH '''string leetify( string )''' function to garble strings.
 
r15847: Add "Random Monster Attributes" modifier as provided by dice items and the
Curse of Randomness status effect. Add random_attributes proxy field to ASH
$monster type. Munge random attributes from monster names is the Random Monster
Attribute modifier is > 0, not only if current path is One Crazy Random Summer.
 
r15922: Add Familiar Script. This script will run after changing familiars, before
automatically changing familiar equipment. The script should have a boolean main() function.
Returning true will cause normal familiar equipiment switching to be skipped,
while false will lead to it running after the script returns.
 
r15937: Add mayosoak command
 
r15959: Add knowledge of familiar drop counters to FamiliarData,
New ASH proxy fields for $familiar data type:
drop_name = short name of the thing that drops
drop_item = if it is a single item, the $item. Otherwise, $item[none]
  drops_today = how many things this familiar has dropped so far today
drops_limit = the maximum number of available drops from this familiar today
 
CLI: wumpus status - Display status of last wumpus cave.
r16014: Add "wumpus replay FILE" command to process the session log of a wumpus exploration and make deductions, etc.
r16015: Add "wumpus reset" CLI command to clear in-memory Wumpus cave state
 
r16044:The "cheat" command is a synonym for the "play" command. options:
play random - play a random card (1 draw)
cheat phylum PHYLUM - cheat (5 draws) a fight with specified phylum
cheat stat STAT - cheat (5 draws) 500 substats of specified stat
cheat buff BUFF - cheat (5 draws) 20 turns of the specified buff, either by name
  or by effect: muscle, mysticality, moxie, item drop (or items), initiative
cheat CARD - cheat (5 draws) the specified card name.
PHYLUM, STAT, BUFF, and CARD all use fuzzy matching.
 
r16047: Track Armorer quest (Madness Bakery) as questM25Armorer.
 
r16060: Make fixed list of modifier maximizer strings configurable
set maximizerList. Default value is:
mainstat | mus | mys | mox | familiar weight | HP | MP | ML | DA | DR | +combat -tie | -combat -tie | initiative | exp | meat drop | item drop | 2.0 meat, 1.0 item | item, sea | weapon dmg | ranged dmg | elemental dmg | spell dmg | adv | pvp fights | hot res | cold res | spooky res | stench res | sleaze res | all res | mp regen | ML, 0.001 slime res | 4 clownosity, -tie | 7 raveosity, -tie | surgeonosity | +four songs
 
r16163: For all monsters where our name differs from Manuel's, add a new attribute: Manuel: "MANUEL NAME"
Add .manuelName proxy field for ASH $monster data type
Add "'''checkmanuel'''" command which will look up all of you
'''int monster_factoids_available( monster )'''
returns number of factoids currently retained in memory. Note that this
can be more than the currently logged in character knows, since we don't
flush the factoids from a previous login if you know all three factoids.
'''string monster_manuel_text( monster )'''
returns the full HTML of the monster manuel entry for the given
monster. As above, this could have been retained from the previous
  character; otherwise, it will fetch and cache the text.
 
r16166: Add ASH function: '''boolean [monster] all_monsters_with_id()'''
returns a map of all monsters that have a non-zero monster ID. It builds this
afresh every time you call it, since new monsters can be (temporarily) added
 
r16169: Add MonsterManuelManager.flushCache()and expose it to ASH via flush_'''monster_manuel_cache()''' function.
Add a second parameter to MonsterManuelManager.getFactoidsAvailable: boolean
cachedOnly says "don't look on the page if the monster is not in the cache,
because we have already looked at the page and the monster wasn't there."
Expose this to ASH by changing '''monster_factoids_available()''' parameters: monster, boolean
 


r16171: Add ASH function: '''boolean[monster] get_location_monsters(location)'''
This has the same info as get_monsters, but returns a (perhaps) more useful aggregate value


I would like to list all valid adventuring conditions somewhere: (Is this all of them?)
r16200: '''Mayominder''' CLi command. Sets (buying if needed) Mayo Minder to a particular Mayo.
* {{pspan|X item}} will be fulfilled when you have X of item.
Can specify Mayo name or use a description (adv, stat, food, drunk or bmc).
* {{pspan|+X item}} will be fulfilled when you have X more of the item than you previously possessed.
* {{pspan|X choiceadv}} will be fulfilled when you encounter X choice adventures.
* {{pspan|X autostop}} will be fulfilled when you encounter X autostop adventures.
* {{pspan|X pirate insult}} will be fulfilled when you have learned X pirate insults.
* {{pspan|X arena flyer ml}} will be fulfilled when you have flyered X ML worth of monsters.
* {{pspan|X any itemtype}} will be fulfilled when you have X items that all have a partial match to itemtype, such as {{pspan|8 any paper strip}} or {{pspan|14 any fish meat}}.
* {{pspan|level X}} will be fulfilled when your character is level X. This is useful for automated power leveling.
* {{pspan|X muscle}}, {{pspan|X mysticality}} and {{pspan|X moxie}} will be fulfilled when the specified stat is at X.
* Special conditions exist for several locations.
** {{pspan|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.
** {{pspan|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.
r16218: Add ASH function '''get_stash()''' to retrieve cached view of clan stash
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.
--[[User:Jasonharper|Jasonharper]] 04:39, 3 December 2011 (EST)


r16391: Add ASH '''skill_modifier'''(object, modifiername) (currently only useful for "Skill")
to interpret the specified modifier of an item as a skill object.


  There's also a "location" command, which allows new zones to work like normal with the rest of mafia.
  r16396, r16398 & r16399 : '''Numberology''' command:
numberology - lists all the currently possible seeds and what they give you
numberology? N - N is the desired (numeric) result you want. Tell you if it is currently available.
numberology N - Attempts to get the desired result.
For both of these, if it is not currently available, tells you in how many turns it will be available.
 
16481: Add $vykea type to ASH
vykea my_vykea_companion( )
int to_int( vykea )
vykea to_vykea( strict_string )
 
r16790: Add ASH function int [int] reverse_numberology([int adv_delta, int spleen_delta]).
The return value is a map from result IDs to input seeds that generate said results.
adv_delta and spleen_delta, which both default to 0, allow one to obtain forecasts on upcoming options.
http://kolmafia.us/showthread.php?19664-ASH-command(s)-for-Numberology&p=133467&viewfull=1#post133467
 
r17909: Add ASH function: string numberology_prize( number )
 
r16800: Add multi-line string support to ASH. In order to specify a multi-line string,
you must explicitly escape the end-of-line by placing a backslash (\) at the end of the line.
   
   
  location 274 Lollipop Forest
  Note that as a consequence of how the parser is written, it will trim all
leading and trailing whitespace for each of these lines via Java's
String.trim() method. Previously, this was irrelevant in the context of ASH
strings, but now that ASH strings can span multiple lines, it is worth
mentioning. If you want to have whitespace at the beginning of the line,
just escape the first character of the line.
 
r16866: Add aggregate literals to ASH.
http://kolmafia.us/showthread.php?20103-16866-Add-aggregate-literals-to-ASH-The-main-use-of-these-is-likely-for-initializa
http://kolmafia.us/showthread.php?10685-Map-literals-in-ASH-(potential-feature)&p=134150#post134150
   
   
  Be careful, if you add the same location twice it can make a mess.  
  r17658: http://kolmafia.us/showthread.php?10685-Map-literals-in-ASH-(potential-feature)&p=140128#post140128
Luckily, locations added this way are not remembered, so you can quit and restart if you mess it up.


r16886: Add '''witchess''' command to get Puzzle Champ. This only works if you have solved all puzzles.


  10078: ash function format_dtg
  r17023: Add terminal gCLI command
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:
  r17136: Track furniture in the Clan Rumpus Room, accessible with '''get_clan_rumpus()'''. Extra Adventures and PvP Fights from furniture are tracked.
  10122: Add the boolean "fancy" and "candy" fields to item proxy records.
  If your clan has a ball pit, the last entry in get_clan_rumpus() will indicate how many balls are in it.
  10147: Initial support for "Crimbo 2011" coinmaster: trade candy for Candy Credits
   
r17471: get_clan_rumpus() now returns int [string] map of furniture names.
http://kolmafia.us/showthread.php?21006-Improve-return-value-of-get_clan_rumpus()


  10227: Add the "closet empty" CLI command, and the empty_closet() ASH function.
  r17151: Add ASH and CLI support for stocking mall stores from Hagnk's.
boolean '''put_shop_using_storage(int price, int limit, item it)'''
boolean '''put_shop_using_storage(int price, int limit, int qty, item it)'''
and extends the CLI commands mallsell and shop.
put_shop() works by batching requests for "shop put". Similarly, buy_using_storage() puts together requests via "buy using storage".


  10250: kingLiberatedScript called when you break the prism.
  r17283: Add "timespinner" command courtesy of lost.
Add "timespinner" command courtesy of lost.
timespinner list food -> list available foods
timespinner eat FOOD -> Spin and Munch on the specified food
r17284: Allow pranking with timespinner
r17286: Add "timespinner list monsters [filter]". This will show all monsters that should be available in the Time-Spinner, optionally filtered (case-insensitive).


  r10281 Add a "faxbot cmd" command which sends "cmd" to the first configure faxbot.
  r17290: Add traceprint( string) ASH function


  r9181, 9183, 9184 & r9190: moods per slyz's summary here: http://kolmafia.us/showthread.php?8852-Composable-Moods
  r17454: Experimental ASH feature: allow X++, X--, ++X, and --X with their normal meanings: post-increment, post-decrement, pre-increment, and pre-decrement.


  r10343 "baron" CLI command to find the baron. "tavern" finds the faucet, as before
  r17460: Add Java-style "for" loop:
for (INIT [, INIT]* ; CONDITION ; ITERATE [, ITERATE]* ) BODY
You can have 0 or more INIT statements, which can be of the form
X = EXP (where X is declared already) or
TYPE X = EXP (whre X of type TYPE will be declared for use in the BODY scope).
You can have 0 or more ITERATE statements, which can be of the form
X++ or X--
++X or -- X
X OPER EXP (where OPER can be =, +=, -=, etc.
BODY can be a single statement ending with a ; or a block enclosed in {}, with no ; at the end, just like and other loop.
break, continue, return, or exit are allowed within BODY, just like any loop.


  r10344 Add tavern( string goal ) ASH function.
  r17477: Add boolean '''can_still_steal()''' function to ASH, which calls the same function  
  goal can be "faucet", "baron", or "explore" (to explore all remaining unexplored squares).
  that Stationary Buttons use do decide whether to enable or disable the "steal" button
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
  r17612: ASH has a function to return all the candy in a given tier:
  execute your "betweenBattleScript" (which is actually a "beforeBattleScript",
  item [int] '''candy_for_tier'''( int tier )
either automated or manual)
The "'''checkcandy'''" command will list all unspaded candy or will tell you the candy type of each of its arguments.


  r10412: Add $skill proxy records: .dailylimit and .timescast
  r17613: More Sweet Synthesis stuff: ASH functions:
boolean '''sweet_synthesis'''( item candy1, item candy2 )
effect '''sweet_synthesis_result'''( item candy1, item candy2 )
item [int] '''sweet_synthesis_pairings'''( effect result, item candy1 )


  r10753-6 get_goals returns a string[int] containing all the conditions that KoLmafia will
  r17629: Add candy_for_tier() and sweet_synthesis_pairing() ASH functions that have a "flags" argument,  
try to satisfy. Add goal_exists() where you can pass in a goal type (choiceadv, autostop,  
  in which you can specify filtering. 0 = no filtering, 1 = available, 2 = allowed, 3 = available and allowed.
  meat, health, mana, item) and KoLmafia will tell you if there are any goals that match.


  r10765: Add a "final" scope type to ASH which allows data/commands to be executed only
  r17637: Add "synthesize" command: synthesize CANDY1, CANDY2 - combines candies to get an effect
  once per session.
synthesize? CANDY1, CANDY2 - tells you about the candies and the effect
  r10772: A final declaration can either take a block, surrounded by {}, or a single
 
  command or declaration.
r17644: To automatically select pairs of candy, add some ASH functions:
  r10774: ASH: "final" -> "static"
item [int] sweet_synthesis_pair( effect )
item [int] sweet_synthesis_pair( effect, flags )
For the desired effect, pick a suitable pair of candies.
If you are in-run, it will use only "available" candy and will prefer candies that you have more of.
If you are post-run, it will consider all candies and will choose the pair with the lowest total mall price.
If you want to force "available" candies post-run, use flags = 1.
boolean sweet_synthesis( effect )
boolean sweet_synthesis( effect, flags )
The same, but it will actually perform Sweet Synthesis to get the effect.
http://kolmafia.us/showthread.php?21144-Rethinking-Candy&p=139996&viewfull=1#post139996
 
r17645: Add CLI commands:
synthesize EFFECT
synthesize? EFFECT
 
r17673: Add "shop reprice" command and reprice_shop() ash function
 
r17677: edpiece? command tells you the effects of the various decorations, as well as telling you which one is currently equipped.
 
r17817: Added CLI command "absorb"
 
r17819: Add ASH function to interface to KoL's /count chat command:
int slash_count( item it )
 
r17845: Add my_absorbs() ash function
 
r17892: Add a bunch of ASH support for doing interesting things with properties:
http://kolmafia.us/showthread.php?21570-Properties&p=141625&viewfull=1#post141625
  http://kolmafia.us/showthread.php?21570-Properties&p=141629&viewfull=1#post141629
boolean [string] get_all_properties( string filter, boolean global )
boolean property_exists( string name )
boolean property_exists( string name, boolean global )
boolean property_has_default( string name )
string property_default_value( string name )
string get_property( string name, boolean global )
string remove_property( string name )
string remove_property( string name, boolean global )
  boolean rename_property( string old_name, string new_name )
 
r17911: Add ASH convenience functions:  
boolean starts_with( string value, string prefix );
boolean ends_with( string value, string suffix );
 
r17912: Add ASH function to get the full unambiguous card name from the Deck of Every Card:
string every_card_name( string name )
 
r17921: Add ASH get_closet() and get_storage() commands:
int [item] get_closet();
int [item] get_storage();
 
r17936: Add ASH function: void mood_execute( int multiplicity )
multiplicity determines the minimum number of casts (or items) a given trigger will use; if
  the mood trigger is "cast 1 SKILL", multiplicty 3 will treat it as "cast 3 SKILL".
multiplicity = -1 is what KoLmafia uses internally for between battle checks.
multiplicity = 0 is what the CLI command "mood execute" uses.
 
  r17937-8: Add ASH function: string [int] available_choice_options( boolean spoilers )
If the argument is "true", the Relay Browser choice spoilers will be appended to KoL's choice choice text (in parentheses).
 
r17969/17970 adds the "spacegate" command.
spacegate vaccine X
(where X is 1, 2, or 3) will visit the Spacegate Vaccinator to get the appropriate vaccine.
 
r18000: Add ASH function: int my_session_meat() which tracks how much meat the character has gained
or lost since login via character actions; mall sales and incoming kmail containing meat
will increment my_meat(), but not this value.
 
r18040: When you define a map with value as a zero-length array, file_to_map can
now populate it. The values will be variable-length array literals that
consume all the data values from the line of your file. Thus: keyVALUE(VALUE)*
You can now use foreach to iterate over an aggregate literal.
http://kolmafia.us/showthread.php?21742-Best-way-to-load-questslog-txt&p=143001&viewfull=1#post143001


== Needs Major Work ==
== Needs Major Work ==
Line 121: Line 409:


Information on how to create a code sample: [[Template:CodeSample]]
Information on how to create a code sample: [[Template:CodeSample]]
[[Category:Contributing]]

Latest revision as of 01:16, 25 May 2017

"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

test CLI commands:

r14764: add "test xpath" to, well, test xpath expressions
r14767: Expose an xpath function that relay scripts can use after they've invoked visit_url().
http://kolmafia.us/showthread.php?16722-the-DOM-regex-scalability-and-other-jargony-words
http://kolmafia.us/showthread.php?16764-xpath-primer

r14967: Add "test mchat" command which can be used after "test load JSONFILE"

This is how test newitem is used!
http://kolmafia.us/showthread.php?17365-When-detecting-new-items-detect-new-outfits-too&p=119368&viewfull=1#post119368
 r15741, Now "test newitem descId" no longer requires itemId.

r15176: Add "test adventure URL" CLI command to see how we translate the given URL

r15239: Add "test dump_disabled_skills" to the gCLI to aid upcoming debugging

r15606: Add "test encounter URL" command.

r15874: Add "test leet NAME" command to check if KoL monster names get translated successfully from their 1337 versions.

r15883: "test load HTMLFILE" followed by "test aagain" will print the Adventure Again URL from that page.

r16275: "test visit-choice" now prints the various choice options available on the loaded HTML text.

r16309: Add "test manuel" command which will process a loaded HTML file as if it were the response to a visit to Monster Manuel.
http://kolmafia.us/showthread.php?19094-shrine-to-the-Barrel-god-(Sept-2015-IotM)&p=128256&viewfull=1#post128256

r15928: Add "test monster" command to parse the monster out of the saved HTML and save
it where ASH's last_monster() function will fetch it.

r16496: Add "test spleen X" to set your current spleen use to X (as far as KoLmafia knows; obviously it does not actually change KoL's value).

r16508: Add "test numberology adventureDelta spleenDelta"

r16519: Add "test stats X" to set all three stat values to X substats (if X > 0).

r17296: Add "test cookies" command to see values of the "special" cookies we track.

r17446: Soup up "test crop" command to allow specifying current crop and test crop.
Fix crop "is better than" test to only include count when comparing identical crop type

r17507: Experimental: ItemDatabase keeps a set of all item ids for each item name.
> test itemids seal tooth
seal tooth has 1 itemid: 2
> test itemids Staff of Ed
Staff of Ed has 2 itemids: 2325, 7961
> test itemids ancient amulet
ancient amulet has 2 itemids: 2180, 7963

r17520 does the same for effects:
> test effectids Got Milk
Got Milk has 1 effectid: 211
> test effectids A Little Bit Evil
A Little Bit Evil has 6 effectids: 597, 598, 599, 600, 601, 602
r15148: Track Xiblaxian holo-wrist-puter drops in _holoWristDrops, and progress toward the next drop in _holoWristProgress.
r15177: Track which keys have been used on the Sorceress Tower door in a setting: nsTowerDoorKeysUsed
It is a comma separated list.
r15238: Provide limit_mode() function that returns (currently) null or spelunky.
r15354: Move "equip all familiars" function from the FamiliarTrainingFrame to a new
module: FamiliarManager. Let ASH use it via boolean equip_all_familiars()
r15440: Add "servants" command to list Ed's servants, "servant" to list status of your current servant, 
and "servant TYPE" to switch to the servant of the specified type.
r15441 adds the $servant data type to ASH and the following functions to manipulate them:

int to_servant( servant )
servant to_servant( int )
servant to_servant( string )
servant my_servant()
boolean have_servant( servant )
boolean use_servant( servant )

Additionally, it has the following proxy fields:
int id
string name
int level
int experience
string image,
string level1_ability
string level7_ability
string level14_ability
string level21_ability
r15466: Add chew(INT,ITEM) to ASH for cnsuming spleen toxins
equip [2268] will equip an item by number.
r15475: Add prefref as a built-in gCLI command


r15676: Make built-in Sorceress Tower scripts available to scripts.
CLI: maze [arg]
CLI: door
hedge_maze( string )
tower_door()

The string argument for the maze can be one of:
traps - 4 turns, all traps
gopher or duck - 7 turns gopher and duck
chihuahua or kiwi - 7 turns chihuahua and kiwi
nugglets - 10 turns, all nugglets
r15791: The "pvp" command with no arguments will list available stances and their
associated option number. You now can now specify a stance by either name or
number. The "pvp" command now requires you to choose a stance, since it can
no longer choose a reaosnable default based on your stats.
r15796: Add ASH function: int [string] current_pvp_stances()
r15840: Provide  ASH string leetify( string ) function to garble strings.
r15847: Add "Random Monster Attributes" modifier as provided by dice items and the
Curse of Randomness status effect. Add random_attributes proxy field to ASH
$monster type. Munge random attributes from monster names is the Random Monster
Attribute modifier is > 0, not only if current path is One Crazy Random Summer.
r15922: Add Familiar Script. This script will run after changing familiars, before 
automatically changing familiar equipment. The script should have a boolean main() function. 
Returning true will cause normal familiar equipiment switching to be skipped,
while false will lead to it running after the script returns.
r15937: Add mayosoak command
r15959: Add knowledge of familiar drop counters to FamiliarData, 
New ASH proxy fields for $familiar data type:
drop_name = short name of the thing that drops
drop_item = if it is a single item, the $item. Otherwise, $item[none]
drops_today = how many things this familiar has dropped so far today
drops_limit = the maximum number of available drops from this familiar today
CLI: wumpus status - Display status of last wumpus cave.
r16014: Add "wumpus replay FILE" command to process the session log of a wumpus exploration and make deductions, etc.
r16015: Add "wumpus reset" CLI command to clear in-memory Wumpus cave state
r16044:The "cheat" command is a synonym for the "play" command. options:
play random - play a random card (1 draw)
cheat phylum PHYLUM - cheat (5 draws) a fight with specified phylum
cheat stat STAT - cheat (5 draws) 500 substats of specified stat
cheat buff BUFF - cheat (5 draws) 20 turns of the specified buff, either by name
  or by effect: muscle, mysticality, moxie, item drop (or items), initiative
cheat CARD - cheat (5 draws) the specified card name.
PHYLUM, STAT, BUFF, and CARD all use fuzzy matching.
r16047: Track Armorer quest (Madness Bakery) as questM25Armorer.
r16060: Make fixed list of modifier maximizer strings configurable
set maximizerList. Default value is:
mainstat | mus | mys | mox | familiar weight | HP | MP | ML | DA | DR | +combat -tie | -combat -tie | initiative | exp | meat drop | item drop | 2.0 meat, 1.0 item | item, sea | weapon dmg | ranged dmg | elemental dmg | spell dmg | adv | pvp fights | hot res | cold res | spooky res | stench res | sleaze res | all res | mp regen | ML, 0.001 slime res | 4 clownosity, -tie | 7 raveosity, -tie | surgeonosity | +four songs
r16163: For all monsters where our name differs from Manuel's, add a new attribute: Manuel: "MANUEL NAME"
Add .manuelName proxy field for ASH $monster data type

Add "checkmanuel" command which will look up all of you

int monster_factoids_available( monster )

returns number of factoids currently retained in memory. Note that this
can be more than the currently logged in character knows, since we don't
flush the factoids from a previous login if you know all three factoids.

string monster_manuel_text( monster )

returns the full HTML of the monster manuel entry for the given
monster. As above, this could have been retained from the previous
character; otherwise, it will fetch and cache the text.
r16166: Add ASH function: boolean [monster] all_monsters_with_id() 

returns a map of all monsters that have a non-zero monster ID. It builds this
afresh every time you call it, since new monsters can be (temporarily) added
r16169: Add MonsterManuelManager.flushCache()and expose it to ASH via flush_monster_manuel_cache() function.
Add a second parameter to MonsterManuelManager.getFactoidsAvailable: boolean
cachedOnly says "don't look on the page if the monster is not in the cache,
because we have already looked at the page and the monster wasn't there."
Expose this to ASH by changing monster_factoids_available() parameters: monster, boolean


r16171: Add ASH function: boolean[monster] get_location_monsters(location) 
This has the same info as get_monsters, but returns a (perhaps) more useful aggregate value
r16200: Mayominder CLi command. Sets (buying if needed) Mayo Minder to a particular Mayo.
Can specify Mayo name or use a description (adv, stat, food, drunk or bmc).
r16218: Add ASH function get_stash() to retrieve cached view of clan stash
r16391: Add ASH skill_modifier(object, modifiername) (currently only useful for "Skill")
to interpret the specified modifier of an item as a skill object.
r16396, r16398 & r16399 : Numberology command:
numberology - lists all the currently possible seeds and what they give you
numberology? N - N is the desired (numeric) result you want. Tell you if it is currently available.
numberology N - Attempts to get the desired result.
For both of these, if it is not currently available, tells you in how many turns it will be available.
16481: Add $vykea type to ASH
vykea my_vykea_companion( )
int to_int( vykea )
vykea to_vykea( strict_string )
r16790: Add ASH function int [int] reverse_numberology([int adv_delta, int spleen_delta]).
The return value is a map from result IDs to input seeds that generate said results.
adv_delta and spleen_delta, which both default to 0, allow one to obtain forecasts on upcoming options.
http://kolmafia.us/showthread.php?19664-ASH-command(s)-for-Numberology&p=133467&viewfull=1#post133467
r17909: Add ASH function: string numberology_prize( number )
r16800: Add multi-line string support to ASH. In order to specify a multi-line string, 
you must explicitly escape the end-of-line by placing a backslash (\) at the end of the line.

Note that as a consequence of how the parser is written, it will trim all
leading and trailing whitespace for each of these lines via Java's
String.trim() method. Previously, this was irrelevant in the context of ASH
strings, but now that ASH strings can span multiple lines, it is worth
mentioning. If you want to have whitespace at the beginning of the line,
just escape the first character of the line.
r16866: Add aggregate literals to ASH.
http://kolmafia.us/showthread.php?20103-16866-Add-aggregate-literals-to-ASH-The-main-use-of-these-is-likely-for-initializa
http://kolmafia.us/showthread.php?10685-Map-literals-in-ASH-(potential-feature)&p=134150#post134150

r17658: http://kolmafia.us/showthread.php?10685-Map-literals-in-ASH-(potential-feature)&p=140128#post140128
r16886: Add witchess command to get Puzzle Champ. This only works if you have solved all puzzles.
r17023: Add terminal gCLI command
r17136: Track furniture in the Clan Rumpus Room, accessible with get_clan_rumpus(). Extra Adventures and PvP Fights from furniture are tracked.
If your clan has a ball pit, the last entry in get_clan_rumpus() will indicate how many balls are in it.

r17471: get_clan_rumpus() now returns int [string] map of furniture names.
http://kolmafia.us/showthread.php?21006-Improve-return-value-of-get_clan_rumpus()
r17151: Add ASH and CLI support for stocking mall stores from Hagnk's.
boolean put_shop_using_storage(int price, int limit, item it)
boolean put_shop_using_storage(int price, int limit, int qty, item it)

and extends the CLI commands mallsell and shop.
put_shop() works by batching requests for "shop put". Similarly, buy_using_storage() puts together requests via "buy using storage".
r17283: Add "timespinner" command courtesy of lost. 
Add "timespinner" command courtesy of lost.
timespinner list food -> list available foods
timespinner eat FOOD -> Spin and Munch on the specified food

r17284: Allow pranking with timespinner

r17286: Add "timespinner list monsters [filter]". This will show all monsters that should be available in the Time-Spinner, optionally filtered (case-insensitive).
r17290: Add traceprint( string) ASH function
r17454: Experimental ASH feature: allow X++, X--, ++X, and --X with their normal meanings: post-increment, post-decrement, pre-increment, and pre-decrement.
r17460: Add Java-style "for" loop:
for (INIT [, INIT]* ; CONDITION ; ITERATE [, ITERATE]* ) BODY
You can have 0 or more INIT statements, which can be of the form
X = EXP (where X is declared already) or
TYPE X = EXP (whre X of type TYPE will be declared for use in the BODY scope).

You can have 0 or more ITERATE statements, which can be of the form
X++ or X--
++X or -- X
X OPER EXP (where OPER can be =, +=, -=, etc.

BODY can be a single statement ending with a ; or a block enclosed in {}, with no ; at the end, just like and other loop.

break, continue, return, or exit are allowed within BODY, just like any loop.
r17477: Add boolean can_still_steal() function to ASH, which calls the same function 
that Stationary Buttons use do decide whether to enable or disable the "steal" button
r17612: ASH has a function to return all the candy in a given tier:
item [int] candy_for_tier( int tier )
The "checkcandy" command will list all unspaded candy or will tell you the candy type of each of its arguments.
r17613: More Sweet Synthesis stuff: ASH functions:
boolean sweet_synthesis( item candy1, item candy2 )
effect sweet_synthesis_result( item candy1, item candy2 )
item [int] sweet_synthesis_pairings( effect result, item candy1 )
r17629: Add candy_for_tier() and sweet_synthesis_pairing() ASH functions that have a "flags" argument, 
in which you can specify filtering. 0 = no filtering, 1 = available, 2 = allowed, 3 = available and allowed.
r17637: Add "synthesize" command: synthesize CANDY1, CANDY2 - combines candies to get an effect
synthesize? CANDY1, CANDY2 - tells you about the candies and the effect
r17644: To automatically select pairs of candy, add some ASH functions:
item [int] sweet_synthesis_pair( effect )
item [int] sweet_synthesis_pair( effect, flags )

For the desired effect, pick a suitable pair of candies.
If you are in-run, it will use only "available" candy and will prefer candies that you have more of.
If you are post-run, it will consider all candies and will choose the pair with the lowest total mall price.
If you want to force "available" candies post-run, use flags = 1.

boolean sweet_synthesis( effect )
boolean sweet_synthesis( effect, flags )

The same, but it will actually perform Sweet Synthesis to get the effect.

http://kolmafia.us/showthread.php?21144-Rethinking-Candy&p=139996&viewfull=1#post139996
r17645: Add CLI commands: 
synthesize EFFECT
synthesize? EFFECT
r17673: Add "shop reprice" command and reprice_shop() ash function
r17677: edpiece? command tells you the effects of the various decorations, as well as telling you which one is currently equipped.
r17817: Added CLI command "absorb"
r17819: Add ASH function to interface to KoL's /count chat command:
int slash_count( item it )
r17845: Add my_absorbs() ash function
r17892: Add a bunch of ASH support for doing interesting things with properties:
http://kolmafia.us/showthread.php?21570-Properties&p=141625&viewfull=1#post141625 
http://kolmafia.us/showthread.php?21570-Properties&p=141629&viewfull=1#post141629

boolean [string] get_all_properties( string filter, boolean global )
boolean property_exists( string name )
boolean property_exists( string name, boolean global )
boolean property_has_default( string name )
string property_default_value( string name )
string get_property( string name, boolean global )
string remove_property( string name )
string remove_property( string name, boolean global )
boolean rename_property( string old_name, string new_name )
r17911: Add ASH convenience functions: 
boolean starts_with( string value, string prefix );
boolean ends_with( string value, string suffix );
r17912: Add ASH function to get the full unambiguous card name from the Deck of Every Card:
string every_card_name( string name )
r17921: Add ASH get_closet() and get_storage() commands:
int [item] get_closet();
int [item] get_storage();
r17936: Add ASH function: void mood_execute( int multiplicity )
multiplicity determines the minimum number of casts (or items) a given trigger will use; if
the mood trigger is "cast 1 SKILL", multiplicty 3 will treat it as "cast 3 SKILL".
multiplicity = -1 is what KoLmafia uses internally for between battle checks.
multiplicity = 0 is what the CLI command "mood execute" uses.
r17937-8: Add ASH function: string [int] available_choice_options( boolean spoilers )
If the argument is "true", the Relay Browser choice spoilers will be appended to KoL's choice choice text (in parentheses).
r17969/17970 adds the "spacegate" command.
spacegate vaccine X
(where X is 1, 2, or 3) will visit the Spacegate Vaccinator to get the appropriate vaccine.
r18000: Add ASH function: int my_session_meat() which tracks how much meat the character has gained
or lost since login via character actions; mall sales and incoming kmail containing meat
will increment my_meat(), but not this value.
r18040: When you define a map with value as a zero-length array, file_to_map can
now populate it. The values will be variable-length array literals that
consume all the data values from the line of your file. Thus: keyVALUE(VALUE)*

You can now use foreach to iterate over an aggregate literal.

http://kolmafia.us/showthread.php?21742-Best-way-to-load-questslog-txt&p=143001&viewfull=1#post143001

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