北大侠客行MUD论坛

 找回密码
 注册
搜索
热搜: 新手 wiki 升级
查看: 54188|回复: 35

TinTin++中文手册

[复制链接]
发表于 2013-9-24 12:58:04 | 显示全部楼层 |阅读模式
本帖最后由 alucar 于 2013-10-17 08:22 PM 编辑

工欲善其事,必先利其器。在红衣影响下,从zmud转投tt门下已有一段时间了,但百度中至今没有搜到TinTin++的中文手册,一时兴起也做一回翻译,希望能降低一些tt的上手难度。

一些说明:
1、tt的主页为tintin.sourceforge.net,后面的内容均译自该站,但目前似乎被墙了,可能需要翻一下。
2、目前的翻译版没有与原作者联系,如今后涉及版权等问题,必要时可能删除。
3、原文中的一些例子均按北侠的环境作了本地化调整。
4、大部分指令在wintin++ 2.00.9环境下测试。
5、翻译不当之处还请指正。

目录:
2楼:概述
3楼:Action, Alias, All, Bell, Break, Buffer, Case, Chat, Class, Color
4楼:Commands, Config, Continue, Cr, Cursor, Debug, Default, Delay, Echo
5楼:Else, Elseif, End, Escape Codes, Event, Forall, Foreach, Format, Function, Gag
6楼:Greeting, Grep, Help, Highlight, History, If, Ignore, Info, Keypad, Kill
7楼:Line, List, Log, Loop, Macro, Map, Math, Mathexp, Message, Name
8楼:Nop, Parse, Path, Pathdir, Prompt, Read, Regexp, Repeat, Replace, Return
9楼:Run, Scan, Script, Send, Session, Showme, Snoop, Speedwalk, Split, Substitute
10楼:Suspend, Switch, System, Tab, Textin, Ticker, Variable, While, Wildcards, Write, Writebuffer, Zap
北大侠客行Mud(pkuxkx.com),最好的中文Mud游戏!
 楼主| 发表于 2013-9-24 12:58:25 | 显示全部楼层
本帖最后由 alucar 于 2013-9-25 08:11 AM 编辑

TinTin++ Mud客户端手册


本章节是对TinTin++的一个简要使用说明,更多的帮助信息可以查询每个命令的帮助文件。


启动与关闭TinTin++


TinTin++的启动命令是:./tt++ [命令文件] (译注:对于windows平台下的wintin++,安装后直接点图标启动即可)


有关命令文件的信息可以查询后面的专门章节。有必要说明的是,在TinTin++启动时加载的触发、别名等都会被所有的session继承。


在任意空行输入#end或按下^d将会退出TinTin++,被选中的文字将自动复制到剪贴板,你可以按下shift+insert进行粘贴操作。


基本特点


让我们从一些非常基本但也十分重要的开始:


所有TinTin++的命令都以“#”号开始。(你可以用#config更改)


例子:#help——#help是一个客户端命令,不会被发送到服务器。


所有TinTin++的命令都可以缩写。


例子:#he——输入#he与输入#help是等效的。


所有命令都可以用“;”号分隔。


例子:n;break men;enter;killall——连续执行这四个命令


有三种方法可以让";"号作为一个普通字符出现。


例子:\say Hello;) ——“\”号开始的行中,所有特殊字符都只作为普通字符出现。


例子:say Hello\;) ——在一行中间出现的“\”号可以强制让后一个字符作为普通字符出现。


例子:#config verbatim off ——设置后,除了以"#"号开头的语句,其他的都会以原貌被发送到服务器。


帮助文档


命令:#help {主题}


help命令是你最好的朋友,输入#help可以看到所有的帮助主题,而且内置的帮助文档总会比主页上的更加新一些。


连接到一个mud


命令:#session {session名称} {mud地址} {端口}


例子:#session alucar pkuxkx.com 8080


你可以打开多个session,并且用#名称>进行切换。


你可以用#session命令显示所有已经打开的session清单,其中标记(active)的为当前活动的session,标记(snooped)的为正在观察的session,标记(mccp)的为使用mud客户端压缩协议的sessionmud client compression protocol)。


分屏


命令:#split


#split命令可以将屏幕分割为输入区与输出区。


使用#prompt命令可以捕捉并将特定信息显示在分屏栏上,#unsplit命令可以取消分屏。


别名


命令:#alias


语法:#alias {别名名称} {命令}


#alias命令用于定义别名,别名的参数可以用%0%1……%9来引用,具体如下:

%0代表所有参数;

%1代表第一个参数;

……

%9代表第九个参数。


例子:#alias ga get all from %1


如果定义别名时没有指定参数,在使用别名时,后续内容会自动添加到别名代表的命令之后。


例子:#alias tan perform throwing.tan——tan pantu相当于perform throwing.tan pantu


要在一个别名内执行多个命令,需要使用花括号。


例子:#alias pu {exert qi;exert powerup}


#unalias命令可以删除一个已定义的别名。


注意:TinTin++在冗错方面并没有提供婴儿式的服务,比如没有对别名进行循环引用的校验。你可以利用"\"号来避免循环引用。


例子:#alias put \put %1 in %2


或者也可以使用#send命令。


例子:#send put %1 in %2


触发


命令:#action


语法:#action {触发语句} {命令}


#action命令将生成一个触发,当特定的信息出现时,自动执行指定的命令。在触发语句中最多可以使用99个变量,以通配符%1%2……%9%10……%99表示。


例子:


#action {你舔了舔干裂的嘴唇,看来是很久没有喝水了。} {drink jiudai}


#action {%1走了过来。} {hihi} ——当有人走过来的时候打招呼。


#action {%1告诉你:%2} {say %2} ——把别人tell你的内容say出来。


#action {看起来%1想杀死你!} #bell ——当有人想杀死你的时候发声提示。


#ignore action on命令可以暂时关闭所有的触发。


#debug action on命令可以让触发生效时显示所执行的命令。


#unact命令可以删除已定义的触发。


高亮显示


命令:#highlight(还记得你可以使用命令的缩写形式么?)


语法:#high {文本} {颜色}


这个命令的用法与#action很象,它的功能是用你指定的颜色来显示服务器输出的特定内容,相当于#substitute命令的简化版。


例子:


#high {烈火鞭} {light red} ——烈火鞭三个字以亮红色显示。


#high {%1烈火鞭%2} {light red} ——将包含烈火鞭三个字的整行文字以亮红色显示。(译注:经测试这条命令不起作用。)


#unhigh命令可以删除已定义的高亮显示。


快速行走


如果输入一个只由数字和方向(n,e, s, w, u, d)组成的命令,那么这个命令会被解释为一个快速行走命令。


例子:ssw2n相当于go south, south, west, north,north


如果你在输入一些确实只包括上面这些字母的命令时遇到了麻烦——比如news指令就可能被当作一个快速行走命令——你可以尝试用大写字母进行输入。(译注:用大写字母在部分中文mud中是不可行的,只能用下面提到的办法关闭快速行走。)


在使用快速行走功能前,必须首先设置#config speedwalk on/off


定时器


命令:#ticker {名称} {命令} {秒数}


在北大侠客行和其他一些mud里每15分钟会刷新固定npc和物品,所以如果能知道离下一次刷新还有多少时间是一件很棒的事,TinTin++可以帮助你做到这一点。


#ticker {tick} {#delay 840 #show 还有一分钟刷新!;#show 刷新啦!!!} {900}


上面这条命令将会生成一个名为tick的定时器,每15分钟显示刷新啦!!!,并且在刷新前一分钟会给出即将刷新的提示。


#untick命令可以删除定时器。


命令文件


当读取一个命令文件的时候,TinTin++将执行该文件中的所有命令。你可以用命令文件来保存别名或触发,登录到一个mud(包括输入id与密码),它最基本的功能就是保存各种命令。


我强烈建议你使用一个文本编辑器来编写命令文件,当然你也可以使用#write命令把当前的设置保存到一个命令文件中。


文件操作命令:


#read 文件名 ——读取并执行一个命令文件。


#write 文件名——将当前session中所有已知的触发/别名/替换等内容写入一个命令文件。


重复执行


你可以使用"#数字 命令"这样的语句来重复执行一个命令。


例子:


#5 e ——向东走五步。

#10 {fill jiudai;put jiudai in bag} ——重复执行这两个命令十次。

#100 chat* poke ——如果你不怕被禁言的话。


历史命令


TinTin++拥有历史命令回溯功能。


! ——重复上一个命令。

!get ——重复上一个以get开头的命令。

ctrl-r ——进入历史命令搜索模式。


路径


当你输入#path new命令后,TinTin++将会开始记录你输入的移动指令——比如northsoutheastwestupdown——并把记录的指令保存在一个路径里,同时生成相应的逆向路径。


路径命令:


#path new ——重置当前路径并开始记录新的路径。

#path end ——停止记录路径。

#path map ——显示当前路径。

#path ins {forward} {backward} ——在当前路径的最后插入移动指令,{forward}{backward}参数分别为所插入移动指令的正向与逆向。

#path del ——删除当前路径的最后一步。

#path save {forward|backward} {variable} ——将当前路径保存到变量中,{forward|backward}参数指定保存正向/逆向路径。

#path load {variable} ——从变量中读取路径。

#path walk {forward|backward} ——按照当前记录的路径行一步,{forward|backward}参数指令按正向/逆向行走。(译注:每次行走后会删除当前步的内容,所以不能交替使用正向/逆向行走。)


记录路径时的一个有用的触发:

#action {哎哟,你一头撞在墙上,才发现这个方向没有出路。} {#path del}


当当当~下面举一个具体的例子:

比如你想要弄一本飞沙走石十三式,那么你可以在扬州中央广场输入#path new,然后去找田伯光,办完事回来的时候只要输入#path save backward tmp;$tmp就行了。当然,其实这点路自己走回来也比输入这么一串命令要快,但是……好吧,这只是个例子。


