Register forum user name Search FAQ

MUSHclient scripting

Description of MUSHclient world function: world.SendSpecial


Name SendSpecial
Type Method
Summary Sends a message to the MUD with various options
Prototype long SendSpecial(BSTR Message, BOOL Echo, BOOL Queue, BOOL Log, BOOL History);
Description

This sends the specified text to the world. It is like typing it into the command window.

A newline character is appended to the text you supply, as MUD commands normally are terminated with a newline.

The text may include imbedded newlines.

If the text has a trailing newline it is removed. In other words, text with a trailing newline will not end up with two newlines when sent to the MUD.

* If "echo" is true, the command will be echoed in the output window.

* If "queue" is true, the command will be queued (after any other pending commands), otherwise it will be sent immediately

* If "log" is true, the command will be logged to the log file, if one is open, and logging commands is enabled.

* If "history" is true the command will be added to the command history buffer.


Note: Available in version 4.14 onwards.


VBscript example
world.SendSpecial "go north", vbTrue, vbFalse, vbFalse, vbTrue
Jscript example
world.SendSpecial ("go north", true, false, false, true);
Lua example
SendPush ("go north", true, false, true, false)
Lua notes
The boolean arguments are optional and default to false.
Returns eWorldClosed : The world is closed
eItemInUse : Cannot be called from within OnPluginSent script callback
eOK: Sent OK
Introduced in version 4.14

See also ...

Function Description
LogSend Sends a message to the MUD and logs it
Note Sends a note to the output window
Send Sends a message to the MUD
SendPush Sends a message to the MUD and saves it in the command history buffer

Search for script function

Enter a word or phrase in the box below to narrow the list down to those that match.

The function name, prototype, summary, and description are searched.

Search for:   

Leave blank to show all functions.


Return codes

Many functions return a "code" which indicates the success or otherwise of the function.

You can view a list of the return codes


Function prototypes

The "prototype" part of each function description lists exactly how the function is called (what arguments, if any, to pass to it).

You can view a list of the data types used in function prototypes


View all functions

[Back]

Information and images on this site are licensed under the Creative Commons Attribution 3.0 Australia License unless stated otherwise.