Project

Profile

Help

Alias » History » Sprint/Milestone 1

Vincent Le Goff, 10/10/2016 03:05 AM

1 1 Vincent Le Goff
h1. Aliases in CocoMUD
2
3
Aliases are a special feature of MUD clients that can be used to shorten commands.  An alias is itself a command, but instead of being sent to the server as is, it is first analyzed by the client, modified and extended if necessary.  Some aliases don't leave the client at all.
4
5
This document will introduce the concept of aliases and explain how to create and manage them.
6
7
h2. Adding an alias
8
9
You can create an alias using the interface or through the [[#SharpScript-syntax|SharpScript syntax]].  The interface being easier at first glance, it will be explained in first.
10
11
h3. Through the dialog box
12
13
In the menu bar, select Game -> Aliases.  You will find yourself in a dialog listing the current aliases for this world.  Note that aliases are usually created in a world, being shared by characters.  This will change in future versions.
14
15
In this dialog, you can add, edit or remove aliases.  By default, the list of alias will most likely be empty, so you can select *Add* to add one.
16
17
You will then have to choose an alias name.  This is the command you want to create, basically.  In this example, we're going to create a "tts" alias that enables/disables the text-to-speech in the client.
18
19
Enter "tts" in this field.  When you press Tab, you will be presented with a list of actions to be performed when you type this command.  For instance, you may want the "rs" alias to send two commands at the MUD server:  "reload" and "shoot".  In this case, you would select the action named "send one or more commands to the server".
20
21
In our example, we'll select "Enable/Disable TTS", since that's what we want to do when we type "tts" in the client.  Tab again and click the *Add action* button.
22
23
You will be prompted with a dialog asking you to review parameters to this action.  For this action, there is none, so you can press "OK" to add the action.
24
25
The new action has been added.  The cursor will be put in the list of current actions linked to this alias.  You can link an alias with several actions (even with the same action several times, to play several sounds, for instance, although it might not be very useful).
26
27
To summarize the dialog when you add or edit an alias, you will find:
28
29
* The alias' name.
30
* A list of actions that can be linked.
31
* The button to add this action.
32
* A list of actions that are currently linked with this alias.
33
* A button to edit the selected line of action.
34
* A button to remove this line of action from the alias.
35
36
You should get accustomed to this dialog, as it will be present for most configuration involving SharpScript.  It is, in fact, the SharpScript editor that do not ask you to edit the configuration file by hand.  You will find more examples in the rest of the documentation.
37
38
To save the alias, don't forget to select "OK" several times, until the dialog box is closed.
39
40
If you then type "tts" in the client, you should see (and hear):
41
42
<pre>
43
TTS off.
44
</pre>
45
46
Type it again to switch it on.  The text-to-speech will be disabled or enabled using this alias.
47
48
h3. SharpScript syntax
49
50
You can also add an alias by editing your configuration file and adding it there.  This solution might be preferred by some.
51
52
Open your configuration file for this world.  You will find it in the "worlds" directory.  Select the directory containing your world, then the "config.set" file.  You can open it with a small editor like notepad.
53
54
To add an alias, use the @#alias@ action with two parameters:
55
56
* The alias' name.
57
* The alias' actions to be performed.
58
59
If you want to create a "tts" alias that will enable or disable the text-to-speech, add in your file the following line:
60
61
<pre>
62
#alias tts #tts
63
</pre>
64
65
If you have several actions, don't hesitate to describe the alias on several lines:
66
67
<pre>
68
#alias go {
69
    #play sounds/go.wav
70
    #say {Here we go!}
71
}
72
</pre>
73
74
For an explanation of the SharpScript syntax, refer to [[SharpScript|the section describing SharpScript]].
75
76
h2. Editing an alias
77
78
At any time, whether you have created the alias in the dialog box or in the configuration file, you can edit it.  If you have created it in the configuration file, you can modify it through the interface, and vice versa.
79
80
Remember that the configuration is loaded when you select the world, which will most likely happen when you open the software.  If you modify the configuration file, restart the software to take it into account.
81
82
h2. Removing an alias
83
84
You can remove an alias through the dialog box or by editing the configuration file.  If you do it through the dialog box, remember the changes will be lost if you close the dialog but do not use the "OK" button.