CocoMUD client

h1. Channels in CocoMUD

CocoMUD offers an interesting feature of channels.  Channels are basically lists of messages and you can put whatever you want in them.  We often use CocoMUD channels to track game channels: when we receive a message on one of these channels (lie "public" or "ooc"), we can automatically capture this message and put it in a CocoMUD channel.  A simple key press could allow to display this channel and read all the messages in it.  This is pretty useful when you're exploring or figthing on the game, and don't have time to read all messages spoken by others, but you want to read them afterward.

We'll take this example for the rest of the documentation: an attempt to capture the context of a public channel.  This example also relates to [Triggers|triggers], which is barely a coincidence.

{{toc}}

h2. Creating a new channel

The first step is to create a channel, an empty list that will contain the messages we want to put in it.  Here, we'll create a channel named "public", for that's quite explicit.  Remember that channels can be used to capture any information, however.

In the CocoMUD menu bar, open *game* -> *channels*.  You find yourself in a dialog box showing current channels.  It's probable you don't have any at that point.  Go to the *add* button and click on it.  You will be asked the name of the channel.  Keep it short and explicit: here, we'll create a channel named @public@ .

We can now send information to this channel using [Triggers|triggers].  If you're not familiar with this feature, you might want to read the [Triggers|documentation about triggers] first.

h2. Feeding a channel with triggers

Okay, let's look at the two lines we may receive from the server.  If we send a message on the public channel, it would be displayed like that:

<pre>

[public] You say: my message to all

</pre>

If it's someone else who sends to this channel, we would have:

<pre>

[public] Somebody says: my message to all

</pre>

What's common and different in our two lines?

* Well, both begin with "public" between brackets, followed by a space.

* Then there's the author.  "you" or "somebody".  So we don't know what it will be, we could use an asterisk.

* Then is the word "say" after another space.  Wait!  When it's me, it display "you say", when it's somebody, it displays "somebody says".  What to do?

* After a colon and another space is our message.

To solve our issue between say/says, we have two options:

* Either we group both cases, writing "say*" (meaning say followed by nothing or anything).

* Or we could write two triggers.

Personally I would advise the latter, but I know some of you would prefer the former.  So let's work with both.

h3. One single trigger

What would our trigger look like in the end?  Ready?

<pre>

[public] * say*: *

</pre>

Three asterisks!  The first will contain the name of the one speaking.  Either "You" or the name of the player speaking on this channel.  The second variable will contain either "s" or nothing.  We shouldn't need it.  The third variable contains the message itself.

So to create this trigger through the interface:

* Open the menu bar, *Game* -> *Triggers*.

* Click on *Add* to create a new trigger.

* Enter @[public] * say*: *@ before pressing Tab.

* Select "Feed a channel with a message".

* Click on the *Add action* button.

* In the name of the channel to be fed, enter @public@ (this is assuming the channel exists in CocoMUD).

* In the message to feed to the channel, enter:

<pre>

$1: $3

</pre>

* Click on *OK* several times to close the dialog and save the trigger.

bq. What was that @$1 $3@?

@$1@ contains the name of the one speaking.  @$3@ contains the message.  So when we receive the line:

<pre>

[public] Jamie says: well done!

</pre>

Our channel will be fed with the following line:

<pre>

Jamie: well done!

</pre>

You could have done the same thing with a single line of SharpScript:

<pre>

#trigger {[public] * say*: *} {#feed public {$1: $3}}

</pre>

That's a bit harder to understand, but if you're familiar with SharpScript, that's definitely quicker.

A last word regarding this trigger: you may have noticed that we don't play a sound when receiving this trigger.  Nothing prevents you from adding another action to the trigger though.  Similarly, to do it with SharpScript, you would enter:

<pre>

#trigger {[public] * say*: *} {

    #feed public {$1: $3}

    #play sounds/public.wav

}

</pre>

h3. Two different triggers

As I have explained, to solve the problem of say/says, we could have created two different triggers.  That makes for a longer configuration, a little bit, but that's easier to read, in my opinion.  Sometimes it will not be possible to do otherwise, depending on the language the MUD is in.

Our two triggers would be:

<pre>

[public] You say: *

[public] * says: *

</pre>

I don't know about you, but I find it much easier to read.  Our first trigger only fires when we send a message on this channel (perhaps we could say that we won't play a sound in this case) and the second one will fire when it's somebody else who's speaking.  I'll give you the SharpScript instructions to create these triggers, but as usual, you could do the same through the interface:

<pre>

#trigger {[public] You say: *} {#feed public {You: $1}}

#trigger {[public] * says: *} {

    #feed public {$1: $2}

    #play sounds/public.wav

}

</pre>

What you'll choose is entirely up to you and the context, pick whatever feels more comfortable.

h2. Bind a channel to a macro

h2. Remove a channel