CLI Reference: Difference between revisions
imported>Vorzer →Quests: Added >poolskill. You need it for the Spookyraven quest, so I put it under "Quests". |
imported>Vorzer →Equipment, Inventory and Consumption Management: Added bjornify |
||
Line 65: | Line 65: | ||
| [ item... ] | | [ item... ] | ||
| list creatables, or create specified items. | | list creatables, or create specified items. | ||
|- | |||
| bjornify | |||
| [familiar] | |||
| list available familiars, or put a familiar in your {{kolwiki|Buddy Bjorn}} | |||
|- | |- | ||
| chew[?] | | chew[?] |
Revision as of 14:04, 3 October 2014
The KoLmafia Graphical CLI is one of the most helpful features Mafia has. This page is intended to provide information on the commands available.
How to use these commands
Square brackets [ ] enclose optional elements of commands. In command descriptions, they may also enclose the effects of using those optional elements.
Vertical bars | separate alternative elements - choose any one. (But note that || is an actual part of a few commands.)
An ellipsis ... after an element means that it can be repeated as many times as needed.
Elements in italics are placeholders - replace them with an actual name you want the command to operate on.
Commands with an asterisk * after the name are abbreviations - you can type them in a longer form if desired.
Some command names can be followed by a question mark (shown as [?] ), in which case the command will just display what it would do, rather than actually doing it.
When adventuring, or using an item or skill, the name can be preceded by a number specifying how many times to do it. An asterisk in place of this number means "as many as possible" or "the current quantity in inventory", depending on context. Negative numbers mean to do that many less than the maximum.
Usually, multiple commands can be given on the same line, separated by semicolons. The exceptions (alias, ash, ashq, cheapest, expensive, fecho, fprint, get, set, speculate, whatif, later) treat the entire remainder of the line as a parameter.
A few commands (elseif, else, if, try, while) treat at least one following command as a block that is executed conditionally or repetitively. The block consists of the remainder of the line, or the entire next line if that's empty. The block is extended by additional lines if it would otherwise end with one of these special commands.
Quantity Parameter
Any place that a number can be used to define a quantity, such as autosell 5 heavy D
, you can use one of the following to indicate a variable quantity:
- * is used to indicate all items in inventory.
autosell * heavy D
- 0 is also used to indicate all items in inventory.
autosell 0 heavy D
- a negative number means sell off all items except for the number listed. For example, -5 means keep 5 and sell the rest.
autosell -5 heavy D
Item Parameter
There are two ways to provide an item. By name or number.
- An item's name can be used in the obvious way, however this may sometimes fail because some items have numbers as part of their names. KoL's fuzzy matching will sometimes make a mistake such as interpreting 1 WA as a 100-watt light bulb.
- An item's ID number can be used to avoid any possibility of ambiguity. This also allows names with commas to be passed as parameters to functions that contain comma separated lists. To do this the item needs to be prefaced by a pilcrow. The character: ¶, is also known as a paragraph mark. It can be typed from your keyboard with a bit of know-how or included in an ash script as "\u00B6".
send 1 ¶4358 to Bale|Thanks for being awesome
- is a way to send A Crimbo Carol, Ch. 5 to Bale despite the comma in the item's name.
Commands
Equipment, Inventory and Consumption Management
Command | Arguments | Description |
---|---|---|
*brewery*[?] | [ daily special | item ] | show daily special [or consume it or other restaurant item]. |
*kitchen*[?] | item | consumes item at Hell's Kitchen, if available. |
acquire | item | ensure that you have item, creating or buying it if needed. |
accordions | show information about accordions. | |
bake | [ item... ] | list creatables, or create specified items. |
bjornify | [familiar] | list available familiars, or put a familiar in your Buddy Bjorn |
chew[?] | [either] item [, item]... | use/consume items |
cleanup | use, pulverize, or autosell your junk items. | |
closet | list filter | empty | put item... | take item... | list or manipulate your closet. |
create | [ item... ] | list creatables, or create specified items. |
display | take item... | list or manipulate your display case. |
eat[?] | [either] item [, item]... | use/consume items |
equip | [list filter] | [slot] item | show equipment, or equip item [in slot]. |
find | item | ensure that you have item, creating or buying it if needed. |
fold[?] | item | produce item by using another form, repeated as needed. |
ghost[?] | [either] item [, item]... | use/consume items |
hagnk | outfit name | item [, item]... | pull items from Hagnk's storage. |
hermit[?] | [item] | get clover status, or trade for item. |
hobo[?] | [either] item [, item]... | use/consume items |
inv* | [param] | list indicated type of data, possibly filtered by param. |
junk | use, pulverize, or autosell your junk items. | |
make | [ item... ] | list creatables, or create specified items. |
maximize[?] | [+|-|weight] keyword, ... | run the Modifier Maximizer. |
mix | [ item... ] | list creatables, or create specified items. |
modifies | filter | list all possible sources of modifiers matching filter. |
modref | [object] | list all modifiers, show values for player [and object]. |
modtrace | filter | list everything that adds to modifiers matching filter. |
outfit | [list filter] | save name | checkpoint | name | list, save, restore, or change outfits. |
overdrink[?] | [either] item [, item]... | use/consume items |
ply | [ item... ] | list creatables, or create specified items. |
pull | outfit name | item [, item]... | pull items from Hagnk's storage. |
pulverize | item [, item]... | pulverize specified items |
quark[?] | [itemList...] | gain MP by pasting unstable quark with best item from itemList (or your junk list). |
remove | slot | name | remove equipment in slot, or that matches name |
restaurant[?] | [ daily special | item ] | show daily special [or consume it or other restaurant item]. |
retrieve | item | ensure that you have item, creating or buying it if needed. |
skeeball | [count] | squander Game Grid tokens at the broken Skeeball machine |
slime-stack* | show details of slime stacks disgorged by Slimeling | |
slimeling[?] | [either] item [, item]... | use/consume items |
smash | item [, item]... | pulverize specified items |
smith | [ item... ] | list creatables, or create specified items. |
speculate | MCD num | equip [slot] item | unequip slot | familiar type | up eff | uneffect eff | quiet ; [another;...] | predict modifiers. |
squeeze[?] | item | produce item by using another form, repeated as needed. |
stash | [put] item... | take item... | exchange items with clan stash |
sticker* | sticker1 [, sticker2 [, sticker3]] | replace worn stickers. |
storage | [param] | list indicated type of data, possibly filtered by param. |
tinker | [ item... ] | list creatables, or create specified items. |
wear | [list filter] | [slot] item | show equipment, or equip item [in slot]. |
whatif | unequip slot | familiar type | up eff | uneffect eff | quiet ; [another;...] | predict modifiers. |
wield | [list filter] | [slot] item | show equipment, or equip item [in slot]. |
zap | item [, item]... | transform items with your wand. |
Quests
Command Name | Arguments | Description |
---|---|---|
! | list the Dungeons of Doom potions you've identified. | |
bang | list the Dungeons of Doom potions you've identified. | |
baron | finds the baron in the Tavern. | |
chamber | automatically complete quest. | |
council | visit the Council to advance quest progress. | |
dusty | list the dusty bottles of wine you've identified. | |
entryway | [clover] | automatically complete quest [using a clover]. |
factory | report digits | Given a string of 7 dwarven digits, report on factory. |
gourd | automatically complete quest. | |
grandpa | query | Ask Grandpa about something. |
guardians | automatically complete quest. | |
guild | automatically complete quest. | |
hedge* | automatically complete quest. | |
insults | list the pirate insult comebacks you know. | |
leaflet | [nomagic] | location | command | complete leaflet quest [without using magic words]. |
maze | automatically complete quest. | |
nemesis | automatically complete quest. | |
poolskill | calculates your current pool skill | |
spookyraven | on | off | when enabled, tracks Lights Out all the time |
tavern | automatically complete quest. | |
telescope | [look] high | low | get daily buff, or Lair hints from your telescope. |
tower | automatically complete quest. |
Capitalism
Command Name | Arguments | Description |
---|---|---|
automall | dump all profitable, non-memento items into the Mall. | |
autosell | item [, item]... | autosell items. |
buy | item [@ limit] [, another]... | buy from NPC store or the Mall. |
cheapest[?] | [+]item [,[-]item]... [; cmds] | compare prices, do cmds with "it" replaced with best. |
expensive[?] | [+]item [,[-]item]... [; cmds] | compare prices, do cmds with "it" replaced with best. |
mallbuy | item [@ limit] [, another]... | buy from NPC store or the Mall. |
mallsell | item [[@] price [[limit] num]] [, another]... | sell in Mall. |
reprice | price all max-priced items at or below current Mall minimum price. | |
searchmall | item [ with limit number ] | search the Mall. |
sell | item [, item]... | autosell items. |
shop | put item [[@] price [[limit] num]] [, another] | take [all] item [, another] | put item into the mall or take from from mall. |
undercut | price all max-priced items at or below current Mall minimum price. | |
untinker | [ item... ] | complete quest, or untinker items. |
use[?] | [either] item [, item]... | use/consume items |
Mafia
Command Name | Arguments | Description |
---|---|---|
adv*[?] | last | [count] location | spend your turns. |
abort | [message] | stop current script or automated task. |
alias | [ word => expansion ] | list or create CLI abbreviations. |
ash | statement | test a line of ASH code without having to edit a script. |
ashq | statement | Like ash, but does not display the return value. |
ashwiki | searchText | perform search on KoLmafia Wiki. |
ashref | [filter] | summarize ASH built-in functions [matching filter]. |
backtrace | text | off | dump stack when a gCLI message or page URL matches text (case-sensitive). |
breakfast | perform start-of-day activities. | |
budget | [number] | show [or set] the number of budgeted Hagnk's pulls. |
buffbot | number | run buffbot for number iterations. |
call | [numberx] filename | function [parameters] | check/run script. |
ccs | [script] | show [or select] Custom Combat Script in use. |
cecho | color text | show text using color (specified by name or #RRGGBB). |
chat | switch to tab or open window | |
check | hp | health | mp | mana | both | attempt to regain some HP or MP. |
checkpoint | remembers current equipment, use "outfit checkpoint" to restore. | |
choice | [number|text] | list or choose choice adventure options. |
choice-goal | automatically complete quest. | |
clear | clear CLI window. | |
cls | clear CLI window. | |
condition* | add condition | set condition | modify your adventuring goals. |
condref | list conditions usable with if/while commands. | |
counters | [ clear | add number [title img] ] | show, clear, or add to current turn counters. |
debug | [on] | off | start or stop logging of debugging data. |
disable | all | command [, command]... | allow/deny CLI commands. |
events | [clear] | clear or show recent events. |
exec* | [numberx] filename | function [parameters] | check/run script. |
exit | logout and exit KoLmafia. | |
gc | force Java garbage collection. | |
garden | [pick] | get status of garden, or harvest it. |
gear | switch to tab or open window | |
get | preference [ = value ] | show/change preference settings |
goal* | add condition | set condition | modify your adventuring goals. |
graygui | [force] | print out a stack trace to help figure out why the UI might be gray/stuck (requires use of the JDK instead of the JRE). |
greygui | same as graygui | |
hatter | [hat] | List effects you can get by wearing available hats at the hatter's tea party. If parameter is provided, get the buff for that hat. (Using a potion if necessary.) |
help | [filter] | list CLI commands [that match filter]. |
item | switch to tab or open window | |
[jukebox] | song | listen to a song on your clan's jukebox. |
later | commands | adds a button to do commands to the Daily Deeds list. |
load | [numberx] filename | function [parameters] | check/run script. |
location | snarfblat loc | Adds a new location named loc with the snarfblat number specified. This does not persist across session. |
log | [status],[equipment],[effects],[etc.] | record data, "log snapshot" for all common data. |
logecho | timestamp | text | include timestamp or text in the session log only. |
login | username | logout then log back in as username. |
logout | logout and return to login window. | |
logprint | timestamp | text | include timestamp or text in the session log only. |
switch to tab or open window | ||
mood* | execute | repeat [numTimes] | moodName [numTimes] | mood management. |
neweffect | effect description ID | learn a new effect (add to database override) |
objective* | add condition | set condition | modify your adventuring goals. |
opt* | switch to tab or open window | |
timestamp | text | include timestamp or text in the session log. | |
priphea | launch KoLmafia GUI. | |
quit | logout and exit KoLmafia. | |
radio | switch to tab or open window | |
relay | open the relay browser. | |
refresh | equip | inv | storage | familiar | stickers | resynchronize with KoL. |
repeat | [number] | repeat previous line [number times]. |
run | [numberx] filename | function [parameters] | check/run script. |
save | as mood | add your current effects to the mood. |
session | [param] | list indicated type of data, possibly filtered by param. |
set | preference [ = value ] | show/change preference settings |
start | [numberx] filename | function [parameters] | check/run script. |
trigger* | [type,] effect [, action] | edit current mood. Options for type are gain_effect, lose_effect, unconditional |
unalias | word | remove a CLI abbreviation. |
update | data | clear | prices URL or filename | download most recent data files, or revert to built-in data. |
validate | [numberx] filename | function [parameters] | check/run script. |
verify | [numberx] filename | function [parameters] | check/run script. |
version | display KoLmafia version. |
Scripting
Command Name | Arguments | Description |
---|---|---|
<inline-ash-script> | embed an ASH script in a CLI script. | |
cecho | color text | show text using color (specified by name or #RRGGBB). |
colorecho | color text | show text using color (specified by name or #RRGGBB). |
echo | timestamp | text | include timestamp or text in the session log. |
else | ; commands | do commands if preceding if/while/try didn't execute. |
elseif | condition; commands | do if condition is true but preceding condition was false. |
if | condition; commands | do commands once if condition is true (see condref). |
namespace | [filter] | list namespace scripts and the functions they define. |
pause | [seconds] | pause script execution (default 1 second). |
try | ; commands | do commands, and continue even if an error occurs. |
using | filename | add ASH script to namespace. |
wait | [seconds] | pause script execution (default 1 second). |
while | condition; commands | do commands repeatedly while condition is true. |
Other
Command Name | Arguments | Description |
---|---|---|
*.php* | visit URL without showing results. | |
*mirror* | [filename] | stop [or start] logging to an additional file. |
aa | skill | set default attack method. |
attack | attack target [, target...] | PvP for items or fame |
autoattack | skill | set default attack method. |
ballpit | jump in your clan's awesome ball pit. | |
basement | check Fernswarthy's Basement status. | |
banishes | display information about current banishes. | |
burn | extra | * | num | -num | use excess/all/specified/all but specified MP for buff extension and summons. |
camp* | rest | etc. [numTimes] | perform campground actions. |
cast[?] | [ [count] skill [on player] ] | list spells, or use one. |
chips | type [,type [,type]] | buy chips from your clan's snack machine: radium, ennui, wintergreen |
clan | [ snapshot | stashlog ] | clan management. |
crimbotree | [ get ] | check [or get present from] the Crimbo Tree in your clan's VIP lounge |
csend | item [, item]... to recipient [ || message ] | send kmail |
demons | list the demon names you know. | |
donate | boris | mus | jarl | mys | pete | mox amount | donate in Hall of Legends. |
drink[?] | [either] item [, item]... | use/consume items |
effects | [param] | list indicated type of data, possibly filtered by param. |
enable | all | command [, command]... | allow/deny CLI commands. |
encounters | [param] | list indicated type of data, possibly filtered by param. |
entity | give details of your current pastamancer combat entity. | |
enthrone[?] | species | place a familiar in the Crown of Thrones. |
familiar[?] | [list filter] | lock | unlock | species | none | list or change familiar types |
fax | send | put | receive | get | use the fax machine in your clan's VIP lounge |
faxbot | [command] | send the command cmd to faxbot |
field | [ plant square type | pick square | harvest ] | view or use your mushroom plot |
flowers | commit random acts of PvP. | |
forum* | visit the official KoL forums. | |
friars | [blessing] food | familiar | booze | get daily blessing. |
galaktik | (hp | mp) [amount] | restore amount or all hp or mp |
hiddencity | square [temple | altar item] | set Hidden City square [and perform an action there]. |
holiday | HolidayName | enable special processing for unpredicted holidays. |
hottub | soak in your clan's hot tub | |
http:* | visit URL without showing results. | |
ingredients | item [, item]... | get ingredients or recipe for items |
kmail | item [, item]... to recipient [ || message ] | send kmail |
locations | [param] | list indicated type of data, possibly filtered by param. |
lookup | item | effect | go to appropriate KoL Wiki page. |
mcd | number | set mind control device (or equivalent) to new value. |
mind-control | number | set mind control device (or equivalent) to new value. |
moleref | Path of the Mole spoilers. | |
monsters | location | show combat details for the specified area. |
moon* | [param] | list indicated type of data, possibly filtered by param. |
mpitems | counts MP restoratives in inventory. | |
nuns | [mp] | visit the Nunnery for restoration [but only if MP is restored]. |
olfact* | ( none | monster name | [item] list | goals ) [abort] | tag next monster [that drops all items in list, or your goals]. |
panda | temple | comedy type | arena bandmember item | interact with NPCs in Pandamonium |
pool | type [,type [,type]] | play pool games in your clan's VIP lounge |
putty | ( none | monster name | [item] list | goals ) [abort] | tag next monster [that drops all items in list, or your goals]. |
pvp | [attacks] ( flowers | loot | fame ) [muscle|myst|moxie|ballyhoo] | commit random acts of PvP [using the specified stance]. |
pvplog* | summarize PvP results. | |
raffle | ticketsToBuy [ inventory | storage ] | buy raffle tickets |
recipe | item [, item]... | get ingredients or recipe for items. |
recover* | hp | health | mp | mana | both | attempt to regain some HP or MP. |
remedy[?] | effect [, effect]... | remove effects using appropriate means. |
restore* | hp | health | mp | mana | both | attempt to regain some HP or MP. |
safe | location | show summary data for the specified area. |
send | item [, item]... to recipient [ || message ] | send kmail |
shower | cold | ice | cool | moxie | lukewarm | mysticality | warm | muscle | hot | mp | take a shower in your clan's VIP lounge |
shrug[?] | effect [, effect]... | remove effects using appropriate means. |
skill[?] | [ [count] skill [on player] ] | list spells, or use one. |
skills | [param] | list indicated type of data, possibly filtered by param. |
sleep | number | rest on your clan sofa for number turns. |
soak | soak in your clan's VIP hot tub | |
sofa | number | rest on your clan sofa for number turns. |
spade | [prices URL] | submit automatically gathered data. |
status | [param] | list indicated type of data, possibly filtered by param. |
steal | [attacks] ( flowers | loot | fame ) [muscle|myst|moxie|ballyhoo] | commit random acts of PvP [using the specified stance]. |
styx | muscle | mysticality | moxie | get daily Styx Pixie buff. |
summary | [param] | list indicated type of data, possibly filtered by param. |
summon | demonName | effect | location | number | use the Summoning Chamber. |
swagger | commit random acts of PvP. | |
swim | laps | ml | sprints | noncombat | work out in your clan's VIP lounge swimming pool |
text | URL | show text results from visiting URL. |
train | base weight | buffed weight | turns number | train familiar. |
uneffect[?] | effect [, effect]... | remove effects using appropriate means. |
unequip | slot | name | remove equipment in slot, or that matches name |
up? | effect [, effect]... | extend duration of effects. |
wiki | searchText | perform search on KoL Wiki. |
win | game | I'm as surprised as you! I didn't think it was possible. |