Hi guys, this is probably something I missed in the documentation.

How exactly do I make commands (/sendemail, /block, everything starting with /)? I have been reading the initial documentation and I can't seem to find this. I have my function ready, I just want a way to call it with a command.

Thanks a lot in advance!

You can use OnGetScriptCommands() to return an XML list of commands, and then OnEvent_ChatWndSendMessage() to capture the event of the user sending the message.

As whiz said, you need to handle the command parsing yourself using an OnEvent_ChatWndSendMessage handler.

In its simplest form, that would look like this:

Javascript code:

---

function OnEvent_ChatWndSendMessage(ChatWnd, Message) {
    if(Message.indexOf("/mycommand") === 0) {
        // Do awesome stuff here
        // Then return something: this can be a replacement message
        // or an empty string. Either way, you must return something
        // to let Plus! know that your script handled this command.
        return "";
    }
}

---

• The parser doesn't check whether the entered command actually ends after "/mycommand". It could be that the user sent "/mycommandisalie" and it would still be handled by the parser. Therefore, you would have to check whether the command is followed by a space character or is at the end of the message.
  
• Commands should be case-insensitive, "/mycommand" should be treated the same way as "/myCommand" and "/MyCoMManD". This can easily be solved by converting the message to lowercase first.
  
• If you want to accept parameters for your command, such as "/mycommand hello 123", you'll need to do some extra manipulations to retrieve those.

Javascript code:

---

function OnEvent_ChatWndSendMessage(ChatWnd, Message) {
    if (/^\/([^ \n\r\v\xA0\/][^ \n\r\v\xA0]*)[\s\xA0]?([\s\S]*)/.exec(Message)) {
        var command = RegExp.$1.toLowerCase();
        var parameter = RegExp.$2;
        if(command === "mycommand") {
            // Do awesome stuff here and return something
            return "";
        }
    }
}

---