(译自tintin.sourceforge.net,by alucar@pkuxkx.com

北大侠客行Mud(pkuxkx.com),最好的中文Mud游戏!
 楼主| 发表于 2013-9-24 12:58:29 | 显示全部楼层
本帖最后由 alucar 于 2013-10-5 08:07 PM 编辑

Action


语法:#action {触发语句} {命令} {优先级}


#action命令可以对mud服务器发来的特定信息作出回应,并执行一条或多条命令。在触发语句和命令中可以使用%1~99这样的变量,用于替代指定的内容。“优先级”参数是可选的,它决定了这个触发语句生效的优先权,默认值为5


颜色触发语句以“~”号开头,你可以用#config {convert meta} on命令打开颜色代码显示,以便于制作颜色触发。


TinTin++“^”号匹配行首触发,“$”匹配行尾触发。


以下内容适用于正则表达式。


在触发语句中使用%1%2……%99可以实现模糊匹配,模糊匹配的内容将被存入变量,并在触发命令中相应地通过%1%2……%99进行调用。%0比较特殊,它包含所有的匹配内容。除非你在触发语句中直接使用了%0,在这种情况下,%0就与%1一样了。


Using { } will embed a Perl CompatibleRegular Expression, available at the next available numeric variable, startingout at %1.

运用{ }可以在匹配语句中使用一个与Perl语言兼容的正则表达式,并通过%1这样的变量来调用。


[ ] . + | ( ) ? * are treated as normaltext unlessed used within braces. Keep in mind that { } is replaced with ( ).

在触发语句中,[ ] . +| ( ) ? * 这些符号通常被当作普通文本处理,但在{ }内出现时除外。同时需要注意的是,此时将{ }( )代替。

(译注:以上关于正则表达式的内容本人没有仔细研究过,也未曾实际使用,不能保证翻译的准确性,因此附上原文供参考)


下面是一些常用的通配符:


  %w 匹配0到任意个字母。

  %W 匹配0到任意个非字母。

  %d 匹配0到任意个数字。

  %D 匹配0到任意个非数字。

  %s 匹配0到任意个空格。

  %S 匹配0到任意个非空格。


  %? 匹配01个字符。

  %. 匹配1个字符。

  %+ 匹配1到任意个字符。

  %* 匹配0到任意个字符。


  %i 匹配时不区分大小写。

  %I 匹配时区分大小写(默认)。


例子:#action {%1(%2)告诉你:%3} {tell %2 我是机器人,啦啦啦~}


在使用%d%*这种不带数字的变量进行触发配置时(译注:相对于%1%2这样的),引用的时候需要按照其出现的顺序,在上一个数字形式的变量基础上+1。(译注:这段比较绕,对照下面的具体例子会更加清楚一些)


例子:#action {%*(%w)告诉你:%*} {tell %2 目前afk;say %2 告诉我 %3}

例子:#action {%3(%4)告诉你:%*} {tell %4 目前afk;say %4 告诉我 %5}


对于一些采用常规方式难以匹配的语句,可以利用“~”号来制作一个颜色触发。输入#configconvert on可以查看mud输出的颜色代码。


例子:#action {~^\e[1;37m%1} {#showme {这是以白色粗体显示的文字:%1}}


触发对#showme命令显示的内容有效。


注:#unaction命令可以删除触发。


如果要删除一个以%*为内容的触发,你需要使用#unaction {%%*}命令。然而,#action {%*} {command}这样的触发是比较危险的,更好的方法是将这个触发放到一个类里,当你不再需要它的时候,就删除这个类。通过这种方式,你可以避免在使用#unact {%*}时误删所有的触发。


Alias


语法:#alias {别名名称} {命令}


#alias命令主要用于缩写一些比较长的指令或者是常用的指令。变量%1~99%可以用来引用别名的参数,分别代表别名命令后的第1个至第99个参数。


%0可以用来引用所有的参数,如果别名的命令部分只有一个单词,变量会自动添加到命令之后。


例子:#alias {k} {kill %1;exert yihun}

输入 k pantu 就会对慕容叛徒叫杀并运用九阴神功的移魂大法busy对手。


你可以在别名的名称部分使用变量以制作一些更加复杂的别名,在这种情况下变量的使用方式也会有所变化。


例子:#alias {k%1 with %2} {unwield all;wield %2;kill %1;perform hammer.wushuai}

使用上面这个别名时你就需要输入 k robber with hammer 这样的命令。


如果你想要一个能匹配所有输入内容的别名,你可以将别名的名称定义为%*


例子:#alias {%*} {#showme 你输入的内容是:%0}

注:你可以使用#unalias命令删除别名。


如果要删除一个以%*为名称的别名,你需要使用#unalias {%%*}命令。然而,更好的方法是将这个别名放到一个类里,当你不再需要它的时候,就删除这个类。通过这种方式,你可以避免在使用#unalias {%*}时误删所有的别名。



All


语法:#all {命令}


如果打开了多个session,你可以使用#all将一条命令同时发送到所有的session中。


例子:#all quit ——关机了,洗洗睡了。


Bell


语法:#bell


这个命令的作用就是让你的电脑响铃一声。但这个命令已经过时了,最好避免使用,作为替代,你可以用#show {\a}命令向系统发出一个响铃控制符。


例子:#action {【江湖传闻】江湖又暂时恢复了表面的宁静} {#showme {\a}}

当你不能保证每时每刻都面对屏幕,但又不想错过系统更新的时候,这个命令就很有用了。如果觉得系统铃声太过单调,你也可以用#system命令来播放一段合适的音乐。


在一些终端里你可以使用VT100操作系统的命令来改变终端程序的标题行名称,这也是一种可视化的提醒方法。


例子:

#action {【江湖传闻】江湖又暂时恢复了表面的宁静}

{

       #showme {\e]1;更新啦~\e\\};

       #delay 10 #showme {\e]1;TinTin++ MUD client\e\\};

};

(译注:以上例子未进行测试)



Break


语法:#break


#break命令用于跳出#foreach#loop#parse#switch,以及#while这些命令的循环进程。当执行#bradk命令时,TinTin++会直接跳到上述这些循环命令的后一条指令并执行下去。


例子:

#math cnt 0;

#while {1}

{

       #math cnt $cnt+1;

       #if {$cnt==2} {#break};

};


Buffer


语法:#buffer {home|up|down|end|find|get|lock|write|info}


#buffer命令可以通过不同的参数对缓冲区的显示内容进行操作。


#buffer {home}


移动到缓冲区的开始处并显示页面内容,同时锁定滚动条,推荐在宏键中使用。


#buffer {up}


将缓冲区上翻一页并显示页面内容,同时锁定滚动条,推荐在宏键中使用。


#buffer {down}


将缓冲区下翻一页并显示页面内容,同时锁定滚动条,推荐在宏键中使用。


#buffer {end}


移动到缓冲区的结尾处并显示页面内容,同时解除滚动条锁定,推荐在宏键中使用。


#buffer {find} {[序号]} {<内容>}


在缓冲区里查找指定的内容,<内容>可以使用正则表达式,[序号]是可选项,表示查找第几个指定的对象。


#buffer {get} {<变量名>} {<下界>} {[上界]}


将缓冲区的一行或多行内容(包括颜色代码)保存到一个变量中,下界与上界必须在1到缓冲区的总行数之间。如果省略上界,那么指定行的内容将被保存到一个标准变量中。如果给定上界,那么上下界之间的内容将被逐行保存到一个list变量中。


#buffer {lock}


锁定滚动条或解除锁定。当滚动条被锁定时,新的mud信息不会被显示。输入任意命令将解除锁定状态,当然,有一些缓冲区操作指令会重新锁定滚动条。当解除锁定后,窗口会移动到缓冲区的底部并显示相应的页面。


#buffer {write} {<文件名>}


将缓冲区的内容写入指定的文件。


#buffer {info}


显示内存占用等缓冲区信息。


例子:#macro {(press ctrl-v)(press F1)} {#buffer end}

F1键设置为滚动到缓冲区底部。


例子:

#alias {colorsearch}

{

    #var found null;

    #loop 2 20 loop

    {

       #buffer get name $loop;

       #if {"$name" == "\e[1;33m%*"}

       {

           #var found &1;

           #break;

       }

    }

}

上面这个例子会创建一个叫colorsearch的别名,当你输入colorsearch时,TinTin++会在屏幕缓冲区的最近20行内容中查找以黄色粗体显示的文字,并保存到found变量中。



Case


语法:#case {条件} {指令}


#case命令只能用在#switch命令的内部,当#case命令中的条件与#switch的一致时,#case命令中的指令部分将被执行。


例子:#switch {1d4} {#case 1 hihi;#case 2 hehe;#default grin}



Chat

(译注:本章和下一章的“MudMaster Chat协议”仅供参考,由于较少用到这两章的命令,对该部分的内容未作核实,部分译文可能不够准确与规范)


语法:#chat {命令} {参数}


#chat命令可以与其他mud客户端建立点对点的连接,通常用于聊天或传输文件。这是一个分散化的聊天系统,这意味着你必须与其他用户交换ip地址和端口号以建立连接。


#chat {initialize} {端口号}


#chat initialize命令将创建一个聊天服务器,端口号是可选的,默认为4050。在创建聊天服务之后,其他人就能通过你的ip地址和端口号连接到你的服务器,你也就与他们建立了连接。


#chat {name} {你的名字}


默认情况下你的名字是TinTin,但大部分服务器会限制同名连接,因此在建立连接前你要做的第一件事是更改你的名字。名字中可以包括颜色代码,但有一些名字是不被TinTin++的聊天服务器接受的,比如“all”或者长度超过20个字符的名字。


#chat {call} {ip地址} {端口号}


#chat call命令用于连接到一个TinTin++聊天服务器,如果你省略端口号,默认的4050端口将被采用。


#chat {color} {颜色}


默认的聊天颜色是红色粗体,你可以用#chat color命令来进行调整。比如:#chat color bold yellow——调整为黄色粗体。或者你也可以使用支持256色的颜色代码,比如:#chatcolor


#chat {message} {用户|all} {内容}


这是聊天中使用的主要命令,如果你使用了#chat message all,那么这条消息会被作为广播,发送到所有与你连接的对象。


#chat {emote} {用户|all} {内容}


这个命令的作用与#chatmessage基本一致,只是它会把你的名字加入到发送的消息中。


#chat {paste} {用户|all} {内容}


这个命令用于在消息后添加新的内容,但要注意,大部分mud客户端都不会正确接受超过40行的信息。


#chat {reply} {内容}


#chat reply用于回复上一个给你发消息的人。


#chat {send} {用户|all}


这个命令将向别人发送一个原始的数据串,你需要了解Mud Master Chat协议来使用它。


#chat dnd


DND表示“不要打扰我”(Do Not Disturb),这个命令用于切换DND状态,当处于DND状态时,将自动拒绝所有新的连接请求。


#chat {ip} {地址}


当你没有默认的ip时,这个命令用于设置你的ip地址,在你连接到另一个mud客户端时,这个地址会被发送给对方。TinTin++通常忽略报送的ip地址,直接采用实际地址,但其他mud客户端可能会需要这一报送信息。


#chat {who}


#chat who命令显示所有与你建立连接的人。第一栏为连接号,在给别人发送消息的时候,你可以用这个号码代替他的名字;第二栏为对方的名字;第三栏是标记,可以为P(私人private)、I(忽略ignore)、S(服务serve)、F(转发给forward to)、f(转发自forwardfrom);之后各栏分别为ip地址、端口号、mud客户端名称。


#chat {info}


这个命令显示你的名字、ip地址、端口号、下载目录、回复(replay)对象,以及DND状态。


#chat {ignore} {用户}


这个命令将忽略一个用户,使你不再收到他的消息,而且对方并不会察觉到这一点。


#chat {private} {用户|all}


这个命令将对指定的用户禁用peekrequest命令。


#chat {public} {用户|all}


这个命令是private命令的逆操作,允许指定的用户进行peekrequest操作,新建的连接默认是公开(public)的。


#chat {peek} {用户}


这个命令显示指定用户的公开连接。


#chat {request} {用户}


这个命令将获取指定用户的公开连接,并自动与他们建立连接。


#chat {ping} {用户}


这个命令显示你与指定用户之间的连接速度,ping的时间以毫秒为单位。


#chat {zap} {用户|all}


这个命令将关闭指定的连接。


#chat {forward} {用户}


这个命令将把所有消息转发给指定用户。为避免陷入循环,当该用户正在向你转发消息时,转发功能会被自动关闭。


#chat {forwardall} {用户}


这个命令将把屏幕缓冲区里的所有内容转发给指定用户。


#chat {serve} {用户}


这个命令将把所有的公开消息转发给指定用户,并将该用户发给你的所有公开消息转发给其他与你建立连接的用户。为避免陷入循环,以上消息都作为私人消息转发。


#chat {group} {用户} {组名}


这个命令将指定的用户归为一组,你可以在emotemessagesend命令中使用组名。不带参数的#chat group命令将显示所有的用户和他们所属的组名,与#chat who类似。


#chat {sendfile} {用户} {文件名}


这个命令用于向指定用户发送一个文件,在对方接受后文件将被传送。


#chat {accept} {用户}


接受对方发来的文件。


#chat {decline} {用户}


拒绝对方发送的文件。


#chat {cancel} {用户}


取消正在传送的文件。


#chat {filestat} {用户}


显示正在传送的文件的相关信息。


#chat {downloaddir} {目录}


这个命令用于设置下载文件的存放目录。



Mud Master Chat ProtocolMudMaster Chat协议)


