紅貓的重生世界

KEY

Syntax: #KE key command [class] [options]

將指令設到按鍵。key應該是按鍵的全名，例如 F1、CTRL-A、或ALT-F2。

另一個語法，可以使用<key>=command如同設值敍述。
class是key要設到哪個類別的名字。如果省略或空白，使用預設類別。
選項是巨集鍵特殊選項的字串列表。合法的選項有：
"append"　添加指令到命令列
"nosend"　防止指令送出給MUD
"chain"　　巨集串連(daisy chain)

通常來說，指令會送到MUD而且不會碰到命令列。
如果append選項被設了，指令會添加到命令列現有的文字之後。
通常使用了append選項就會一起使用nosen選項讓文字不會送到MUD去。
chain選項是特殊案例，只有在命令列最後一個字是空白字元時會添加上去，
在這個情況下會添加到命令列最並把整個指令送到MUD，
否則，巨集指令正常地單獨送到MUD，參考Introduction to Macros頁面得到更多資訊。

GAUGE

Syntax: #GAUGE id caption [value] [maxvalue] [lowvalue] [class] [normcolor] [lowcolor] [backcolor]

建立一個圖形化測量，可以視覺化追蹤算式的值。例如，你可以用gauge追蹤你的血量、法力等等。
gaugu是按鈕的特殊版本。要更改一些gauge的特殊屬性，你需要使用設定編輯器(Settings Editor)。
#gauge指令可以用來快速設定或更改gauge的主要屬性。

id是給這個gauge的短名，你可以用在腳本裡，id不會在gauge的任何地方畫出來。

caption是顯示在gauge中間的文字，如果你不想顯示任何文字可以留空白。

value是按鈕追蹤的算式。例如，要追蹤@hp變數，你會使用@hp當這項的值。這可以是完整算式或只是變數參考。

class是gauge要放在哪個類別。

maxvalue是用來決定gauge最大值的算式。

lowvalue是用來決定gauge使用的顏色的算式。如果gauge現在的值小於lowvalue，則使用lowcolor，否則使用normcolor。
color跟%color函式使用的是相同的名字。

backcolor是gauge的底色，預設是銀色(silver)。

BUTTON

Syntax: #BU id|number

觸動命名的或編號的按鈕，通常是設到巨集鍵上。
number參數可以是變數，但必需展開(evaluate)成數字值。
除了使用按鈕列上的數字位置來指定按鈕，也可以用它們的id來指定按鈕。

這個指令也可以用來定義一個按鈕，這語法用在ascii export/import的過程。
如果number是0，指的是越過上一個按鈕的按鈕，用來添加一個新按鈕到列表，語法是：

#BUTTON id|number Off-caption On-command On-caption Off-command Value-expression Variable-name Bitmap-filename AutoSize Width Height AutoPos Top Left Off-color On-color Button-Kind Bitmap-margin Classname Options ToolTip ID PanelNum

對於multi-state按鈕，On-caption、Off-command跟On-color可以是list來表示按鈕的不同state

ADD

Syntax: #AD variable amount

這指令讓你可以執行簡單的算術，amout參數給的值，會加到variable的現值。
如果amount不是數字，會發生error。amount也可以參考到另一個變數，增加列出的變數的現值。
要減去一個值，使用負值。

這是唯一額外實作的的特殊數學函式，如同TINTIN的完整#math指令也是有的。

MATH

Syntax: #MAT variable expression
Related: #ADD

將expression的值設到variable，expression可以包含數字、邏輯、跟文字函式。expression裡的任何變數會被展開。

這二個字，中文可翻成展開跟求值，有時我二者都翻成展開。

在zmud裡
expand是把variable或alias取代成實際的值
evaluate是把算式的值求出來

這二者在zmud裡常常會弄混，
下面雜七雜八的把常用到地方列出來。
實際在使用上，不用記住也沒問題，常用#say或#echo來除錯，把中間值印出來
當發現沒有如預期的expand或evaluate時，再用<>或[]的語法做強迫就可以了

FUNCTION

Syntax: #FU name value [classname]

這個指令用來建立使用者定義的函式(function)。
name是function的名字，value是設給function的算式。可以使用參數%1到%99來拿到傳給function的參數。

GVARIABLE

Syntax: #GVAR variable value [defaultval] [classname]

將指定的value設到全域variable。
你不用寫出變數字元(@)，這讓你定義變數時跟自定的變數字元無關。

如果給定defaultval(預設值)，變數在讀取設定檔時或使用#reset指令時，會初始成預設值。
要指定沒有預設值，把這個參數留空，或給_nodef值

當參考到@variable時，zmud先在角色自己的設定裡檢查變數名字，如果沒找到，尋找全域變數

VARIABLE

Syntax: #VA [variable] [value] [defaultval] [classname]

跟#alias指令類似，將指定的value設到variable。
你不用寫出變數字元(@)，這讓你定義變數時跟自定的變數字元無關。

另有替代的語法 variable = value或variable := value。

如果給定defaultval(預設值)，變數在讀取設定檔時或使用#reset指令時，會初始成預設值。
要指定沒有預設值，把這個參數留空，或給_nodef值

當使用時沒有任何參數，所有的變數會被顯示。如果variable是誰一的參數，只有它的值會被顯示。

PATH

Syntax: #PA [pathname]
Related: #MARK #RETRACE #MAP

如果pathname省略，顯示現在記錄的path。
如果給定pathname，現在記錄的path會存到pathname這個變數裡。
方向字元(.)會自動加到變數名字。

RECORD

Syntax: #REC [aliasname]
Related: #ALIAS

啟動/關閉紀錄alias。
當第一次輸入#record時，zmud開始記綠你送到MUD的所有指令。你可以在記錄過程中再打#record一次監控記錄的東西。
當你打完了指令想要存起來，輸入#record後面加上你要建立的alias名字。
如果你用的alias名字是off(#record off)，會停止記錄而且不儲存。