Heynow Software
About Savitar FAQ Screenshots Download Register Manual Forums

Savitar User's Manual

6. Local Command Reference

There are a number of commands you can give to directly to the Savitar application which don't get sent to the remote world, they're "local" to Savitar. They allow you to accomplish many useful tasks.

To distinquish Savitar local commands from commands you send to your server, local commands are prefixed with the your world's command marker character(s). The default Savitar command marker is '##'. An example of this would be typing "add macro" would send "add macro" to your server, giving you unexpected results, whereas type "##add macro" would direct Savitar to handle the command locally, not passing it on to the server.

The following is a description of Savitar's local commands: Each command is listed in bold followed by a statement of its syntax, a description of the command, and example usage(s).

add macro

syntax: add macro <XML STATEMENTS>

Allows you to add a macro to the active world.

Example:

##add macro <MACRO NAME="MACRO_UP" KEY="KP+"><VALUE>up</VALUE></MACRO>

add trigger

syntax: add trigger <XML STATEMENTS>

Allows you to add a trigger to the active world.

Example:

##add trigger <TRIGGER NAME="http://" FLAGS="matchToEndOfWord" FACE="underline" COLOR="#0000FF" AUDIO="silent" SOUND="ah choo" VOICE="Zarvox"><WORDEND>&quot </WORDEND><SAY>Click on the speaker icon to hear this.</SAY></TRIGGER>

add world

syntax: add world <XML STATEMENTS>

Allows you to add a world to the World Picker.

Example:

##add world <WORLD NAME=Ancient Anguish" URL="telnet://ancient.anguish.org:2222" FLAGS="ansi" CMDMARKER="&cmdmark;" VARMARKER="&varmark;" WILDMARKER="&wildmark;" FORECOLOR="#FFFFFF" BACKCOLOR="#000000" FONT="Monaco" FONTSIZE="9" RESOLUTION="80x24x8" POSITION="50,50" ZOOMED="FALSE" OUTPUTMAX="102400" OUTPUTMIN="25600" RETRYSECS="30"><LOGOFFCMD>quit</LOGOFFCMD></WORLD>

broadcast

syntax: broadcast <input>

The broadcast command allows you to send <input> to all active world sessions simultaneously, thus allowing you to type <input> one time in one window and all connections will get the input.

Example:

##broadcast say Hey everybody! Its a girl!!!

close status

syntax: close status input | output

This command closes an input or output status pane. See the command 'set status' for info on how to open and set status panes.

Examples:

##close status input

##close status output

close window

syntax: close window <"window-name">

Allows you to close a given window. If the window in question is a world window, this will close the connection. Issuing this command a second time will then close the window.

Examples:

##close window "Sample Text Window"

##close window "Sample World Window"

disable trigger

syntax: disable trigger <"trigger name">

Allows you to disable a given trigger.

Example:

##disable trigger "http://"

dump colors

syntax: dump colors

Allows you to list their ANSI colors to the active world window's output pane.

Example:

##dump colors

dump macros

syntax: dump macros

Allows you to list their universal macros and the active world's world-specific macros to the active world window's output pane.

Example:

##dump macros

dump triggers

syntax: dump triggers

Allows you to list their universal triggers and the active world's world-specific triggers to the active world window's output pane.

Example:

##dump triggers

dump worlds

syntax: dump worlds

Allows you to list the current worlds (from the World Picker) to the active world window's output pane.

Example:

##dump worlds

enable trigger

syntax: enable trigger <"trigger-name">

Allows you to enable a given trigger.

Example:

##enable trigger "http://"

help

syntax: help [<local-command>]

Gives basic usage information for all local commands or the specified command.

Examples:

##help

##help dump triggers

history

syntax: history

Displays the last 100 commands entered in the input pane. See the 'recall' local command for how to recall a command from history.

Example:

##history

kill

syntax: kill <taskID> | all

Allows you to kill-off a task created by the ##task command. Specifying 'all' will kill all tasks. The <taskID> for a task is found from the output of ##show tasks

Examples:

##kill 3

##kill all

open text window