建立一个连接


呼叫方:


每次新建一个连接的时候,呼叫方发送一条形如“CHAT:\n”的连接字串,字串的格式为:“CHAT:%s\n%s%-5u”。端口号必须是5个字符,位数不足的在右侧添加空格。字串发送后将会等待对方的回复,如果回复为“NO”,呼叫将被取消,如果接收到形如“YES:\n”的回复,表示呼叫已被接受。


接收方:


检测到呼叫的时候,TinTin++会等待呼叫方发出一个以“CHAT:”开始的字串,回复“NO”字串将拒绝呼叫,回复“YES:\n”字串接受呼叫。


Chat数据包


Chat数据包是形如“”的字串。所有的数据都需要遵循这一格式,但有两个例外:一是在连接过程中不需要使用数据包;二是在传输文件时数据包是定长的,因此不需要标识。


数值对照表:


CHAT_NAME_CHANGE                      1

CHAT_REQUEST_CONNECTIONS              2

CHAT_CONNECTION_LIST                  3

CHAT_TEXT_EVERYBODY                   4

CHAT_TEXT_PERSONAL                    5

CHAT_TEXT_GROUP                       6

CHAT_MESSAGE                          7

CHAT_DO_NOT_DISTURB                   8


CHAT_VERSION                         19

CHAT_FILE_START                      20

CHAT_FILE_DENY                       21

CHAT_FILE_BLOCK_REQUEST              22

CHAT_FILE_BLOCK                      23

CHAT_FILE_END                        24

CHAT_FILE_CANCEL                     25

CHAT_PING_REQUEST                    26

CHAT_PING_RESPONSE                   27

CHAT_PEEK_CONNECTIONS                28

CHAT_PEEK_LIST                       29

CHAT_SNOOP_START                     30

CHAT_SNOOP_DATA                      31


CHAT_END_OF_COMMAND                 255


<新的名字>


当一个用户改变他的名字的时候,新的名字将被广播给所有连接的用户。



从一个用户处获取所有的公开连接,并与他们建立连接。


<地址>,<端口号>,<地址>,<端口号>


接收方需要将所有公开连接的ip地址与端口号用逗号分隔,作为一个连接列表发送回去。


<消息内容>


用于将消息内容发送给所有人,所有显示的内容都需要由发送方生成,包括换行和“ chats to everybody”字串。


接收方:


如果你没有忽略一个连接,这个字串将被直接显示出来。如果你有部分连接是标记为“服务”的,你将把这个字串广播给这些连接。同时,如果这个字串来自一个被标记为“服务”的连接,你将把这条字串广播给所有的其他连接。这使得那些无法与每个人直接建立连接的人,可以通过第三方服务实现这一目的。


<发送的消息>


这与CHAT_TEXT_EVERYBODY字串的功能基本一致。当然接收方会从这个字串了解到,这是一条私人消息,从而不会被广播给其他人。


接收方:


如果没有被忽略的话,仅仅是把这条消息显示出来。


<组名><发送的消息>


用于将消息发送给特定的组,基本功能与其他发送命令一致。组名是一个15字符的字串,如果长度不足的话,需要在右侧加足空格。


接收方:


如果没有被忽略的话,仅仅是把这条消息显示出来。


<消息>


用于将消息发送到一个连接。这个字串应当被用于系统消息,比如接受或拒绝一个连接请求,将一个连接标记为公开或私人的。为了让你的接收方知道一条消息是系统消息,采用下面这样的格式将是一个比较好的办法:“\n %s has refused your connection because your name istoo long.\n”


接收方:


仅仅显示这条消息。


<版本信息>


这用于发送你的mud客户端的名称与版本号。


<文件名,文件长度>


这条字串发送后将开始传送文件。文件名不能是一个目录,文件长度以字节为单位。


接收方:


首先会确认是否允许这个连接向你发送文件,并检查文件名与文件长度的合法性。如果信息不正确或你不想接受这个文件,你需要返回CHAT_FILE_DENY以停止传输。如果希望继续传输,你需要返回CHAT_FILE_BLOCK_REQUEST来请求相应的数据包。


<消息>


当你接收到CHAT_FILE_START消息后想中止传输时,你可以使用这条字串。<消息>为拒绝传输的原因,比如,当被传输文件已存在时,你可以回复:“File already exists.”


接收方:


显示拒绝消息,并关闭所有已打开并准备传输的文件。



在文件传输时用于请求下一个数据包。


接收方:


需要创建一个用于发送的数据包。数据包是定长的,因此你不需要指定字节数。如果已到达文件尾部,你需要发送CHAT_FILE_END字串,以关闭文件并通知对方传输完毕。


<数据包>


一个数据包的长度是500字节,这个长度是固定的,因此不需要添加CHAT_END_OF_COMMAND


接收方:


接收方需要始终关注接收到的每一个字节,以正确写入数据包,并预计什么时候将达到文件的尾部,此时数据包的长度将小于500字节。文件传输是由接收方驱动的,因此每完成一个数据包的接收,你都需要返回一个CHAT_FILE_BLOCK_REQUEST字串,以请求下一个数据包。



关闭文件完成传输。TinTin++不需要用到这个字串,因为TinTin++将自动跟踪文件传输进程。



文件传输的双方都可以发出这个字串来中止传输。


<时序数据>


时序数据取决于ping的请求方,TinTin++发送的是64比特的时戳。


<时序数据>


当接收到一个CHAT_PING_REQUEST字串后,你应当返回一个时序数据。



发送方请求提供所有的公开连接的情况。


地址>~<端口号>~<名字>~


接收方需要将所有公开连接的ip地址,端口号,名称以“~”号隔开,作为一个列表发送回去。



发送方请求启动或停止观察一个连接的信息,接收方可以决定是否允许对方进行观察。


<消息>


这条字串由一个处于观察或转发状态的mud客户端发出,<消息>将被接收方显示出来,但不会再次转发,以防止陷入循环。



Class


语法:#class {类名} {open|close|read 文件名|write 文件名|kill}


#class {<类名>} {open}


{open}选项将打开一个类并自动关闭上一个打开的类(如果有的话),在此之后新建的所有触发、别名、变量等都会被标记为这个类,直到这个类被关闭。


#class {<类名>} {close}


{close}选项会关闭当前打开的类。


#class {<类名>} {read} {<文件名>}


{read}选项会打开一个类,读入指定的文件,最后关闭这个类。(译注:即把命令文件中的触发、别名、变量等都放到一个类里)


#class {<类名>} {write} {<文件名>}


{write}选项将把指定类中的所有触发(译注:也包括别名、变量等内容)写入文件。这个命令可以用来保存数据,比如你可以先把一个变量放进一个类,然后利用这条命令保存变量的内容。


#class {<类名>} {kill}


{kill}选项将删除一个类,包括属于这个类的所有触发。(译注:也包括别名、变量等)



ANSI ColorsANSI颜色代码)


语法:其中abc为参数


参数aVT100代码


0 – 默认

1 – 亮色

2 – 暗色

4 – 下划线

5 – 闪烁

7 – 反色(前景色与背景色互换)

8 – 跳过

(译注:TinTin++并不支持文字闪烁显示,这里的代码5只是将背景色亮化以突出显示;代码8原文为skip,具体作用不详)


参数b:前景色

参数c:背景色


0 – 黑色       5 – 粉色

1 – 红色       6 – 青色

2 – 绿色       7 – 白色

3 – 黄色       8 – 跳过

4 – 蓝色       9 – 默认


Xterm 256色代码

对于支持xterm 256色的终端,可以用设置前景色,用设置背景色。


对于支持灰度的终端,可以用设置前景色,用设置背景色。


例子:#showme <034>T<025>i<016>n<007>T<043>i<052>n<061>+<070>+<088>

试着在TinTin++中执行上面的命令并观察结果。


