MUSHClient 脚本上手指南
脚本介绍 (一)
Copyright 1999 Gammon Software Solutions
脚本允许你更大地控制 MUSHclient 和反应你连接的游戏世界。
你可以通过脚本做到下面的功能：
* 以更复杂的方式响应触发器(triggers)
* 书写你自己的命令处理器以操作你自己的输入
* 响应定时事件
* 在世界的打开，关闭，连接和断开时进行特殊的处理
1. 例子
可以通过一个简单的例子告诉你脚本的一般含义，假设你要创建一个叫“greet”的指令，
通过它把“hi there”说上 10 遍，用脚本可以这么做：
Sub Greet
Dim iCounter
for iCounter = 1 to 10
world.send "Say Hi there"
next
end sub
你可以把这个子程序放进一个脚本文件中 (比如说用 Notepad 输入)，然后将 MUSHclient
的脚本引擎指向这个文件——通过使用 World Configuration 菜单中的 Scripts 面板。
然后输入：
/greet
这个脚本将会把 "Say Hi there" 发送 10 遍到游戏世界中。"/" 字符是“脚本转义”字符
(如果你喜欢的话，也可以改成其他的字符)，所以所有 "/" 后面的字符都会被解析为一个
脚本命令。
2. 可用的语言
MUSHclient 目前使用 Microsoft 公司提供的 VBScript 和 JScript 脚本引擎， 而并没有
使用一个专门的脚本语言，也就是说，如果你熟悉 Visual Basic 的话，你会觉得VBscript
很容易学，如果你熟悉 C 的话，会觉得 JScript 容易学。
不管怎么说，即便你没有任何编程经验(也许大部分 MUD 玩家都有)，仍然会觉得 VBscript
易于上手。
3. 脚本函数概要
最新的所有脚本函数概要被放置在这个网页上：
http://www.mushclient.com/mushclient/functions.htm
Copyright 1999 Gammon Software Solutions
脚本语言 (二)
Copyright 1999 Gammon Software Solutions
如何使用 VBscript 或者 javascript 编程已经超过了这个说明文件的范围，不过已经有很
多不错的书籍介绍这两种语言的编程，同时，网上也能找到许多说明文件和相关的文档。
或许一个非常简易的 VBscript 介绍可以帮助你上手……
1. 子程序
大多数动作都发生在子程序中，这些子程序被称为 "sub"。每个子程序都有它们的名字和可
选的参数，信息就是通过这些参数传导的。
子程序可以这样声明：
sub my_subroutine
' ------- 这里是一些说明
end sub
你可以在单引号 ' 后边放置一些注释，就像上面的例子那样。
这里有个当计时器(timer)被激发(fire)时呼叫的子程序：
sub on_hourly_timer (thename)
world.note "My hourly timer called " & thename & " has just fired!"
end sub
这个子程序只有一个参数，即该计时器的的名称。
2. 变量
VBscript 中有一个叫 "variant" 的单独的变量类型，可以放置字符串，数字，曰期，和其
他的东西。
可以使用 "dim" 来声明一个变量，例如：
dim myname
dim thedate
dim thecounter
你可以用 "=" 符号来给变量赋值。
比如说：
Myname = "Nick Gammon"
thedate = #23/05/97"
thecounter = 42
Copyright 1999 Gammon Software Solutions
安装脚本 (三)
Copyright 1999 Gammon Software Solutions
可以通过如下的步骤安装脚本：
1. 如果需要的话，从 [url]www.microsoft.com[/url] 网站下载 VBSCRIPT.DLL 或 JSCRIPT.DLL。如果
你已经安装了 Microsoft Internet Expolorer 3 或以上，那你应该已经安装了这些DLL
文件，可以跳至第 4 步。
把适当的 DLL 文件放到你的 Windows 系统目录，Windows 95/98/Me 下是 C:\windows\system，
Windows NT/2K/2003 Server 下是 C:\WINNT\system32。
3. 通过 MUSHclient 的 World Configuration 对话框 "Scripts" 面板中的 "Register"按
钮来注册该 DLL 文件。
4. 使用 NotePad 或者其他文本编辑器来书写你的脚本源文件。可以从这个简单的例子开始：
sub test
world.note "Hello there"
end sub
5. 把它保存为一个文件 (如：Worldname.VBS)。
6. 使用脚本配置界面的 "Browse" 按钮来告知 MUSHclient 你使用的脚本文件。
7. 点击脚本配置界面中的 "Enable script" 以启用脚本功能。
8. 你现在应该可以从你的命令行窗口中访问这个脚本文件了，如果你完成了第四步中的那个
子程序，那么可以输入：
/test
你会看到 "Hello there" 出现在输出窗口中。
VBscript 版本号
比较重要的一点是了解你在用哪个版本的 VBscript。要测试你使用的版本是否 MUSHclient
测试过的或更新的版本，可以输入：
/world.note ScriptEngineMajorVersion
你可以在输出窗口中看到 "2" (或以上)。
/world.note ScriptEngineBuildVersion
你应该会在输出窗口中看到 "1125" (或以上)。
Copyright 1999 Gammon Software Solutions
(To be continued)
