next up previous contents
Next: simabort Up: Game and Analysis Commands Previous: resign


  Usage: seek [time inc] [rated|unrated] [white|black] [wild #] [atomic] [auto|manual] [formula]

The seek command allows you to post an advertisement for a chess game of the specified type. The various parameters of the seek command are as follows:

time minutes to start with for each player [default: your Time variable setting]
inc seconds added to each clock per move [default: your Inc variable setting]
rated/unrated type of match; may be abbreviated by r and u [default: your Rated variable setting]
white/black designated color you will have; may be abbreviated by w and b [default: no color specified]
wild # wild chess variant, if any, such as wild 1, wild 2, wild fr, etc.; a shortcut for wild # is w#, but wild fr has no shortcut [default: regular chess]
atomic atomic chess variant [default: regular chess]
auto/manual indicates whether a game will start automatically when the ad is responded to, or if the person who placed the ad has the option to decline responses; may be abbreviated by a and m [default: auto start]
formula indicates whether your formula will used to screen responses to your ad; may be abbreviated by f [default: formula is not checked]

Note: If settings for time, inc or rated/unrated are not given, your variables settings will be used.
Example A: if your variables settings have Time = 5, Inc = 0, and rated = 0 then typing seek would be the same as typing seek 5 0 u.
Example B: if your variables settings have Time = 5, Inc = 12, then typing seek 2 would be the same as typing seek 2 12.

When you place an ad, it will be displayed to users in this general format:

Hawk(2700) seeking 5 0 rated blitz [white] m ("play 2" to respond)


  1. Who will see my ad when it is posted?
    To have your ad displayed to a user the moment you make it, the other user must have his/her seek variable set to 1 and the ad must agree with his/her formula (see help formula). Otherwise, users can type sought to display current ads (see help sought).
  2. How can I see ads displayed?
    There are two ways:
    1. type set seek 1 and see ads displayed when they are created (type set seek 0 to cancel these postings);
    2. type sought to display current ads for which are you eligible (see help sought).
  3. How many ads can I place at once?
    This value is set in the server code when it is compiled. To see the current limit for active seek ads, type limits.
  4. How can I see my own ad?
    You need to type sought all (see help sought).
  5. How do I withdraw an ad I have placed?
    Use the unseek command.
  6. How do I respond to an ad?
    Use the play command (see help play).
  7. What happens to my open variable when I post an ad or respond to an ad?
    Nothing. The value for your open variable does not change. For example, you can have open=0 but still place ads and respond to them.
  8. What does the manual option do exactly?
    When you place a seek ad using manual start and a user responds to your ad, you will be sent a match request. You will then have the option of accepting or declining that user's offer to play your advertised match.

See also: formula, limits, match, play, sought, unseek, variables, wild

next up previous contents
Next: simabort Up: Game and Analysis Commands Previous: resign

Klaus Knopper <>