例子:#showme 橙色 青绿 靛紫 天蓝 玫红

试着在TinTin++中执行上面的命令并观察结果,你的终端必须支持xterm 256色。

北大侠客行Mud(pkuxkx.com),最好的中文Mud游戏!
 楼主| 发表于 2013-9-24 12:58:34 | 显示全部楼层
本帖最后由 alucar 于 2013-10-2 06:03 PM 编辑

Commands


语法:#commands {命令缩写}


不带参数的#commands显示所有的命令,若指定命令缩写,将显示与之匹配的命令。

(译注:TinTin++2.00.9版本开始支持不带参数的#commands命令;#commands {a}将显示所有以a开头的命令。)


命令语法


TinTin++的所有命令都以“#”号开始,除非你用#config命令自定义命令符号。如果你用#read命令读入一个命令文件,文件中的第一个符号将被定义为命令符号。TinTin++的命令都可以缩写。


命令分隔


你可以用“;”号分隔命令。如果要输出分号,你需要在分号前加上转义符“\”。位于行首的“\”号将忽略这一行中的所有特殊字符。#config {verbatim}{on}命令将忽略所有输入的特殊字符(在别名中的特殊字符除外)。


例子:smile;say 在下有礼了 \;)

这条命令将作一个smile表情,然后说:在下有礼了;)


Config


语法:#config {选项} {参数}


TinTin++启动的时候会生成一个设置文件,这些设置可以用#config命令修改。输入不带参数的#config将显示当前设置,这些设置可以用#write命令写入一个命令文件。


下列设置选项默认是不可见的:


#CONFIG {COLOR PATCH} {ON|OFF} 对部分mud锁定颜色代码以正常显示颜色,比如Achaea,默认关闭。


#config {CONVERT META} {ON|OFF} 打开/关闭显示颜色代码,默认关闭。


#config {DEBUG TELNET} {ON|OFF} 显示telnet协议信息,默认关闭。


#CONFIG {MCCP} {ON|OFF} 打开/关闭对MCCPmud客户端压缩协议)的支持,默认打开。


#CONFIG {LOG LEVEL} {LOW|HIGH} 设置为low时,mud信息将在触发生效前显示,默认为high



Continue


语法:#continue


#continue命令用于在#foreach#loop#parse#switch#while命令的循环中跳过一些命令。当执行#continue时,TinTin++直接跳到循环的尾部,并继续执行下去。


例子:#loop 1 10 cnt {#if {$cnt % 2==0} {#continue};say $cnt}



Cr


语法:#cr


#cr命令向mud发送一个回车,但这是一个过时的命令,应当尽可能避免使用。在某些情况下#cr命令依然有点用处,比如当你设置了以enter键来重复执行上一次命令而又想输入一个单纯的回车符时,你就可以使用#cr。另一种替代的办法是使用不带参数的#send命令,或者输入两个分号“;;”来插入一个回车。有一些mud会将多个回车输入当成一个来对待——比如DikuMUD这样的——这时最好的办法是使用#send { \n \n }(这里一共有三个回车)。


例子:#ticker {idle} {#cr} {300}

这条命令将每隔300稍(5分钟)向mud发送一个回车符,这样可以避免你在大多数mud中因发呆而掉线。


Cursor


语法:#cursor {选项}


输入不带选项的#cursor命令可以查看所有的选项,这个命令的主要功能是为输入行编辑操作设置宏键。


例子:#macro {\e\e[3~} {#cursor clear right}

当按下Alt+Del时,光标右侧的文字将被删除,这一功能的默认设置是^K


Debug


语法:#debug {项目} {参数}


单独的#debug命令将显示所有支持的项目,不带参数的#debug {项目}将切换指定项目的debug状态,或者你也可以指定参数的内容,包括ONOFF,以及LOG


迄今为止,仍有部分debug项目尚未生效。


例子:#debug action on

当一个触发启动时,TinTin++将显示被执行的内容。


Default


语法:#default {命令}


#default命令只能用于#switch命令内。当所有#case的条件都不符合时,#default的命令将被执行。


例子:#switch {1d4} {#case 1 hihi;#case 2 hehe;#default grin}



Delay


语法:#delay {秒数} {命令}


语法:#delay {名称} {命令} {秒数}


#delay将一定时间后执行指定的命令,{秒数}支持精确到毫秒级别的浮点数。


#delay命令的工作方式因参数个数的不同而有所差异。当有三个参数时,#delay#tick的语法相同,允许你对一个延时命名。如果你建立一个带名称的延时,而此时已存在一个同名的延时,那么之前的延时将被删除。使用一个带名称的延时也便于你用#undelay命令进行删除操作。


例子:#delay {840} {#showme 即将更新!}

这个命令将在840秒(14分钟)后提醒你系统即将更新,比如你可以在#act {【江湖传闻】江湖又暂时恢复了表面的宁静}这样的触发中使用。


例子:#delay {renew} {840} {#showme 即将更新!}

与上面的例子相同,只是这次指定了名称。



Echo


语法:#echo {信息格式} {参数}


语法:#echo {{信息格式} {行号}} {参数}


#echo命令将按照符合#format标准的格式在屏幕上显示信息。与#showme不同,#echo显示的信息不会被触发。与#showme相同的是,你可以在{信息格式}后加上{行号},用以指定显示的位置,这一点与#prompt是相同的。


你可以查看#format#prompt的帮助文件以了解更多的信息。


例子:#echo {当前时间为:%t.} {%Y-%m-%d %H:%M:%S}

北大侠客行Mud(pkuxkx.com),最好的中文Mud游戏!
 楼主| 发表于 2013-9-24 12:58:38 | 显示全部楼层
本帖最后由 alucar 于 2013-10-4 03:28 PM 编辑

Else


语法:#else {命令}


#else需要在#if或者#elseif命令之后使用,并且只有当#if#elseif条件判断为假时才被执行。


例子:#if {1d2 ==1} {smile};#else {grin}


Elseif


语法:#elseif {条件} {命令}


#elseif需要在#if或者#elseif命令之后使用,并且只有当之前的#if#elseif条件判断为假,且自身条件为真时才被执行。


例子:#if {1d3 ==1} {smile};#elseif {1d2 == 1} {grin};#else {laugh}



End


语法:#end


退出TinTin++,你也可以按下^d



Escape Codes(转义码)


TinTin++的转义符是反斜杠“\”“\”可以与一些字符组成转义码。


\a   将发送响铃代码。

\b   将发送反斜杠。

\c   将发送一个Ctrl字符,\ca表示^a

\e   将开始一个转义序列。

\n   将发送一个换行。

\r   将发送一个回车。

\t   将发送一个跳格。

\x   将发送一个十六进制的字符,比如\xFF

\x7B将发送“{”字符。

\x7D将发送“}”字符。

\0   w将发送一个八进制的字符,比如 \077

\\   将发送一个单独的“\”号。


在使用#showme#send#line命令时,如果在行尾以“\”号结束,TinTin++在输出时将不会自动换行。


在别名中对参数进行转义,需要采用%%0%%1%%2这样的形式。



Event

(译注:目前本人尚不了解TinTin++中定义的相关事件何时生效,以及如何运用,本章仅尝试按照原文译出,未作相应的测试。其中IAC事件因本人缺少相应的专业知识而存在理解障碍,故附上原文对照,容日后再完善)


语法:#event {事件名} {命令}


#event命令将针对预先定义的事件创建一个触发,不带参数的#event将列出大部分事件及其简要描述,#event %*将显示所有已定义的事件。部分事件将设置参数。


DATE


在指定的日期触发。


DAY


在指定日或每日触发。


END OF PATH


每次使用#path命令行走到一个路径的末尾时都会触发此事件。


HOUR


在指定的小时或每小时触发。


IAC


This event triggers for all telnetnegotiation. Use #config {debug telnet} {on} to see the proper name of telnetevents as they happen. If you create a telnet event for a telnet negotiationthat is normally handled by the mud client, like IAC SB TTYPE, only the eventwill be executed; the automatic response will be blocked.

在进行telnet交互时触发。使用#config {debug telnet} {on}命令后,在telnet事件发生时你可以看到这些事件的正确名称。如果你创建的telnet事件触发针对的是一些正常情况下由mud客户端自动处理的事件——比如IAC SB TTYPE——那么客户端的正常处理机制将会失效,只有你定义的触发会被执行。


IAC SB MSDP


This event triggers on a MSDP (Mud ServerData Protocol) sub negotiation. The %0 argument contains the variable's name,the %1 argument contains the variable's value. If a variable is send as anarray a name/value event is generated for each index.

telnet交互的MSDPMud Server Data Protocol)子过程中触发。参数%0保存变量名,参数%1保存变量的值。如果发送的参数是一个数组,那么数组中的每个数据都会生成一个“变量名/变量值”事件。


IAC SB MSSP


This event triggers on a MSSP (Mud ServerStatus Protocol) sub negotiation. The %0 argument contains the variable's name,the %1 argument contains the variable's value. If a variable is send as anarray a name/value event is generated for each index.

telnet交互的MSSPMud Server Status Protocol)子过程中触发。参数%0保存变量名,参数%1保存变量的值。如果发送的参数是一个数组,那么数组中的每个数据都会生成一个“变量名/变量值”事件。


IAC SB NEW-ENVIRON


This event triggers on a NEW-ENVIRON subnegotiation. Depending on the negotiation type you'll have to append SEND, IS,or INFO to the event name, as shown when using #config {debug telnet} {on}. The%0 argument contains the variable's name, the %1 argument contains thevariable's value.

telnet交互的NEW-ENVIRON子过程中触发。根据交互类型的不同你需要在事件名后添加SENDISINFO,具体可以打开#config{debug telnet} {on}查看。参数%0保存变量名,参数%1保存变量的值。


IAC SB ZMP


This event triggers on a ZMP subnegotiation. Depending on the ZMP package you'll have to append the package tothe event name, as shown when using #config {debug telnet} {on}. The %0argument contains the ZMP package data.

telnet交互的ZMP子过程中触发。根据ZMP包的不同你需要在事件名后添加相应的包,具体可以打开#config {debug telnet} {on}查看。参数%0保存ZMP数据包的内容。


IAC SB


This event triggers on any undefined subnegotiation. Some telnet options will be named, others will be a number, asshown when using #config {debug telnet} {on}. The %0 argument will contain thedata inside the sub negotiation.

telnet交互的其他未定义子过程中触发。一些telnet选项可能被命名,另一些则是数字,具体可以打开#config {debugtelnet} {on}查看。参数%0保存这些子过程中的数据。


