Project

Profile

Help

Triggers » History » Sprint/Milestone 3

Vincent Le Goff, 01/16/2017 10:43 PM

1 1 Vincent Le Goff
h1. Triggers in CocoMUD
2 2 Vincent Le Goff
3
Triggers may very well be the most powerful feature of any MUD client.  CocoMUD offers an advanced system of triggers, which will be discussed and presented with examples in this documentation.
4
5
{{toc}}
6
7
h2. What is a trigger?
8
9
Usually, when you enter a command, the server to which you are connected "replies" with one or more lines.  This reply, just like the command you sent, is mere text (sometimes with little additions, like colors).
10
11
Triggers can intercept a specific line of text and react to it to do something.  That's the basic definition of any trigger:  I react to something (one or more lines sent by the server) and I do something in response (playing a sound, changing the text, sending another command, saving some parts of the line, moving the cursor and so on).
12
13
Since triggers are so powerful, their setting has been spread on several layers.  You don't need to understand, or even know, the most advanced type of trigger to use this feature.  This documentation will walk you through the basic setting of triggers, until the setting of most advanced ones.
14
15
h2. Creating a trigger
16
17
Let's begin with something simple: a trigger that plays a sound when someone (anybody) speaks in a channel.
18
19
This will obviously differ on every MUD, so don't hesitate to adapt this example.  For this example, we'd say we can use the "chat" command to send a message to everyone logged to the MUD.  The command we will type should be like this:
20
21
<pre>
22
chat hello everyone!
23
</pre>
24
25
And if the MUD behaves, it should reply with:
26
27
<pre>
28
[public] You say: hello everyone!
29
</pre>
30
31
Similarly, if someone else speaks on this channel, you might see something like:
32
33
<pre>
34
[public] Aaron says: hi there
35
</pre>
36
37
In short, if we want to intercept the messages on this channel, we need to watch for lines that begin by "[public]" (that is the word "public" between brackets).
38
39
bq. Why should we intercept these messages, anyway?
40
41
If you're new to triggers, you might wonder why it's useful.  The answer in that specific case could be that, if we receive a message on the public channel, the client could play a sound to alert us.  That's on this task we're going to work.
42
43
So we're going to see how to create a trigger that:
44
45
* Reacts when it receives a line beginning with "[public]".
46
* Plays a sound when it does.
47
48
Like most features on CocoMUD, triggers can be created either through the interface or through SharpScript.  We'll see the former first:
49
50
h3. Through the interface
51
52
To add, edit or remove triggers, select *Game* in the menu bar, then *Triggers*.
53
54
You will find yourself in the list of current triggers configured for this world.  This list might very well be empty at first.  To create a trigger, click on the *Add* button.
55
56
A new dialog box opens.  The cursor should be in an edit field, where you're asked to type your trigger.  That's the reaction part, the place where you will specify what fires your triggers.
57
58
In our example, we've determined that our trigger should be executed whenever a line "beginning by @[public]@ is detected.  You can type @[public]@ in this field, but don't leave it just yet: if we create a trigger @[public]@, it will only fire when the server sends a line containing *only* @[public]@.  That's not the case for us, we want for our trigger to fire when the line begins with, not only contains @[public]@.  To do that, we'll have to add an asterisk (@*@) after @[public]@.  If we type @[public]*@ in our trigger, CocoMUD will know that we are looking for lines that begin with @[public]@ followed by something (no matter what).
59
60
You might recognize this syntax, it's the same we use to create [[Alias|aliases]] with variables.  And that's not a coincidence, we'll see later why.
61
62
For the time being, you can write in this edit field:
63
64
<pre>
65
[public]*
66
</pre>
67
68
Press Tab: you find yourself on a list of possible actions to be performed when this trigger fires.  In our example, we want our trigger @[public]*@ to play a sound.  So browse this list until you find:
69
70
<pre>
71
Play an audio file
72
</pre>
73
74
Then press Tab again and click on the *Add action* button.
75
76
You are now asked to configure this action.  What audio file do you want to play when this trigger fires?  You have a *Browse* button if you want to select the file in your file system.  And once selected, you have a *Test* button, to check that CocoMUD can play this audio file just right.  If everything works, just press *OK*.  The action will be added.  The cursor is moved into a list where you see only one item:
77
78
<pre>
79
#play whatever.wav
80
</pre>
81
82
Of course, the "whatever.wav" will be replaced by your file path and name.
83
84
This is the sharp editor: it is used by every feature ([[Alias|aliases]] or [[Macros|macros]] for instance) that needs to execute complex actions at some point.  The window can be a little intimidating at first, but as you've seen, adding an action isn't that complicated.  So here is a brief summary of the trigger dialog with the sharp editor:
85
86
* The first thing to set is the trigger itself (the part that will fire the trigger, @[public]*@ in our case).
87
* Below is a list of actions currently associated with this trigger.  It's a list of actions (what to do when this trigger fires)?  You can add more than just one action.  Note that this list is disabled if it's empty.
88
* An *Edit* button, to edit the selected action.  For instance, in our case, if you've changed your mind and want to play a different audio file, you need to select this line and click on *Edit* to change the audio file.
89
* A *Remove* button, to remove this line of action.
90
* Still below is another list of actions.  This time, it's a list of actions you could desire to add.  That's the list we browsed through when trying to play a sound if this trigger fires.  We won't describe all of them, but you'll see other examples in this documentation.
91
* Then is a button to *Add* the action you have selected.  Remember that you can connect a trigger with zero, one, two or more actions, there's no real limit.
92
* There are other checkboxes and options in this dialog that we will discuss later.
93
94
You can now press on the *OK* button, since we did what we wanted: our @[public]*@ trigger is connected to the action to play a sound.
95
96
You will find yourself in the list of triggers again, with your newly created trigger.  You can press *OK* again to close this dialog and save the trigger to your configuration.  If you don't press *OK*, the trigger will not be saved.
97
98
To see if it works, let's try to fire this trigger!  You could send to the server something like:
99
100
<pre>
101
chat does it work?
102
</pre>
103
104
If everything goes well (assuming, one more time, that the server answers the way we have planned), it should send you something like:
105
106
<pre>
107
[public] You say: does it work?
108
</pre>
109
110
And you should hear a sound, the sound you have selected.  There!  It wasn't that complex, was it?
111
112
h3. Through SharpScript
113
114
As usual, the interface allows to manipulate potentially complex settings, but they all are converted to SharpScript in the end.  Setting the trigger we have worked on above in SharpScript is quite simple.  You can enter the following command in your MUD client, or write it in your "config.set" file:
115
116
<pre>
117
#trigger [public]* {#play path/to/sound.wav}
118
</pre>
119
120
It's a SharpScript instruction.  From left to right:
121
122
* @#trigger@ is the name of the action.  Here, @#trigger@ just creates a new trigger.
123
* @[public]*@ is what should fire our trigger.  Just like above, we have specified @[public]*@ , which means @[public]@ followed by anything.
124
* Then we specify the action or actions to be executed when this trigger fires.  Here, we have @#play path/to/sound.wav@.  @#play@ is another SharpScript action that just plays the sound you give it in argument, if it can.  Notice that we have surrounded our call between braces, because there is a space between the name of the function (@#play@) and the argument of the function (@path/to/sound.wav@).
125
126
Adding a trigger using the SharpScript syntax may be quicker, but it will not forgive easily if you make an error of syntax.  That's one of the reasons why using the interface might be safer.
127
128
h2. Editing a trigger
129
130
In the dialog box of triggers (menu bar, *Game* -> *Triggers*), you can edit a trigger if needed.  You will need to do so if you want to change the part that fires the trigger, or the actions associated with this trigger (for instance, the audio file to be played, in our example).
131
132
h2. Removing a trigger
133
134
Removing the trigger can also be done through the interface.  Just press the *Remove* button and confirm that you do want to remove this trigger.  Do not forget to click on *OK* to close the list of triggers.  If you don't, the trigger will not be removed.
135
136
h2. Using variables in triggers
137
138
It is time to look more closely at our previous trigger, in particular at the asterisk sign (@*@).  It is not a coincidence that you may recognize this syntax from the documentation on [[Alias|aliases]], for it is exactly the same principle: @*@ means anything.
139
140
So here is a list of possible syntax:
141
142
| Syntax | Meaning |
143
| @Welcome*@ | Any line beginning by @Welcome@ . |
144
| @*dude@ | Any line that ends with @dude@ . |
145
| @*spoil*@ | Any line containing @spoil@, at the beginning, the end or the middle.  It will also fire if the line contains @spoiler@ for instance. |
146
| @* spoil *@ | Any line that contains the word @spoil@ surrounded by spaces.  The word @spoiler@ would not fire the trigger in this context. |
147
| @You earned * credits in *.@ | Lines like @You earned 80 credits in combat.@ or @You earned 10 credits in management.@ will fire this trigger.  Also note that the line @You earned some unknown credits in something.@ will also fire. |
148
149
In short, an asterisk sign (@*@) means anything, including a number, a letter, a word, a space, or whatever else... including nothing.
150
151
A little word of caution: the syntax of your trigger is really important, and you should check when the trigger would be fired.
152
153
<pre>
154
*public*
155
</pre>
156
157
This trigger would fire when there is the word @public@ everywhere in the line.  It means this trigger would fire when you receive the following line:
158
159
<pre>
160
[ooc] Modo says: please talk on the public channel, not here, if you're stuck with a quest.
161
Yassen tells you: where should I write, if I want my message to be publicly readable?
162
To send your book to publication, press S.
163
</pre>
164
165
Remember that a trigger can be easily restricted... but can easily be fired.  That all depends on you.
166
167
Back to variables.  The asterisk does two things:
168
169
* It determines when the trigger should fire (specifying "anything").
170
* It writes in variables.
171
172
Let's use the same example of our trigger @[public]*@.  What happens when, say, you receive a line like:
173
174
<pre>
175
[public] Edgar says: I don't get it at all, could someone help me?
176
</pre>
177
178
First, the trigger @[public]*@ fires, then the part after @[public]@ is sent to a variable.  A variable can store information, and that's just what it does here.  Variables are numbered starting with @$1@, @$2@, @$3@ and so on.  So in our example, when we receive the above message, the variable @$1@ is created containing the text:
179
180
<pre>
181
 Edgar says: I don't get it at all, could someone help me?