syntax: open text window "window-name" [for file ":filepath-in-app-folder"] | ["full-filepath"] [at=(horiz,vert)] [size=(width,height) | size=(colsxrows)]

Allows a user to open a text window (with or without loading a given text file to display in it), and also allows them to control where and how large to open it.

Examples:

##open text window "Sample Text Window"

##open text window "Test" for file ":test"

##open text window "Test 2" for file "HD:Text Files:test2"

##open text window "Location/Size Control" at 50,50 size=(20x20)

play

syntax: play "<sound-file-name>"

Allows you to play a sound file (which should be placed in a "Sounds" folder within your Savitar folder.

Example:

##play "boing.wav"

recall

syntax: recall <command-index>

Recalls a command from the command history by way of its command-index. See the local command 'history' for how to display the command history.

Example:

##recall 23

regex

syntax: regex "<text>" "regular-expression"

Allows you to test a regular expression and will list macros it would set.

Example:

##regex "Well... hi Bob, did you find it?" "hi +\b(.*), +\b(.*)$"

regex "Well... hi Bob, did you find it?" "hi +\b(.*), +\b(.*)$" ==> success
%%0 ="hi Bob, did you find it?"
%%1 ="Bob"
%%2 ="did you find it?"
 

select window

syntax: select window "<window-name>"

Allows you to bring a given window to the front.

Example:

##select window "Sample Text Window"

send window

syntax: send window <"window-name"> <text-message>

Allows you to send a given snippet of text to a given text window.

Example:

##send window "Sample Text Window" Here is some text.

set ansi

syntax: set ansi [on|off]

Allows you to turn ANSI interpretation on/off for the active window.

Example:

##set ansi on

##set ansi off

set autoclose

syntax: set autoclose [on|off]

Allows you to determine whether the active world window will prompt for reconnect (off) or simply close automatically (on).

Example:

##set autoclose on

##set autoclose off

set cronly

Syntax: cronly [on|off]

Allows you to determine whether the active world will postfix each line with a carriage return & linefeed (off) or a carriage return only (on).

Example:

##set cronly on

##set cronly off

set echo

syntax: set echo [on|off]

Allows you to determine whether the active world will echo input.

Example:

##set echo on

##set echo off

set html

syntax: set html [on|off]

Allows you to turn HTML interpretation on/off for the active window.

Example:

##set html on

##set html off

set macro

syntax: set macro "<macro-name>" <value>

Allows you to set a given macro to a given value.

Example:

##set macro "Test" test

set marker

syntax: set marker <command | variable | wildcard> value

Allows you to set the command, variable, or wildcard marker for the active world.

Examples:

##set marker command ##

##set marker variable %%

##set marker wild $$

set status

syntax: set status output | input <message>

This will display a <message> on the status panel at the top of the output pane or input pane (determined by either specifying 'output' or 'input' as types.) If the pane isn't currently there, this command will open the pane first and then display the message. Subsequent 'set status' commands will replace the pane's current contents with the new contents.

Examples:

##set status output Hello world.

##set status input My hitpoints are at %%hitpoints. I have %%gold gold pieces remaining.

show tasks

syntax: show tasks

Displays a list of currently running tasks.

Example:

##show task

task

syntax: task <frequency> <command>

Allows you to submit a <command> to be repeated every <frequency> seconds.

Examples:

##task 300 date

##task 60 ##upload my harddisk:savitar:scripts:refresh.txt

tell application

syntax: tell application "<application-name>" to <AppleScript command line>

Allows you to send Applescript commands to a given application.

Example:

##tell application "Finder" to open folder "Savitar™ 1.1 Ä" of folder "Internet & Networking" of startup disk

upload

syntax: upload <file>

Allows you to upload the contents of a text file <file> to the connect world. You have to give a full or partial Mac Classic OS pathname. Text uploaded to the world is not parsed or interpreted by Savitar in any way.

Example:

##upload my harddisk:savitar:scripts:refresh.txt

wait

syntax: [wait=n]

Allows you to have Savitar pause n ticks (tick=1/60 second) before sending a given command. This is useful if you want a trigger send a given reply after a given amount of time.

Example:

##[wait=120]wave

Previous Page Table of Contents Next Page