MAP ENTER MAP


当进入一张地图时触发。


MAP ENTER ROOM


在自动绘制地图时,每进入一个新的房间,此事件将被触发。参数%0存放房间的标号。


MAP EXIT MAP


离开地图时触发。


MAP EXIT ROOM


在自动绘制地图时,离开当前房间前,此事件将被触发。变量%0存放房间的标号。


MINUTE


在指定分钟或每分钟触发。


MONTH


在指定月或每月触发。


PROGRAM START


TinTin++完成启动后触发。


PROGRAM TERMINATION


TinTin++退出时触发。


RECEIVED INPUT


每次输入命令并被执行后触发。变量%0储存输入的内容。


RECEIVED LINE


当接收到从mud服务器发来的完整一行消息时触发,这个事件将在所有其他定义的触发(Action)前发生。变量%0储存消息内容,变量%1储存消息的原始形态(包括颜色代码)。


RECEIVED OUTPUT


当接收到新的输出内容时触发。


SCREEN RESIZE


当改变窗口尺寸时触发。


SECOND


在指定秒或每秒触发。


SEND OUTPUT


当一条命令被发送到mud服务器时触发。变量%0储存发送的内容。


SESSION ACTIVATED


当一个session被激活时触发。


SESSION CONNECTED


当一个session连接到服务器时触发。变量%0储存session名称,%1储存服务器名称,%2储存ip地址,%3储存端口号。


SESSION DEACTIVATED


当一个session进入后台时触发。


SESSION DISCONNECTED


当一个session从服务器断线后触发。变量%0储存session名称,%1储存服务器名称,%2储存ip地址,%3储存端口号。


TIME


在指定时间触发。


WEEK


在指定周或每周触发。


YEAR


在指定年或每年触发。


Forall


语法:#forall {列表} {命令}


{列表}中的元素必须用分号或花括号分隔。


例子:#forall {a;b;c;d} {say &0}

例子:#forall {{a}{b}{c}{d}} {say &0}

上面两个例子都等价于:saya;say b;say c;say d



Foreach


语法:#foreach {列表} {变量} {命令}


#foreach命令相当于一个简单的循环,{列表}中的每个元素将被存入{变量},并在{命令}中使用。


{列表}中的元素必须用分号或花括号分隔。


例子:#foreach {sword;blade;whip}{weapon} {identify $weapon}

例子:#foreach {{sword}{blade}{whip}}{weapon} {identify $weapon}

上面两个例子都等价于:identifysword;identify blade;identify whip


如果要用#foreach遍历一个list变量(或一个嵌套的变量),你需要使用$变量名>[%*]的形式。


例子:#foreach {$weapon_list[%*]} {weapon} {identify $weapon}



Format


语法:#format {变量} {格式} {参数1} {参数2}……{参数n}


#format命令用于对字串进行格式化,类似于C语言中的sprintf函数。格式化后的字串将被储存在指定的{变量}中,{格式}部分可以包括固定字串与参数变量,而在{参数}部分你最多可以使用20个参数。


参数          名称          描述

%+9s          字符串        长度为9的字符串,不足的在左侧加空格

%-9s          字符串           长度为9的字符串,不足的在右侧加空格

%.9s          字符串        长度最多为9的字符串

%a            数字          显示相应的ascii字符

%c            颜色          将描述转换为颜色代码,比如你可以用light red

%d            浮点数        显示取整后的数字

%h            页眉          将参数内容转化为页眉格式

%l            小写          将参数内容转化为小写

%m            运算          对参数进行数学运算

%n            姓名          将首字母大写

%p            字符串        去除字符串前后的空格

%r            逆序          将参数内容逆序显示

%s            字符串        正常显示字符串内容

%t            时戳          按照strftime函数的格式显示时间

%u            大写          将参数内容全部大写

%w            自动换行      将参数转换为list

