PBeM 服务器命令使用大全

简介

　　这篇文档记述了在PBeM服务器上进行比赛的命令用法，有些比赛可能用到一些其他命令或可选项，这些都在每盘比赛的帮助页中有记述，规则和棋子符号也有描述。

句法

　　粗体字应该用一个适当的值替换，例如：

userid 应该用一个pbem用户名（一般是你自己的用户名）来代替。
password 应该用对应你的用户名的密码来代替。
board 应该用一盘比赛的编号来代替。

　　多数命令的开始单词 game 应该用pbem比赛之一的名称来代替。

　　[ 方括号 ] 中的单词可选项。

　　如果有多个可选项，可以用下列几种方式说明：

在方括号中用 [ ... 省略号 ] 表示；
一个词与一个加号 word+ 表示可列出多于1项。
一个词与一个星号 word* 表示可列出多于0项。

命令摘要

help [ subject [ ...subject ] ]
signup userid password [ e-mail address(es) ]
add userid password [ e-mail address(es) ]
change password userid current-password new-password
change address userid password [ e-mail address(es) ]
signoff userid password
delete userid password
list [ game-type-1 [ ... game-type-N ] ]
message userid password toUserid1 [ ... toUseridN ]
broadcast userid password
multiple
all show userid [ next | active ]
game help
game standings
game ratings
game games userid* [ all | active | inactive | next ]
game show board[#moveno]+
game show userid+ [ all | active | inactive | next ]
game showas userid password [ board+ | all | active | inactive | next ]
game challenge userid1 userid2 [ -options ]
game move board userid password move[#moveno]
game move board userid password pass[#moveno]
game move board userid password swap[#moveno]
game move board userid password propose
game move board userid password undo
game move board userid password accept
game move board userid password reject
game move board userid password resign
game resign board userid password
game chat board userid password
game submit board userid password move[#moveno]
game confirm board userid password
game preview board move+
game preview new numplayers [ -options ] move+
game subscribe userid password board+
game unsubscribe userid password board+
game limit userid password [ number ]
game seek userid password [ number ]
game accept userid password
game reject userid password
game notify userid password

　　每条命令应放在寄给PBeM服务器(pbmserv@gamerz.net)的邮件信息的主题中。响应时间通常很快(不会超过邮件往返时间)，如果pbem服务器没有对命令做出回应，你也总能接收到一条信息(除非出现错误)，你可以用一条简单的命令“help”试一下，看看系统是否掉线。如果pbem服务器对“help”做出反应，而其他命令仍然得不到回应，那大约就是出了故障。请再试一次或向 rrognlie@gamerz.net 咨询以求得帮助。

命令详解

help [ subject [ ... subject ] ]

　　发出被请求的主题的帮助。如果没有被请求的主题，则发送“摘要”页。如果你请求一条非法主题(例如“help me”)，你将收到一个可用的帮助主题列表。

管理命令：

signup userid password [ e-mail address(es) ]
或者
add userid password [ e-mail address(es) ]

　　加入你到 PBeM 服务器中。在允许你参加任何 PBeM 比赛前你必须确认条款。userid 是不包括冒号(:)、空格( )或引号(")的任何次序的字符，password 也一样。如果你有多个 E-Mail 地址，或有一个特别中意并希望所有 PBeM 邮件发到的帐号，可在密码之后指出来。否则，PBeM 服务器将默认按你注册请求的寄信地址寄送所有 PBeM 邮件。

　

change password userid current-password new-password

　　这条命令允许你更改你的 PBeM 密码。你可能要定期这么做。PBeM 服务器用密码让你独享自己的功能。(用明码字符存储这些密码，所以你不要用你注册的帐号来做密码！)

　

change address userid password [ e-mail address(es) ]

　　这条命令允许你更改你的 PBeM 服务器邮件地址。PBeM 服务器发出的任何邮件正常将发送到这个地址。如果没有指定地址，PBeM 服务器将默认按你注册请求的寄信地址寄送所有 PBeM 邮件。

　

signoff userid password
或者
delete userid password

　　当你确定要废弃你的帐号或者认为没有足够的时间玩这些无聊的游戏时，可以注销你的用户帐号，把资源让给其他棋手。

综合命令：

list [ game type 1 [ ... game type N ] ]

　　列出指定的比赛类型情况。如果没有指定比赛类型，将显示PBeM用户的列表。出于保密考虑，列表只显示他们的PBeM用户名。

　

message userid password toUserid1 [ ... toUseridN ]

　　如果你要发一条信息给PBeM用户，但没有他们的Email地址，你可以通过PBeM服务器发出。

　

broadcast userid password

　　如果你要发一条信息给所有PBeM用户，用这个命令。请限定使用广播给所有棋友发不感兴趣的话题。你可以使用PBeM服务器邮件列表群发(pbmserv-users@gamerz.net)作为一个轮换广播命令。请把你的PBeM用户名包含在你的信息中，这样人们就可知道应该把他们的答复寄给谁。

　

multiple

　　多重命令将说明主体每行信息做为一个PBeM命令。缩进行作为前述PBeM命令的一条注释(信息主体)来发送。例如：主体

To: pbmserv@gamerz.net
Subject: multiple

tanbo3d move 2734 alibaba sesame 123
  Bet you weren't expecting that!
  Are you ready to resign yet?
spangles move 1234 alibaba sesame resign
  You win some, you lose some...

　

all show userid [ next | active ]

　　所有命令都用来给全部 pbem 服务器发送同样的命令。原则上使用全部命令是指服务器把目前你的对手的所有比赛棋局(“all show user next”)，或者你正在进行中的所有棋局(“all show user active”)寄给你。

信息命令：

game help
或者
help game

　　这条命令对指定的比赛发送一般的帮助文件。

　

game standings
或者
game ratings

　　显示当前的排名。

　

game games userid* [ all | active | inactive | next ]

　　在服务器上列出比赛。如果使用“active”，只列出所有参赛棋手还没有结束的比赛。相对的如果为“inactive”，“next”将列出下一步走棋的棋手之一的比赛。

　

game show board[#moveno]+ [ -t ]
或者
game show userid+ [all | active | inactive | next ] [ -t ]

　　显示棋盘。指定要显示那些详细盘面的一盘或多盘棋的数目。指定要显示那些棋手用户之一所有盘面的一个或多个用户名。“active”修饰词将只显示还没有结束的比赛。“inactive”只显示已经结束的比赛。“next”只显示下一步该走棋的指定用户的比赛。
　　如果命令中包含“-t”或“--time”选项，将使每位棋手使用的时间和总时间包括在内。“-t”或“--time”选项也可以用于要显示的盘面的任何命令，例如“showas”、“all show”，或“preview”。当使用“challenge”命令时，时间将包含在每盘棋中。
　　棋子数码可以随意附加到盘号，用一个#号分开。这将显示走棋时间的盘面状态。注意：这不能使用在全部比赛！

　

game showas userid password [ board+ | all | active | inactive | next ]

　　从用户的观点显示盘面。这对隐藏信息的比赛是有用的。

下棋命令：

game challenge userid1 userid2 [-options]

　　在用户1和用户2之间新开始一盘棋。显示支持多于2个棋手的比赛，或带主要可选参数 Some games support more than 2 players, or optional parameters with a leading dash. The help for the specific game will describe any game-specific functionality.

game move board userid password move[#moveno]

Make a move. The format for the move string is described on the help page for the specific game.

The move number may optionally be appended to the move string with a # separator. The move will then be accepted only for the given move number. This may be useful if your email is flaky and you are worried about messages being lost or delayed arriving later at the wrong time.

game move board userid password pass[#moveno]
or
game move board userid password --[#moveno]

If the game allows it, pass your turn. Make no move.

game move board userid password swap[#moveno]
or
game swap board userid password

If the game support swapping at a certain point during the game, this command will swap sides.

game move board userid password propose

Propose a draw. All players must "accept" the proposal.

game move board userid password undo

Request to undo a move. All players must "accept" the undo.

game move board userid password accept

If a draw has been proposed, accept the draw.
If an undo has been requested, accept the undo.

game move board userid password reject

If a draw has been proposed, reject the draw.
If an undo has been requested, reject the undo.

game move board userid password resign
or
game resign board userid password

Resign the current game. If this is the first action from that player in the game, he leaves play (without penalty) and if more than one player is left, the game is restarted without the player. If it is not the first action from that player, he will leave the game and the remaining player will continue playing. If only one player is left, that player will win the game.

game chat board userid password

Sends the message in the body of the mail to all players and subscribers.

game submit board userid password move[#moveno]

Preview a move. The move will be stored with the board and can be effectuated by using the move command without supplying a move. Submitting several different moves will only keep the last one.

game confirm board userid password

Confirm the last submitted move (and make it). Submit + confirm is equivalent to using move.

game preview board move+
or
game preview new numplayers [-options] move+

Make the move(s) on a given board (or a new one). The moves are not saved. The resulting board will be sent back. The "preview new" command will accept any -options which are acceptable to the game's "challenge" command.

• Games with simultaneous movement (e.g. ToW) or hidden information (e.g. DarkChess) will not allow submit, confirm, and preview commands.

Subscribing Commands:

game subscribe userid password board+

Start subscribing a specific board. Whenever one of the players issue a valid move, the new board will be sent to players who subscribe in addition to those players who participate.

game unsubscribe userid password board+

Unsubscribe a board that was previously subscribed.

game limit userid password [ number ]

Limits the number of active games you may have. If you have the specified number of active games, any additional challenges will be automatically rejected. Instead of a number, you may also use the word "reject" to reject all games, or "accept" to accept all games. If the number parameter is omitted, your current limit will be reported. The limits for other players are reported by the standings command.

game seek userid password [ number ]

Sets the number of games you are currently seeking. This number will show up on the standings to let other players know you are currently seeking games. Each time you are challenged or make a challenge, the number will be decreased by one.

game accept userid password

Allow other players to challenge you.

game reject userid password

Disallow other players to challenge you.

game notify userid password [ board+ ]

Notify is similar to the subscribe command but instead of getting a copy of the board after each and every move, the boards are shown after the game ends. The notify will fail if 1) the board does not exist, 2) the board is already completed, 3) you are a player on the board, or 4) you are already subscribed or notified on the board.

If no board number is given, you will be notified whenever any board ends. This is mainly useful for archiving games. Sending a new non-board notify command will stop this type of notification.

Messages to your opponent

When you use the challenge, move, resign, or chat commands, any text in the body of your mail message will be sent to your opponent along with the board summary.

You may also send messages to other PBeM users via the message and broadcast commands.