IRC search bot documentation
The bots:
- Natsune: Legend of the Five Rings
- Taocheng: Doomtown
- Adnan: Legend of the Burning Sands
Basics
To send commands to the bot, /msg or say them on the channel the bot is in.
Please use the /msg command unless there is a need to show others on the
channel the card text.
The basic search is to just send the card name to the bot. For example:
- /msg natsune mercy
- /msg natsune toturi exp2
- /msg natsune toturi
- /msg natsune 'toturi'
- /msg natsune fu leng
- /msg natsune fu%leng
- /msg natsune kamoko
- /msg natsune '%kamoko'
As you can see, it tries to match anything it can. To distinguish cards that
are similar, you must specify a more exact name, or use single quotes (')
around what you are searching for to make it an exact search.
You can also see the use of % as a wildcard to match any set of characters.
This is extremely useful and much faster (and easier for us lazy typists).
More advanced searching
Before we start this, you might want to check the web
interface first. Advanced searches are a little tougher and programming
experience helps a lot.
format: which TYPE have EXPR
TYPE is the type of card (cards, actions, items, etc.)
EXPR is a search expression.
Search expressions are of the form:
COLUMN operator VALUE [ BOOLEANOP EXPR ]
COLUMN: A component of the card.. such as cost, text, or something else. See the web interface for available columns.
VALUE: Value to check for. Numbers are just nubmers ( 10 ), but text strings must be contained in single quotes (').
operator: Action to perform: < > = like regexp
BOOLEANOP: you can string expressions together using AND and OR operations (parenthesis work as well)
Examples:
- which personalities have chi > 3 and cost < 5 and text like '%justicator%'
- which cards have text regexp '(green|blue)'
- which cards have force > 7
- which cards have force=0 and chi < 3 and ( (cost=7 and edition='FK') or (cost=11 and edition='AD')) and text not like '%advisor%'
- which cards have text like '%bow%stronghold%'
As you can see this can be very powerful, yet very complicated. Note that
like is a case insensitive search where regexp is case sensitive.
(regexp is also a regular expression search. If you don't know what a regular
expression is, you probably don't need to use regexp).
Search Options
page=# if you are getting a search that gives back a [MORE], use this to list the other pages of the search. (which cards have force>6 page=2)
all vers Not fully implemented yet.
Other commands
bug: using this with a message following will log the message. Use this for reporting problems, card typos, etc. (or send email to: natsune -AT- toysmakeuspowerful.com).
help: this command can give you some basic help menus.
what is the best clan: randomly says a clan. Use to pick new deck to make. (outfit or faction for doomtown/lbs)