(译注:从输出看是变成了list变量的形式,但不清楚具体用途,原文为wordwrap

%C            列数          显示屏幕列宽

%G            千分位        以千分位形式显示数字

%L            长度          显示参数的长度

%R            行数          显示屏幕行高

%T            Epoch时间     显示从Epoch开始经过的秒数

%U            Epoch时间     显示从Epoch开始经过的毫秒数

(译注:Epoch指的是一个特定的时间:1970-01-0100:00:00


例子:

#alias {time}

{

       #format line {%c当前时间为:%t} {light green} {%Y%m%d %T};

       #showme {$line}

}



Function


语法:#function {函数名} {命令}


#function命令将生成一个函数,你可以在函数内部执行一些命令,当函数执行完毕后,调用该函数的语句将得到一个值,这个值由$result变量决定。


由于#echo命令也会使用result变量,因此在一个函数内部使用#echo命令必须十分小心。你可以用@<函数名>{<参数>}这样的形式来调用一个函数,参数被保存在0%99%的变量中以便在函数中引用,其中%0代表所有的参数,%1代表第1个参数,%2代表第2个,以此类推。参数需要用花括号或分号隔开。


例子:


#function {time}

{

       #if {"%0" == ""}

       {

              #format {epoch} {%T}

       };

       #else

       {

              #var epoch %0

       };

       #format {result} {%t} {{%T}{$epoch}}

}

这个函数里的#if判断用于检查引用函数时是否设定了参数。如果有,参数将被保存在$epoch变量中;如果没有,#format {epoch} {%T}将把当前的epoch秒数(即从1970年开始至今的秒数)保存到$epoch中。然后$epoch的时间信息将被格式化后保存到$result中。输入#showme @time{}就会显示当前时间。


更多的例子可以浏览本站的script页面。


注:你可以使用#unfunction删除一个函数。



Gag


语法:#gag {内容}


#gag命令相当于#substitute {内容} {.}命令,并将指定的内容加入到替换清单中。被屏蔽的内容将不再被显示。


更多的信息可以查看关于Action的帮助文档。


例子:#gag {%iAlucar}

如果你觉得Alucar这个家伙太话唠了,就可以用这个命令来个眼不见为净。起始处的%i表示不区分大小写,因此不管是Alucar还是ALUCAR都不会再出现在你眼前了。


注:你可以用#ungag命令删除屏蔽。


北大侠客行Mud(pkuxkx.com),最好的中文Mud游戏!
 楼主| 发表于 2013-9-24 12:58:42 | 显示全部楼层
本帖最后由 alucar 于 2013-10-4 08:36 PM 编辑

Greeting


语法:#help greeting


仅仅显示你每次打开TinTin++时的欢迎界面(其中包含版本信息),只有你想看它的时候才有用,而且不计入屏幕缓存。


这其实并不是一个命令,因为你只能通过#help命令来使用它。



Grep


语法:#grep {页数} {关键词}


这个命令将在屏幕缓冲区内查询指定的关键词,并以屏为单位显示包括关键词的行。其中{页数}是可选的,表示显示第几屏查询结果(默认为显示第一屏),这在符合条件的内容较多的时候比较有用。你可以用正则表达式来作为关键词,以获得更好的查询结果。此外,关键词是区分大小写的。


例子:#grep 告诉你

这个命令将把所有别人tell你的内容显示出来。



Help


语法:#help {主题}


#help命令将根据帮助文件的内容显示某个主题的基本帮助信息,不带参数的#help显示所有的帮助主题。


#help命令的内容一般比在线帮助手册更加新一些。


例子:#help alias

显示别名(Alias)的帮助信息。


例子:#help %*

显示所有帮助文件。



Highlight


语法:#highlight{内容} {颜色}


#highlight命令将把指定的内容加入到高亮显示列表,当服务器发来的信息与之匹配时,将以指定的颜色显示。


有关正则表达式的内容可以查看#action命令的帮助,变量%0不应在{内容}中使用。


支持的颜色代码包括:resetlightfaintunderscoreblinkreversedimblackredgreenyellowbluemagentacyanwhiteb blackb redb greenb yellowb blueb magentab cyanb white。你也可以使用TinTin++256色颜色代码。


例子:#highlight {^{}} {lightcyan}

这条命令将把所有包括“你”的行标为青色粗体,当你在战斗中遇到刷屏的时候,这会有点用处。


例子:#highlight {%*告诉你:%*} {}

注:你可以使用#unhighlight命令删除高亮。



History


语法:#history {命令} {参数}


#history命令与默认为“!”号的重复字符配合使用。历史命令是一个由所有手工输入过的命令组成的列表,在默认情况下每个session的历史命令包括最近输入的1000条命令,这可以用#config命令进行更改。


#history {delete}


将删除历史命令中的最后一条命令。


#history {insert} {命令}


将把指定的{命令}插入到历史命令的最后。


#history {list}


将显示所有的历史命令。


#history {read} {文件名}


将读入事先保存过的历史命令记录。如果与#event命令配合,可以在打开一个session的时候自动读取。


#history {write} {文件名}


将把历史命令写入一个文件。如果与#event命令配合,可以在关闭一个session的时候自动写入。



If


语法:#if {条件} {true} {false}


{条件}是一个c语言风格的运算式或一个正则表达式。字符串必须加引号。当{条件}的结果为任意非零值时,{true}部分的命令将被执行;当结果为零时,{false}部分的命令被执行。


更多信息可以查询Mathexp(数学表达式)与Regexp(正则表达式)。


例子:#act {%1(%2)告诉你} {#if {"%2"=="icer"} {tell %2 我不是机器人。} {tell%2 我是机器人。}}



Ignore


语法:#ignore {项目} {参数}


不带任何参数的#ignore命令显示所有可选的项目列表,#ignore {项目}将切换指定项目的生效状态,你也可以具体指定{参数}ONOFF


例子:#ignore actions off

令所有触发都暂时失效。



Info


语法:#info


#info命令显示触发、别名、变量等等的基本信息,包括数量、是否生效(#ignore)、是否反馈执行信息(#message#debug)。



Keypad(小键盘布局)


TinTin++启动时会向终端发送“\e=”以打开终端设备的小键盘模式,你可以用#showme {\e>}关闭该模式。



                布局 A                      布局 B                      布局 C

  +-----+-----+-----+-----+   +-----+-----+-----+-----+   +-----+-----+-----+-----+

  |Num  |/    |*    |-    |   |Num  |/    |*    |-    |   |Num  |nkp/ |nkp* |nkp- |

  +-----+-----+-----+-----+   +-----+-----+-----+-----+   +-----+-----+-----+-----+

  |7    |8    |9    |     |   |Home |Up   |PgUp |     |   |nkp7 |nkp8 |nkp9 |     |

  +-----+-----+-----+     |   +-----+-----+-----+     |   +-----+-----+-----+     |

  |4    |5    |6    |+    |   |Left |Centr|Right|+    |   |nkp4 |nkp5 |nkp6 |nkp+ |

  +-----+-----+-----+-----+   +-----+-----+-----+-----+   +-----+-----+-----+-----+

  |1    |2    |3    |     |   |End  |Down |PgDn |     |   |nkp1 |nkp2 |nkp3 |     |

  +-----+-----+-----+     |   +-----+-----+-----+     |   +-----+-----+-----+     |

  |0          |.    |Enter|   |Ins        |Del  |Enter|   |nkp0       |nkp. |nkpEn|

  +-----------+-----+-----+   +-----------+-----+-----+   +-----------+-----+-----+


在小键盘模式关闭状态下,锁定numlock将采用布局A,解锁numlock将采用布局B。打开小键盘模式将采用布局C


支持小键盘模式的终端:


Linux Console, PuTTY, Eterm, aterm.


不支持小键盘模式的终端:


RXVT on Cygwin, Windows Console, GnomeTerminal, Konsole.


特殊终端:


RXVT需要解锁numlock才能启用布局C


Xterm可能需要禁用Alt/NumLock Modifiers (num-lock),你可以在Ctrl+鼠标左键的菜单中找到它。或者你也可以修改~/.Xresources并添加XTerm*VT100.numLock:false


Mac OS X终端需要在菜单中打开“strict vt100 keypad behavior”,你可以在菜单栏的Terminal -> Window Settings -> Emulation中找到它。



Kill


语法:#kill {类别} {参数}


#kill命令将删除包括别名、触发、变量、定时等在内的各种自定义的东西,甚至包括路径与最基本的config设置。当你想要从头开始的时候这个命令是很有用的。


给定{类别}#kill将删除指定类别的内容,比如:#killalias将删除所有的别名。


你也可以同时指定{类别}{参数},此时只有对应的内容会被删除。,比如:#kill {alias} {%*bla%*}

北大侠客行Mud(pkuxkx.com),最好的中文Mud游戏!
 楼主| 发表于 2013-9-24 12:58:47 | 显示全部楼层
本帖最后由 alucar 于 2013-10-7 10:08 AM 编辑

Line


语法:#line {选项} {参数}


#line命令提供了多种基于行的操作。


#line {gag}


这条命令将屏蔽下一行显示内容。当触发被设定为在被触发语句显示前执行时,将#ling {gag}放在触发命令中可以使触发语句不再显示出来。


#line {log} {<文件名>} {[文本]}


#line {log}将把指定的文本内容存入文件。如果没有给出{文本}参数,下一行显示内容将被存入文件。在{文本}中使用的TinTin++颜色代码将被自动转换为ANSI颜色码。依据#config{LOG}的设置,log文件的格式为HTMLRAWPLAIN


#line {logverbatim} {<文件名>} {[文本]}


#line {logverbatim}#line {log}十分类似,唯一的区别是{文本}中的颜色代码、变量、函数等不会被替换为相应的值。


例子:


#var ignore_list {{bubba}{1}{pamela}{1}};


#act {%1(%2)告诉你:%3}

{

       #if {&ignore_list[%2]}

       {

              #line gag

       }

       {

              #line logverbatim tells.log

       }

}

上面的例子将把所有tell你的消息存入tells.log文件,除非tell你的人位于ignore_list中,而且被忽略的tell消息将被屏蔽。



List


语法:#list {<变量>} {<选项>} {<参数>}


TinTin++中的list变量是一个与序号相关联的数组,#list命令通过自动编号使得对数组的操作更加方便,比如在插入或删除一个数组元素的时候。


#list命令中的序号是一个在1list元素总数之间的数,你也可以使用一个负数,此时-1代表list中的最后一个元素,-2代表倒数第2个元素,以此类推。


你可以使用序号来直接显示list中的某个元素,比如$var[1]$var[2]$var[-1]等。


如果要遍历list中的所有元素,你可以在#foreach命令中使用$[%*]作为参数。


#list {变量>} {add} {<参数1>} {<参数2>} {...}


#lise {add}将把{参数}作为元素添加到{list变量}中。


#list {变量>} {clear}


#list {clear}将清空指定的list变量,这个命令相当于#variable{<变量名>} {}


#list {变量>} {create} {<参数1>} {<参数2>} {...}


#list {create}将创建一个list变量,并以给定的{参数}作为元素,如果同名的list变量已经存在,该变量将被覆盖。


#list {变量>} {delete} {<序号>} {[数量]}


#list {delete}将删除list变量中指定序号的元素,{数量}参数是可选的,表示删除的元素个数,默认只删除一个元素。


#list {变量>} {find} {<参数>} {<变量>}


#list {find}用于在list变量中寻找与{参数}内容相匹配的元素,并将该元素的序号保存在{变量}中,如果没有找到,{变量}将赋值0


#list {变量>} {get} {<序号>} {<变量>}


#list {get}用于取出list变量中指定序号的元素并保存在{变量}中,如果给出的{序号}不存在,{变量}将赋值0。你也可以使用$list[<序号>]这样的形式直接从对应的数组中取出指定元素。


#list {变量>} {insert} {<序号>} {<参数>}


#list {insert}用于将一个元素插入到list变量的指定位置,如果{序号}为一个正数,插入的元素将位于序号位置,如果{序号}为负数,插入的元素将位于逆序的位置。比如序号-1将把新的元素添加到list变量的最后,序号1将把新的元素添加到list变量的开始。


#list {变量>} {set} {<序号>} {<参数>}


#list {set}将改变位于{序号}位置的元素的值,你也可以用#variable {变量>[序号]} {内容}这样的命令直接对数组进行操作。


#list {变量>} {size} {<变量>}


#list {size}用于获取list变量中元素的总数并保存到指定的变量中。你也可以使用&list[]来直接获得相应的数组的大小。


#list {变量>} {sort} {<参数>}


#list {sort}用于将指定内容插入到list变量中,插入的位置由字母顺序决定。(译注:本命令不会对list变量中已有的元素进行排序)



Log


语法:#log {模式} {文件名}


#log命令用于将屏幕缓冲区的内容存入指定文件,{模式}可以为ooverwrite覆盖)或aappend添加)。


通过#config命令你可以指定log文件的保存类别,共有三种,raw(会将转义码原封不动地保存下来)、plain(解释转义码的内容)和html(将转义码转换为html支持的格式)。


例子:#log o mylog.html

假设你已经在#config中设置了htmllog文件格式(默认),这个例子将把所有显示内容保存到mylog.html文件中。



Loop


语法:#loop {下限} {上限} {变量} {命令}


#loop命令相当于c语言中循环命令的简化版。{下限}{上限}必须使用数字。这个命令将按照下限与上限的大小对{变量}采取递增(或递减)方式循环执行{命令},直到达到 {上限}的数字。{变量}可以在 {命令}部分使用。


例子:#loop 1 10 cnt {say $cnt}

这条命令相当于:say1;say 2;say 3 …say 9;say 10



Macro


Syntax: #macro {按键代码} {命令}


{按键代码}指某个按键被按下时发送到终端的代码,这个代码与操作系统和所采用的终端相关,你可以打开#config中的{CONVERT META}选项来查看按键的具体代码。


如果要为F1键建立一个宏键来执行exert recover命令,你可以输入以下命令:


输入:#macro {(按下F1)} {exert recover} ——现在宏键F1已经可以使用了。


注:你可以用#unmacro命令删除一个宏键。



Map


语法:#map


#map命令用于自动绘制地图,支持大部分自动绘图功能。更为基本的路径功能请查询#path命令的帮助文件。


输入#map create<房间总数>命令即开始记录地图,同时生成第一个房间,<房间总数>为地图的容量。如果你没有指定<房间总数>,默认的容量是15000个房间。#map goto 1命令将使你进入地图并移动到地图的第一个房间。


你只需要简单地四处移动就可以向地图中添加房间。默认的移动指令包括nneesesswwnwud,如果你玩的mud包括其他移动指令,你必须用#pathdir命令添加这些指令。


有三种显示地图的方法。一是#mapmap命令,这将显示一张由附近的房间组成的地图。二是用#split命令将屏幕分为三个区域,比如#split 10 1命令中的10就是最上方的窗口的行数,然后再用#map flag vtmap命令,就能在这个窗口显示地图,并在你移动的时候自动更新。三是用#event命令定义一个MAP ENTER ROOM事件,当这个事件发生时执行#map map 80x24 map.txt命令,这将把地图输出到map.txt文件,如果你在另一个终端中执行unix命令tail -fs 0.1 map.txt,你就能在那个终端中看到实时更新的地图。

(译注:第三种方法在unix下可以结合screen实现竖向分屏显示地图,wintin么就只能另求他法了。)


在不少mud里存在位置重叠的地区,甚至在同一个地区内存在位置重叠的房间。对于这种情况,你可以使用#map roomflag void命令制造一个空房间并转换为一种连接,以实现房间的扩展。被标记为void的空房间只能有2个出口,你可以使用#map insert <方向> void命令来插入一个空房间。


与大部分自动地图一样,你可以很容易地实现快速行走。假设你正处于扬州的中央广场(你的map的第一个房间),并用#map name ct命令将这个房间命名为ct,然后你走到曲阜的孔庙并将孔庙这个房间命名为km,再使用#map run ct命令就可以快速返回。当然你也可以使用别名等其他方式返回ct,此时你需要用#map goto ct命令告诉自动绘图程序你已经回到ct


如果你特别喜欢欣赏vtmap模式下地图的自动更新过程,或者你只是急着想试一下效果,你可以使用#map run {km} 0.75命令来慢速行走到孔庙。


当你完成了上面这些比较困难的工作后,你可以用#map write <文件名>来保存你的地图,以便以后用#mapread <文件名>来读回。读回地图文件后,使用#map return命令可以让你返回到保存地图时你所处的房间。


你可以用#help map命令获得更多有关地图的操作选项及其简要说明。



Math


语法:#math {变量} {数学表达式}


关于运算符的信息可以查询下一节“数学表达式”。


#math命令用于进行数学运算并将运算结果存入给定的变量,#math也可以用于字符串与正则表达式的比较。


例子:#math sumvar {(1 + 1) * 10}

这个基本的运算指令将把计算结果(值为20)存入变量sumvar



Mathexp(数学表达式)


Mathexp是数学表达式(mathematical expressions)的缩写,用于进行数学与逻辑运算。TinTin++在完整支持c语言运算符的基础上有一些新增的符号。下面是各种运算符的优先级列表:


运算符       优先级                描述

! ~ + -        00                  逻辑否、逐位否、加、减

d              01                  随机整数

% * /          02                  整数取模、乘、除

+ -            03                  整数加、减

<<>>           04                  逐位左移、右移

< ><= >=       05                  逻辑小于、大于、小于等于、大于等于

== !=          06                  逻辑等于、不等于

&              07                  逐位与

^              08                  逐位异或

|              09                  逐位或

&&             10                  逻辑与

^^             11                  逻辑异或

||             12                  逻辑或

( )            13                  括号



Message


语法:#message {项目} {参数}


不带{项目}{参数}#message命令将显示所有可以进行切换的项目,如果只指定{项目},将只切换指定项目的message状态。你也可以更加具体地在{参数}中指定ONOFF


例子:#message variable off

变量生成或删除时的提示信息将不再被显示。



Namesession名)


语法:#[session] {命令}


当使用#session命令时你必须指定一个名称,这个名称可用于把相应的session置于前台,格式为#[session]。如果加上{命令}参数,你可以在不激活那个session的情况下进行后台操作。


例子:#ses one address 23;#ses two address 23;#one;#two idle

上面的命令将创建两个session,后建的那一个(two)将在前台运行。执行#one后,“one”这个session被调到前台;执行#two idle,那么idle这个emote就会在“two”这个session中执行。

北大侠客行Mud(pkuxkx.com),最好的中文Mud游戏!
 楼主| 发表于 2013-9-24 12:58:51 | 显示全部楼层
本帖最后由 alucar 于 2013-10-16 08:21 AM 编辑

Nop


语法:#nop


Nop是“no operation”的综写,当你什么都不想做的时候可以用这条命令。


例子:#act {&} {#nop} {0}

一些mud允许用“&”号来分隔命令,同时也允许玩家在saytell中使用这个字符。在这种情况下,一些喜欢恶作剧的玩家可能利用这一点来干扰你的触发,所以我们要加个保险。上面的例子使得包括“&”号的信息不会激活一些相对脆弱的触发,因为在同一时刻只有一个触发会启动。


你也可以用#nop在代码中添加注释,此时应当避免使用“{”“}”号。

(译注:#nop用于注释一行内容时,不会在回车处停止,因此在注释行的最后需要加上分号,否则会将下一行内容一并注释掉。)



Parse


语法:#parse {字符串} {变量} {命令}


#parse命令类似一个简化的循环, {字符串}中的每个字符将被依次存入{变量},并在 {命令}中使用。


例子:#parse {hello} {character} {say $character!}

上面的例子相当于:say h!;say e!;say l!;say l!;say o!


虽然通常来说#parse是一个比较无用的TinTin++命令,但它在某些情况下也可以有出色的表现,比如下面的例子就能将“.”号作为一个快速行走的快捷命令。

#alias {.%0}

{

       #var cnt {};

       #parse {%0} {char}

       {

                #if {"$char" >="0" && "$char" <= "9"}

                {

                        #var cnt $cnt$char

                };

                #elseif {"$cnt" ==""}

                {

                        #send $char

                };

                #else

                {   

                        #loop $cnt 0 cnt

                        {

                                #send $char

                        }

                }

       }

}



Path


语法:#path {del|end|ins|load|map|new|save|run|walk} {参数}


#path命令能够快速方便地记录你的移动路径,并自动建立一个命令列表以实现两地之间的快速往返。如果这还不能满足你,还有更加高端一的地图绘制的功能,具体请查询#map命令的帮助文件。


#path {new}


这条命令将进入路径记录模式,如果你进行了移动(仅针对#pathdir中的移动命令),这个移动命令将被添加到路径中。


#path {end}


当你用#path new开始记录路径后,你可以用#path end来终止记录。#path end不会删除当前记录的路径,但再次输入#path new就会消除记录。


#path {map}


这条命令用于显示到目前为止已经记录的路径。这里的路径只是一个命令清单,并不是图形化的地图。


#path {ins} {前进命令} {后退命令}


在行走的过程中,有时你需要做opendoor之类的动作,用这条命令你就能在记录路径的时候插入其他命令。由于在记录从A地到B地的路径时,从B地返回A地的路径也会同时生成,因此{后退命令}这个参数就用来指定逆向路径的命令。


例子:#path ins {open north} {};n;#path ins {} {open south}


#path {del}


删除路径中的最后一步。


例子:#action {哎哟,你一头撞在墙上,才发现这个方向没有出路。} {#path del}


#path {save} {forward|backward} {变量}


这条命令用于将记录的路径存入变量,你必须指定保存的是正向(forward)还是逆向(backward)路径,并可以使用fb作为相应的缩写。在用#path save f AtoB保存了一条路径后,你就可以输入$AtoB来使用它。


例子:#path new;n;n;n;e;e;e;#path save backward return;$return


#path {load} {变量}


这条命令将把指定的变量作为路径进行读取,即使变量的内容与行走无关。


#path {run} {延时}


在使用这一命令前,你必须已经记录或读取了一条路径。一旦执行,路径中包含的指令将立即被依次执行并从路径中删除,如果你指定了{延时},那么路径中的每个指令会依次间隔相应的时间后再执行。{延时}以秒为单位,并支持浮点数。


例子:#path run 0.5


#path {walk} {forward|backward}


在使用这一命令前,你必须已经记录或读取了一条路径。一旦执行,路径中的下一个指令将被执行并从路径中删除,如果已经达到路径的末尾,那么END OF PATH事件将被触发。


例子:#tick {slowwalk} {#walk f} {0.5};#event {END OF PATH} {#untick slowwalk}



Pathdir


语法:#pathdir {前进命令} {后退命令} {coord}


默认情况下TinTin++已经预设了大部分常用的移动指令,因此通常你并不需要用到#pathdir#pathdir定义的方向主要用于#path#map命令。


第一个参数是一个方向,第二个参数是相应的相反方向。比如n的反向就是s


第三个参数是一个空间坐标值。在一般情况下,每个基本方向应当有一个唯一的值,这个值是2的次方(比如1248163264等等)。但复合方向不同,它的值是所包含的基本方向的值的和,比如方向n的值是1,方向e2,那么ne的值就是31+2)。这个值主要用于#map命令的相关功能。


例子:#pathdir {eu} {wd} {18}

注:你可以用#unpathdir删除定义的方向。



Prompt


语法:#prompt {信息} {提示信息} {行号}


这个命令与#substitute很象,但只能在分屏模式下使用。#prompt将替换mud发来的指定信息,如果你没有指定行号,提示信息将在你的分屏栏上显示。


{行号}参数是可选的,它用于在分隔后的屏幕中显示提示信息。正行号表示在屏幕底部向上第n行显示提示信息,负行号表示从屏幕顶部向下第n行显示提示信息。


关于正则表达式匹配的内容请查询 #action命令的帮助文件。


例子:#prompt { 气血 %s%1%s/%s%2%s[%d%]} {[<078>气血:%1/%2]}


注:你可以用#unprompt命令删除定义的提示内容。



Read


语法:#read {文件名}


这条命令用于读取一个命令文件。


例子:#read peiyao.tin

假如你已经为平一指配药任务写好了相关的别名、触发、定时器等等,并存放在peiyao.tin文件中,那么这条命令就能读取这些设置,开始自动配药。



Regexp(正则表达式)


语法:#regex {字符串} {正则表达式} {true} {false}


#regex命令(即正则表达式regular expression)用于将给定的字符串与正则表达式进行匹配性比较,通配的变量被保存在&1&99中,&0代表整个匹配的字串。


“^”号开头的信息代表一个行首匹配,以“$”号结尾的信息表示一个行尾匹配。


以下内容适用于正则表达式。


{ }内的内容是一个与Perl语言兼容的正则表达式,可用于%n形式的变量,n为上一个变量的序号+1


  [ ] . + | ( ) ? * 这些符号将被当作普通文本处理,但在{ }内出现时除外。同时需要注意的是,此时将{ }( )代替。


以下通配符可用于%n形式的变量 n为上一个变量的序号+1


  %w 匹配0到任意个字母。

  %W 匹配0到任意个非字母。

  %d 匹配0到任意个数字。

  %D 匹配0到任意个非数字。

  %s 匹配0到任意个空格。

  %S 匹配0到任意个非空格。


  %? 匹配01个字符。

  %. 匹配1个字符。

  %+ 匹配1到任意个字符。

  %* 匹配0到任意个字符。


  %i 匹配时不区分大小写。

  %I 匹配时区分大小写(默认)。


例子:#regex {Hello World} {%* World} {#showme Matched &1 World} {#showme no match :( }



Repeat


语法:#[数字] {命令}


有时你需要重复执行一个命令,那么这就是最好的办法。


例子:#10 eat jinchuang ao

这条命令将使你连续吃10次金创药。



Replace


语法:#replace {变量} {原字串} {新字串}


这个命令将在{变量}中查找{原字串}并用 {新字串}替换。


如果{新字串}为空,那么变量中符合{原字串}的内容将被删除。


例子:#var {test} {bli bla blo};#replace {test} {bl} {tr}

上面的例子将把变量test的内容从“bli bla blo”替换为“tri tra tro”。



Return


语法:#return {内容}


#return可以让你跳出一个正在执行的触发。


你也可以用#return {内容}跳出一个函数,并将result变量的值赋为指定的内容。

北大侠客行Mud(pkuxkx.com),最好的中文Mud游戏!
 楼主| 发表于 2013-9-24 12:58:56 | 显示全部楼层
本帖最后由 alucar 于 2013-10-15 09:00 PM 编辑

Run


语法:#run{session} {shell命令}


#run命令用于运行一个unix shell命令,当shell命令结束后,相应的session也随之关闭。

(译注:unix专用,在wintin中就不要尝试了,不然会有不可预测的情况发生。)


你可以运行任何shell命令,甚至包括sshtelnetpythonphpperlruby等等。


例子:#run myserver ssh myname@myserver.com

这个例子将建立一个ssh连接,并且支持所有的TinTin++脚本语言。


例子:#run python python;#act {^cmd %1} {%1};print "cmd #showme <118>Hello World!"

这个例子将启动一个python shell,建立一个触发来执行所有以“cmd”开头的本文,并以红色显示“Hello World!”。


注:你也可以使用#script#system来执行shell命令。



Scan


语法:#scan {文件名}


#scan命令读取一个文件并把文件内容显示出来,它可以用于把ansi文件转换为html,也可以读取log文件。

(译注:使用#scan后需要按page uppage down刷新屏幕才能看到读入的内容。)



Script


语法:#script {变量} {shell命令}


#script命令让你可以在shell中执行命令。命令的输出内容将被以列表形式保存在变量中。这个命令可以用于执行LuaPHPPerlPythonTclRuby脚本。


例子:#script {result} {lua -e 'print("Hello TinTin++")'

例子:#script {result} {ruby -e 'print "Hello TinTin++"'}

例子:#script {result} {python -c 'print "Hello TinTin++"'}

例子:#script {result} {php -r 'echo "Hello TinTin++"'}

例子:#script {result} {tcl -c 'puts "Hello TinTin++"'}

例子:#script {path} {pwd}

如果没有给出{变量}参数,脚本命令的输出内容将被当作TinTin++的输入,并允许你用#showme#send命令来执行这一脚本输出。当然你也可以执行脚本文件。


如果给定{变量}参数,脚本命令的输出内容将以list变量的形式保存。你可以用$variable[1]$variable[2]……来读取具体内容。


注:你也可以用#run#system命令来执行shell命令。



Send


语法:#send {内容}


{内容}直接发送到mud,如果你想发送一个转义符的话这会比较有用。



Session


语法:#session {session名称} {地址} {端口号}


这条命令将以稳定的名称启动一个session,并连接到给定的服务器。


例子:#ses pkuxkx pkuxkx.com 8080


#session +#session –用于切换到下一个或上一个session,当然这只针对你打开了多个session的情况。#session <数字>将激活指定序号的session



Showme


语法:#showme {信息内容} {行号}


#showme显示的文本可以用于触发其他命令,也可以用于调试#action#substitute等。#showme中可以用$变量来显示变量信息。


例子:#showme $bla

如果你已经定义了变量“bla”,这条命令将显示bla变量的内容。


{行号}参数是可选的,作用与#prompt命令中的{行号}相同。



Snoop


语法:#snoop {session名称}


如果你有后台运行的session,这条命令能够让你观察到这些session的显示内容。



Speedwalk(快速行走)


快速行走功能让你可以不必输入分号就连续执行移动命令,你也可以在移动命令前加上数字来重复执行一个移动指定。你可以在#config中打开或关闭快速行走功能。


例子:2s5w3s3w2nw

如果没有快速行走功能,你将不得不输入:s;s;w;w;w;w;w;s;s;s;w;w;w;n;n;w



Split


语法:#split


这条命令用于将屏幕分为上下两部分,上方屏幕用于显示从mud服务器接收的信息,下方屏幕用于输入键盘指令。这样就可以避免在你输入文字的时候,由于接收到mud信息而被打断。


语法:#split {下屏行号} {上屏行号}


这是#split命令的一种高级应用,使你能更加精确地分配屏幕空间。


如果你使用了分屏,那我建议你用#prompt命令抓取一些提示信息并放到分屏栏上,否则提示信息可能被新的mud信息刷走。


注:你可以用#unsplit命令取消分屏。



Substitute


语法:#substitute {原信息} {新信息} {优先级}


#substitute命令用于改变mud输出的信息。在{原信息}中可以使用%199%的变量并在{新信息}中引用,变量%0不应在{原信息}中使用。“优先级”参数是可选的,它决定了这个替换语句生效的优先权,默认值为5


更多有关正则表达式的信息请查询Action(触发)的帮助文件。你可以在{新信息}中使用TinTin++的颜色代码来改变信息的颜色,默认情况下{原信息}中不包括颜色信息。更多关于颜色的信息请查询Colors(颜色代码)的帮助文件。


例子:#substitute {你说道:「%*} {<128>你说道:「<138>%1<128>}

执行上面的命令并say一句话来看看结果。


注:你可以用#unsubstitute命令删除一个替换。

北大侠客行Mud(pkuxkx.com),最好的中文Mud游戏!
 楼主| 发表于 2013-9-24 12:59:01 | 显示全部楼层
本帖最后由 alucar 于 2013-10-17 08:25 PM 编辑

Suspend


语法:#suspend


这条命令将让TinTin++进入后台运行并返回shell界面,按下^z也能达到同样的效果。如要返回TinTin++,你可以输入fg

(译注:与其他针对unixshell的命令一样,wintin就不要尝试了,很可能就回不来了。)



Switch


语法:#switch {条件} {语句}


#switch命令与其他语言中的switch语句类似,当执行#switch时,在{语句}部分的#case语句会与逐条与{条件}做比较并判断是否执行,当所有#case都不匹配时,#default语句将被执行。


#break命令可以跳出#switch,但是它并不象在c语言中那样是必须的,因为每个#switch中只有一个#case会被执行。


例子:#switch {1d4} {#case 1 hihi;#case 2 hehe;#default grin}



System


语法:#system {命令}


#system命令用于执行shell指令。


例子:#system ls

如果你正想读取一个机器人文件,却突然想不起文件名的时候,这就很有用了。

(译注:lsunix shell命令,相当于dos 下的dirwintin同样不用尝试了。)


注:你也可以用#script#run命令来执行shell指令。



Tab


语法:#tab {完整语句}


#tab命令将把一个语句增加到你的tab标签列表。当你按下Tab键时,TinTin++将从你的tab标签列表中寻找匹配的语句。这在输入一些比较长的命令时会很方便。


如果你输入的内容没有在tab标签中定义,TinTin++将在屏幕缓冲区中寻找可能匹配的内容。


例子:#tab part_abandon

输入pa然后按下Tab键,整条命令就会出现。


注:你可以用#untab命令来删除tab标签。



Textin


语法:#textin {文件名}


这条命令将读入一个文件,并把文件中的每一行发送到mud。发送的内容不会被TinTin++转换或加以解释,因此可以用来将一个脚本文件发送到mud提供的记事本之类的东西里面。当然如果你一次性输入太多东西的话,大部分mud会把你踢出去的。


例子:#textin desc1.txt

这个例子将把desc1.txt中的数据读入一个olc编辑器或其他类似的东西。



Ticker


语法:#ticker {名称} {命令} {间隔}


{名称}可以是你喜欢起的任何名字,它只在使用#unticker命令时需要。这条命令会按照{间隔}指定的秒数定时执行。


例子:#ticker {autosave} {save} {300}

这个例子将每隔300秒执行一次save命令。


注:你可以使用#unticker命令来删除一个定时器。



Variable


语法:#variable {变量名} {内容}


变量与之前在别名、触发中使用的%099的参数变量不同,你可以指定变量的名称,并且只要session没有关闭,定义好的变量会一直存在,除非你改变了它的值。变量可以保存在coms文件中,在不同session中的同名变量是独立的,可以有不同的值。对于每一个session,其中的变量都是全局意义的,你可以在变量前加上“$”号来获得变量值。


例子:#alias {target} {#var target %0}

     #alias {t} {perform throwing.tan $target}


变量名只能由字母和数字组成,这样你才能取到它的值。但如果你办不到这一点,也不必担心,这时你只需要做一件简单的事,把变量名放到括号里:


例子:#variable {cool website} {http://pkuxkx.com}

     chat 北大侠客行的主页是${cool website}


变量可以通过括号进行嵌套使用,以达到类似数组的效果。


例子:#var hp[self] 34;#var hp[target] 46


你可以用$variable[+1]来读取第一个嵌套变量的值,用$variable[-1]读取最后一个。$variable[-2]将返回倒数第二个变量的值,以此类推。如果想查看所有的嵌套标记,可以使用$variable[]


&variable可以查看嵌套变量的索引号。


注:使用#if {&{variable}}可以判断一个变量是否存在。


注:一个不存在的嵌套变量与一个存在的根变量将反馈0值。

(译注:此为直译,含义不明,可能是对照上一个#if的例子而言。)


注:你可以用#unvariable命令删除一个变量。



While


语法:#while {条件} {命令}


#while命令与c语言中的while命令类似,当条件为0(假)时,while循环就会终止。


例子:#while {$cnt>0} {#math cnt $cnt-1}



Wildcards(通配符)


通配符用于在正则表达式中匹配字符串。


“^”号开头的信息代表一个行首匹配,以“$”号结尾的信息表示一个行尾匹配。


以下内容适用于正则表达式。


  { }内的内容是一个与Perl语言兼容的正则表达式。


[ ] . + | ( ) ? * 这些符号将被当作普通文本处理,但在{ }内出现时除外。同时需要注意的是,此时将{ }( )代替。


  %w 匹配0到任意个字母。

  %W 匹配0到任意个非字母。

  %d 匹配0到任意个数字。

  %D 匹配0到任意个非数字。

  %s 匹配0到任意个空格。

  %S 匹配0到任意个非空格。


  %? 匹配01个字符。

  %. 匹配1个字符。

  %+ 匹配1到任意个字符。

  %* 匹配0到任意个字符。


  %i 匹配时不区分大小写。

  %I 匹配时区分大小写(默认)。


例子:#alias {bla%*}

这将显示所有以“bla”开头的别名。


例子:#if {"$test"=="%*%ibla%*"} {#showme true}

这可以用来检查变量test的内容是否包括“bla”字符串,不区分大小写。



Write


语法:#write {文件名}


这条命令将把所有的设置都存入一个文件。


例子:#write pkuxkx.tin

这个例子将把你的别名、触发、变量等等都写入pkuxkx.tin文件。



Writebuffer


语法:#writebuffer{文件名}


这条命令将把屏幕缓冲区的内容写入指定的文件,数据格式与log文件一样,可以在#config中设置。

(译注:TinTin++2.00.9没有这个命令。)



Zap


语法:#zap


这条命令将关闭当前的session,如果没有活动的session,则关闭TinTin++

北大侠客行Mud(pkuxkx.com),最好的中文Mud游戏!
您需要登录后才可以回帖 登录 | 注册

本版积分规则

Archiver|手机版|小黑屋|北大侠客行MUD ( 京ICP备16065414号-1 )

GMT+8, 2024-12-26 01:16 AM , Processed in 0.021905 second(s), 14 queries .

Powered by Discuz! X3.4

Copyright © 2001-2020, Tencent Cloud.

快速回复 返回顶部 返回列表