182
</pre>
183
184
What can we do with it?  About anything.  Every parameter in our actions could use variables.  We will see a concrete example below.  For the time being you could display it:
185
186
<pre>
187
#say $1
188
</pre>
189
190
Which should display:
191
192
<pre>
193
 Edgar says: I don't get it at all, could someone help me?
194
</pre>
195
196
bq. Why does it begin with a space?
197
198
If you wonder about it, just put the trigger with the line side-by-side, that might help:
199
200
* Trigger: @[public]*@
201
* Line: @[public] Edgar says: I don't get it at all, could someone help me?@
202
203
Can you see it?  Our line puts "public" between brackets, then a space, then the name of the one speaking... while our trigger just says "public" between brackets and anything after that.  Which includes our space.
204
205
The solution?  To slightly change our trigger:
206
207
<pre>
208
[public] *
209
</pre>
210
211
This time, we put a space between the right bracket and the asterisk sign.  So now if we receive the line:
212
213
<pre>
214
[public] Edgar says: I don't get it at all, could someone help me?
215
</pre>
216
217
And we display @$1@, we'll see:
218
219
<pre>
220
Edgar says: I don't get it at all, could someone help me?
221
</pre>
222
223
Spaces may be the main source of confusion in your triggers.  The best advice is to look closely at the lines you receive from the server, and use only the @*@ sign when you don't know what will be put there.
224
225
h2. CocoMUD channels in triggers
226
227
CocoMUD has a more interesting feature of channels.  A channel is basically a list of events.  It will store these events and you can display this list whenever you want.  It might be useful, for instance, when exploring the game and not paying particular attention to some messages (on the public channel, or the ooc channel, for instance).  Afterward you might want to read them, so you display the list of messages.
228
229
We won't detail how to create channels here.  It's a subject of its own and will be documented elsewhere.  We'll just assume you have created the @public@ channel and we'll see how to put messages in this channel each time you receive a message in the game.
230
231
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:
232
233
<pre>
234
[public] You say: my message to all
235
</pre>
236
237
If it's someone else who sends to this channel, we would have:
238
239
<pre>
240
[public] Somebody says: my message to all
241
</pre>
242
243
What's common and different in our two lines?
244
245
* Well, both begin with "public" between brackets, followed by a space.
246
* Then there's the author.  "you" or "somebody".  So we don't know what it will be, we could use an asterisk.
247
* 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?
248
* After a colon and another space is our message.
249
250
To solve our issue between say/says, we have two options:
251
252
* Either we group both cases, writing "say*" (meaning say followed by nothing or anything).
253
* Or we could write two triggers.
254
255
Personally I would advise the latter, but I know some of you would prefer the former.  So let's work with both.
256
257
h3. One single trigger
258
259
What would our trigger look like in the end?  Ready?
260
261
<pre>
262
[public] * say*: *
263
</pre>
264
265
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.
266
267
So to create this trigger through the interface:
268
269
* Open the menu bar, *Game* -> *Triggers*.
270
* Click on *Add* to create a new trigger.
271
* Enter @[public] * say*: *@ before pressing Tab.
272
* Select "Feed a channel with a message".
273
* Click on the *Add action* button.
274
* In the name of the channel to be fed, enter @public@ (this is assuming the channel exists in CocoMUD).
275
* In the message to feed to the channel, enter:
276
<pre>
277
$1: $3
278
</pre>
279
* Click on *OK* several times to close the dialog and save the trigger.
280
281
bq. What was that @$1 $3@?
282
283
@$1@ contains the name of the one speaking.  @$3@ contains the message.  So when we receive the line:
284
285
<pre>
286
[public] Jamie says: well done!
287
</pre>
288
289
Our channel will be fed with the following line:
290
291
<pre>
292
Jamie: well done!
293
</pre>
294
295
You can enter @#channel public@ to display the list of messages in this channel (note that it can be connected to a macro, to display this list when pressing a shortcut key).
296
297
You could have done the same thing with a single line of SharpScript:
298
299
<pre>
300 3 Vincent Le Goff
#trigger {[public] * say*: *} {#feed public {$1: $3}}
301 2 Vincent Le Goff
</pre>
302
303
That's a bit harder to understand, but if you're familiar with SharpScript, that's definitely quicker.
304
305
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:
306
307
<pre>
308
#trigger {[public] * say*: *} {
309 3 Vincent Le Goff
    #feed public {$1: $3}
