world.ChatRequestConnections

MUSHclient script function (Method) — introduced in version 3.37

Sends a "request connections" message to the specified chat user

Prototype

long ChatRequestConnections(long ID);

Data type meanings

Description

Requests the specified chat user to send a list of its public connections. This is the same as doing this:

ChatMessage ID, 2, ""

The chat user who receives that will (should) respond with a list of their current chat connections that they have (excluding the connection to you. MUSHclient will then try to connect to them directly (so that you can chat with them without having to go through the other person, for example, in case they disconnect).

If you want to see who those users are first, use ChatPeekConnections.

VBscript example

ChatRequestConnectionsChatGetID ("nick")

Jscript example

ChatRequestConnections(ChatGetID ("nick"));

PerlScript example

ChatRequestConnections(ChatGetID ("nick"));

Python example

world.ChatRequestConnections(world.ChatGetID ("nick"))

Lua example

ChatRequestConnections(ChatGetID ("nick"))

Return value

eChatIDNotFound: That chat ID is not currently connected.
eOK: Request connections message sent.

Return code meanings