Create first plugin

Introduction
Over the past months I have been plagued with the idea of running multiple A.R.S responses with one trigger. This is where the Plugins come into play. You can install, uninstall and run your plugins from an A.R.S rule easily using the {plugin:plugin-name} key. However the plugin will need to be installed on your server first.

Required Syntax
To start a plugin you need to add a few things. We will define the plugin name, the author, version and a kill code to stop a plugin.

On line 1 you need to defile the name. [name=Simple Plugin] Now for line 2 we define the author. [author=Your name] Alright now for line 3 we define the version. [version=1.0.0] And finally the kill code to stop the plugin. [killcode=poptarts]

Commenting in Plugins
You can have blank lines and comments to help explain what you are trying to do. Or even leave yourself a note for a later time. Comments will only work in their own line. for example // this is a comment line

Available A.R.S Keys for Plugins
We are still working on finding the keys that are not compatible with the plugin system. However the list will be very small. about 98% of the keys you can use for A.R.S Are also available for the plugins.

Eample Plugin
Let's make a plugin that will ask the user if they are in a voice channel. If they type yes he will join the voice channel and play the 911 sound command. [name=poptart]

[author=Proxy]

[version=1.0.0]

[killcode=no-more]

{sleep:1s}Hello {/user} Are you in a voice channel?

{sleep:7s}{scanfor:yes}{true:{play:911}Playing sound file `911`}{false:You either said no...or did not answer at all...}

{sleep:7s}Closing plugin. You can in return save the above code to an install.plugin.ars file and than drag it to a channel Echo can see. He will install the poptart plugin and allow you to link this plugin to an A.R.S rule like below --auto --runplugin={plugin:poptart}Running plugin!

Installing Plugins
One of the neat features with Echo is the ability to drag a plugin into the chat and he will run the plugin! However If you want to keep your plugins or use them in your A.R.S Rules you will need to install. You will need to name the file install.plugin.ars make sure your plugin has the [name=]