310 2 Vincent Le Goff
    #play sounds/public.wav
311
}
312
</pre>
313
314
h3. Two different triggers
315
316
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.
317
318
Our two triggers would be:
319
320
<pre>
321
[public] You say: *
322
[public] * says: *
323
</pre>
324
325
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:
326
327
<pre>
328 3 Vincent Le Goff
#trigger {[public] You say: *} {#feed public {You: $1}}
329 2 Vincent Le Goff
#trigger {[public] * says: *} {
330 3 Vincent Le Goff
    #feed public {$1: $2}
331 2 Vincent Le Goff
    #play sounds/public.wav
332
}
333
</pre>
334
335
What you'll choose is entirely up to you and the context, pick whatever feels more comfortable.
336
337
h2. Mute triggers
338
339
In some cases, when you receive a line, you don't want for it to appear.
340
341
bq. Does it really happen?
342
343
In some contexts.  For instance, some MUDs send regular ambiance messages to the client.  That can be great to set the ambiance, but that's usually not very user-friendly for people using screen readers.
344
345
<pre>
346
A cloud of sparks from your campfire soars toward the darkening sky.
347
</pre>
348
349
Nice and, well, yeah, when you're near a campfire, it cracks and smokes and sends sparks, but with a screen reader, that's not really useful.  So we could just remove this line.
350
351
To do so, create a trigger.  Through the interface:
352
353
* Go to the menu bar, *Game* -> *Trigger*.
354
* Add a trigger.
355
* Paste the line: @A cloud of sparks from your campfire soars toward the darkening sky.@
356
* No need to select an action, we won't do anything (except if you want to add a crackling sound when that happens).
357
* Tab until you find the "mute trigger" checkbox.  Check it.
358
* Press *OK* several times to validate and save.
359
360
If the client receives this line, it will just ignore it and not display it.
361
362
You could have done the same thing in SharpScript:
363
364
<pre>
365
#trigger {A cloud of sparks from your campfire soars toward the darkening sky.} {} +mute
366
</pre>
367
368
Notice that the second parameter is empty (just @{}@, meaning we don't perform any action).  The third parameter is a flag, beginning by @+@ or @-@ and followed by the name of the flag.  Here, @+mute@ means we activate the @mute@ flag to set our trigger as a mute trigger.
369
370
As pointed out, you can have a mute trigger that performs actions, like playing a sound, displaying something, sending a command, putting the line (or part of the line) in a channel, and so on.
371
372
h2. Mark triggers
373
374
Mark triggers can be useful for accessibility.  They will put the cursor directly on the line that fires the trigger.  It is useful in some contexts:  for instance, when you're exploring, you want the cursor to be put on the list of exits, rather than at the bottom of the window where you will have to press the up arrow key several times.
375
376
It's the same principle to create this trigger:
377
378
* Open the menu bar, *Game* -> *Triggers*.
379
* Click on *Add* to add a trigger.
380
* Put the part that should fire the trigger.  In our example, perhaps something like: @Obvious exits: *@ .
381
* Tab to check the "mark trigger" checkbox.
382
383
The next time you will receive the line beginning with "Obvious exits", the cursor will be moved directly on it.
384
385
The same thing in SharpScript would be:
386
387
<pre>
388
#trigger {Obvious exits: *} {} +mark
389
</pre>
390
391
h2. Triggers with substitution
392
393
In some cases, when you receive a trigger, you want to modify the line that fired the trigger.  One of the common case is to shorten the message.  Some MUDs have very long messages for some channels, like this:
394
395
<pre>
396
Somebody publicly speaks on the 'ooc' channel in a worried voice: is it safe?
397
</pre>
398
399
While this is great, it would be nice to shorten it and perhaps write it differently.  Like:
400
401
<pre>
402
[ooc] Somebody: is it safe? (with a worried voice)
403
</pre>
404
405
The way to do that is to create a trigger, and add a line of substitution.  The line of substitution will replace the line that fired the trigger in the client.
406
407
* Open the menu bar, *Game* -> *Triggers*.
408
* Click on *Add* to add a new trigger.
409
* Write the part to fire this line.  Here we might have something like:
410
<pre>
411
* publicly speaks on the '*' channel *: *
412
</pre>
413
* Notice that we have @$1@ containing the name of the speaker, @$2@ containing the name of the channel, 
414
@$3@ containing the tone of the voice and @$4@ containing the message.
415
* Tab until you find the empty text field "Message to substitute to the trigger line, if any".
416
* In it put:
417
<pre>
418
[$2] $1: $4 ($3)
419
</pre>
420
Does it look understandable?  Take the time to read the trigger, the line that should fire it and the substitution.
421
422
The same trigger in SharpScript would be:
423
424
<pre>
425
#trigger {* publicly speaks on the '*' channel *: *} {} {[$2] $1: $4 ($3)}
426
</pre>
427
428
Important note: we have three arguments to the @#trigger@ action here.  The first one is still the name of the trigger, the second one is still the action to be performed (empty in our case).  The third one is our substitution.  If the field is empty, there's no substitution.  That's just what happened for all of our previous tests.
429
430
h2. Triggers fired by a regular expression
431
432
This section is more advanced, beware.
433
434
The asterisk symbol is great, but it doesn't offer much flexibility.  Hopefully, we can connect a trigger with a "regular expression":https://regexone.com/ .  Regular expressions won't be described in this documentation, that's clearly off topic, but there are plenty of resources out there to learn it.
435
436
As far as CocoMUD is concerned, there's not much to know:  if the trigger begins with a @^@ symbol, it's a regular expression and CocoMUD will treat it as is.
437
438
<pre>
439
^You receive \d+ XP.$
440
</pre>
441
442
This will trigger when you receive the line "You receive ... XP.", with "..." being one ore more numbers.  This won't fire the trigger if you receive the following message: "You receive a lot of XP."
443
444
An important thing to note when using regular expressions in triggers, however, is that, if you want to capture parts of the line, you have to use groups:
445
446
<pre>
447
^You receive (\d+) XP.$
448
</pre>
449
450
Then the number of XP will be put in @$1@.  You can also use named groups and call them with @$myname@ afterward.
451
452
h2. Advanced triggers in Python
453
454
The SharpScript engine is really great... but it doesn't allow everything.  And its aim is to remain light and not allow everything.  It's not a programming language.  But Python is.  And CocoMUD is developed in Python.  The SharpScript engine is designed to send code to Python when the user asks it to do so.  That means you can have triggers that execute much more complex actions.  At the same time, the Python code can access all functions defined by the SharpScript engine, which keeps the code simple and potentially very powerful.
455
456
We'll take an example as usual, but keep in mind the possibilities are really endless.
457
458
The game sends a line when earning XP, but it also displays the total number of XP needed to level up.
459
460
For instance:
461
462
<pre>
463
You receive 37 XP and need 500 to level up.
464
</pre>
465
466
Let's say we want to extract these two numbers and display a percentage.  @xp / total * 100@.  That's not going to work with pure SharpScript.
467
468
For the time being, it's not possible to use the interface to manipulate Python code.  So we'll need to do it in the "config.set" file directly.
469
470
<pre>
471
#trigger {You receive * XP and need * to level up.} {+
472
    # $1 contains the number of XP
473
    # $2 contains the total number to level up
474
    xp = args["1"]
475
    total = args["2"]
476
477
    # We're going to try and convert these numbers
478
    try:
479
        xp = int(xp)
480
        total = int(total)
481
    except ValueError:
482
        # The numbers can't be converted, but do nothing
483
        pass
484
    else:
485
        percentage = xp * 100.0 / total
486
        say("You receive {}/{} XP ({}%).".format(xp, total, int(percentage)))
487
}
488
</pre>
489
490
Wow! That was some trigger! Let's quickly review it:
491
492
* The line that should fire the trigger shouldn't be much of a surprise by now.
493
* The second parameter begins by a @{+@ (a left brace followed by a plus sign).  This tells CocoMUD that what follows is Python code.
494
* Note that all the code is indented.  This is not just for readability this time, this is a Python requirement.  You can use a single space or a tabulation to indent, that's your choice, I usually use 4 spaces because it's easier to read, but that's only a convention.
495
* Some comments.  Don't underestimate their positive impact.
496
* We extract the two numbers (XP and total).  To access them, we use @args@ which is a dictionary containing all variables.  Remember that the first variable is @$1@, we need to access it through @args["1"]@.
497
* We need to convert these numbers.  Why?  There are still strings at that moment, it's as if they had been sent by the user.  And CocoMUD doesn't do anything about it, so you need to do it manually.  That's why we convert these numbers in a try/except/else statement.  Notice that if the conversion fails, we do nothing.
498
* Next we create the percentage.  It's Python 2, so we need to explicitly state that it should take into account floating points.
499
* And finally we use the @say()@ function.  That's just like using the @#say@ function in SharpScript, it's the same thing (not the same syntax because we're in Python).  All SharpScript functions can be accessed like that, so you could use @play()@ or @send()@ or @feed()@ and more.
500
501
I'm not really happy about my previous trigger... I'm not against some lines of code, especially since I find them much more readable than when you try to do everything in script, but... we could definitely work on something safer with the help of regular expressions.
502
503
<pre>
504
#trigger {^You receive (\d+) XP and need (\d+) to level up.$} {+
505
    # $1 contains the number of XP
506
    # $2 contains the total number to level up
507
    xp = int(args["1"])
508
    total = int(args["2"])
509
    percentage = xp * 100.0 / total
510
    say("You receive {}/{} XP ({}%).".format(xp, total, int(percentage)))
511
}
512
</pre>
513
514
Okay, using regular expressions in your trigger is a  bit more technical, but the gain for our code isn't to be dismissed.
515
516
If you want more help about using Python code in SharpScript, just refer to [[SharpScript|the section describing SharpScript]].