Script function

world.ChatPersonal

Type

Method

Summary

Sends a chat message to a particular person

Prototype

long ChatPersonal(BSTR Who, BSTR Message, BOOL Emote);

Description

This sends a "say" or "emote" to the person(s) of that name.

If more than one person has the specified name, all will get the message. If this is a problem, use ChatID to send a message to a specific user by number rather than name.

If the "emote" parameter is zero (false) then you will "say" the message, otherwise you will emote it.

If you "say" the message, it will appear like this on that person's client:

Nick chats to you, 'hi there'

If you "emote" the message, it will appear like this on that person's client:

To you, Nick laughs

The different message (compared to ChatEverybody or ChatGroup) is so you can tell the message was addressed to you personally.

The message will be sent even if you have set the "ignore" flag on that person, as presumably you want to override it, if you are addressing a message to them directly.

Available in MUSHclient version 3.37 onwards.

VBscript example

ChatPersonal "Nick", "hi there", 0  ' say it
ChatPersonal "Nick", "laughs", 1  ' emote it

Jscript example

ChatPersonal ("nick", "hi there", 0);  // say it
ChatPersonal ("nick", "laughs", 1);  // emote it

PerlScript example

ChatPersonal ("nick", "hi there", 0);  # say it
ChatPersonal ("nick", "laughs", 1);  # emote it

Python example

world.ChatPersonal ("nick", "hi there", 0)  # say it
world.ChatPersonal ("nick", "laughs", 1)  # emote it

Lua example

ChatPersonal ("nick", "hi there")  -- say it
ChatPersonal ("nick", "laughs", true)  -- emote it

Lua notes

The Emote argument is optional and defaults to false.

Return value

eChatPersonNotFound: No person of that name connected
eOK: Sent to at least one person

See Also ...

Topics

Chat system
Getting started

Functions

(ChatAcceptCalls) Accepts incoming chat calls
(ChatCall) Calls a chat server (makes an outgoing call) using the MudMaster chat protocol
(ChatCallzChat) Calls a zChat chat server (makes an outgoing call)
(ChatDisconnect) Disconnects a current chat call
(ChatDisconnectAll) Disconnects all current chat calls
(ChatEverybody) Sends a chat message to every connected chat user
(ChatGetID) Looks up what chat ID (identifier) corresponds to a particular chat name
(ChatGroup) Sends a chat message to every connected chat user in the specified group
(ChatID) Sends a chat message to a particular chat session
(ChatMessage) Sends a message to a chat user (raw format)
(ChatNameChange) Changes your chat name
(ChatNote) Does a note using ANSI codes for the chat system
(ChatPasteEverybody) Pastes the clipboard contents to every connected person
(ChatPasteText) Pastes the clipboard contents to that person
(ChatPeekConnections) Sends a "peek connections" message to the specified chat user
(ChatPing) Sends a ping message to the specified chat user
(ChatRequestConnections) Sends a "request connections" message to the specified chat user
(ChatSendFile) Starts sending a file to the specified chat user
(ChatStopAcceptingCalls) Stops this world from accepting chat calls
(ChatStopFileTransfer) Stops a file transfer in progress to that chat user
(GetChatInfo) Get information about a chat connection
(GetChatList) Gets the list of chat sessions
(GetChatOption) Gets the value of a chat session option
(SetChatOption) Sets the value of a chat session option

(Help topic: function=ChatPersonal)