[font size="5"][font color="#0000FF"]The Rev77.net Plugin Manager[/font][/font]
[font color="#4169E1"][font size="4"]Table of Contents[/font][/font]
[font color="#0000FF"]
[font size="3"]
1.
What is it?2.
What are the commands?3.
Features of this Plugin Manager.4.
Information regarding use (if you would like to add a plugin to the server)
[/font][/font]
[font size="3"][font color="#FF0000"]NOTE: Color in red pertains to future versions of the plugin manager not already in the current manager.[/font][/font]
[font size="3"]FIRST TIME STEALTHBOT USERS: Here is a tutorial on how to add it to your plugin system:[/font]
[object width="425" height="344"][param name="movie" value="http://www.youtube.com/v/C1cG_78FgUE&hl=en&fs=1"][/param][param name="allowFullScreen" value="true"][/param][param name="allowscriptaccess" value="always"][/param][embed src="http://www.youtube.com/v/C1cG_78FgUE&hl=en&fs=1" type="application/x-shockwave-flash" allowscriptaccess="always" allowfullscreen="true" width="425" height="344"][/embed][/object]
[font size="4"]This plugin requires the
StealthBot Plugin System[/font][a name="WHATISIT"][font color="#A0522D"][font size="4"]1. What is it?[/font][/font][/a]
The Rev77.net Plugin Manager is a plugin that is designed to provide easy access to our plugins hosted here at Rev77.net. It is complimentary to the Plugin System developed by
Swent in some ways. It has some features that are not present in the Plugin System. I wanted to be able to get easy access to my plugins, and so I have come up with this Plugin Manager to make it a lot easier.
This Plugin Manager does not have the ability to download plugins from the StealthBot Plugins Server. It is only designed to download plugins off the Rev77.net Plugins Server.
[a name="COMMANDS"][font color="#A0522D"][font size="4"]2. What are the commands?[/font][/font][/a]
Rev77.net Plugin Manager Documentation: (All commands are prefixed by "r77", and are in-bot only, except for the following commands: get, download [prefix], rem, del [prefix])
- [font color="#0000FF"]/r77 updates[/font]
- Same as the /r77 cats, categories command (as of v0.4). The plugin legend uses four different colors, depending on the situation. These are:
- Plugins that you have, but are updates to yours
- Plugins with the same versions as yours
- Plugins you have not downloaded yet
- Plugins with Important Notes attached to them
- [font color="#0000FF"]/r77 get, download <prefix>[/font]
- Downloads a plugin specified by <prefix>. If %all% is used as the prefix, it will download all updated plugins. - [font color="#0000FF"]/r77 cats, categories [category][/font]
- Displays all plugins by category. If [category] is used, the manager will show all plugins in that category. - [font color="#0000FF"]/r77 open, edit <prefix>[/font]
- Much like the Beta Plugin System's /pedit command. Opens up the plugin so you can work with it easily. - [font color="#0000FF"]/r77 list, plugins[/font]
- Retrives a list of all plugins in your bot that were downloaded from the Rev77.net Plugin Server. To view all your plugins, type /plugins - [font color="#0000FF"]/r77 insert <function> into <prefix> [--new <plugin filename>][/font]
- Inserts a function from the Useful Functions and Subs topic into the plugin specified by <prefix> If the --new switch is used, the plugin manager will create a new plugin with the specified function inserted - [font color="#0000FF"]/r77 insert list[/font]
- Retrives a list of all functions/subs in the Useful Functions and Subs topic - [font color="#0000FF"]/r77 insert preview <function>[/font]
- Returns the code for the specified function
[a name="FEATURES"][font size="4"][font color="#A0522D"]3. Features of this Plugin Manager[/font][/font][/a]
As was mentioned already, this Plugin Manager contains features not found in the Plugin System. When you download a plugin with Important Information attached to it, it will immediately be displayed in your bot, for convenience sake. If it gives you a firm warning that a plugin isn't compatible with your StealthBot, then just simply delete it.
This Plugin Manager is very easy to use, and I'm really glad that it turned out the way it did.
[a name="USE"][font size="4"][font color="#A0522D"]4. Information regarding use (if you would like to add a plugin to the server)[/font][/font][/a]
If you would like to contribute to the plugin server, there are a few things you should know about. There is absolutely nothing wrong with just uploading it like it is (you have to notify either me or Hero to get your plugin up on the server), but if you want to leave a quick link to the topic of the plugin (if it exists), include Important Information, or have the manager download multiple files, then you have to do the following:
[font color="#A0522D"]
[font size="4"]Important Information (if you would like to contribute to the plugin server)[/font][/font]
The following information regarding the Important Information / Topic ID / multi-file downloading do not apply if the "'*" identifier is not on lines 5, 6, 7 or 8.
If, for example, you require multiple lines, separate each file name with a ":". (Ex. file1.txt:file2.txt)
At the top of your plugin, you'll have information such as the prefix, and version, but you must also place these at a specific line in your plugin. Line 5 is used for special information (if it is preceded by the two characters '*), line 6 is used for the topic number, and line 7 is used to indicate any additional files that the plugin system needs to download, placed into the plugin server's main folder. Line 8 determines the specific category of the plugin. If no category is used, the plugin's category will be Unknown. So, for example, you want to link to the topic ID 32, and you also want to add Important Information regarding the fact that you might receive an error if you download it incorrectly, then if the error wasn't a problem, you would need to download BNETIconCodes.txt for whatever reason. You would do the following:
'test
'0.1
'&Test plugin. This is optiona:Vector
'&Commands, woohoo!
'*StealthBot may receive an error if you don't download this plugin properly
'*32
'*BNETIconCodes.txt
'*Testing Plugins
NOTE: even if you don't have a fourth line indicating commands, you STILL have to place the Important Information line on the fifth line, the ID on the sixth line, and the file list on the seventh line.
Say you want to leave a link to the topic ID in the Important Information section. Use the following variable: %topic=32 (if you want to leave a link to topic ID 32). The eigth line would put the plugin in a specific category as well.
[font size="4"]Categories:[/font]
[font size="3"]StealthBot Enhancement (plugins that add a new feature to StealthBot (I.E. Moderation related))
Fun (Game-Related)
VBScript Related (Plugins that add functionality to the StealthBot Scripting System)
Battle.Net Parsers (Plugins that will parse Battle.Net for particular information)
Clan Related (Plugins that are used for clan-related functions)
File Related (Plugins that will parse a file)
Testing Plugins (Plugins that are used to test things)[/font]
You should place your plugin in one of these categories using the format provided above (CASE-SENSITIVE).
[font size="3"]NOTE TO SCRIPTING DEVELOPERS: I will NOT upload your plugin if it is meant to work with StealthBot 2.6r3 but doesn't. Make sure to test it on 2.6r3 before finalizing it. If you are releasing a plugin that has beta features, please make a note of it on line 5:[/font]
'*This plugin is not compatible with StealthBot 2.6r3
[font size="4"]Quick Note:[/font]If you get an error such as the following:
[12:09:44 PM] [R77] There is a duplicate prefix: pn
[12:09:44 PM] [R77] Original plugin: pn.plug
[12:09:44 PM] [R77] Plugin in conflict: tesst_pn.plug
[12:09:44 PM] [R77] Plugin will not be queried
[12:09:44 PM] [R77] You should change the prefix in either of these plugins
This has nothing to do with your scripts. This is simply that a plugin on the server has a prefix that's the same as another plugin. An admin who has access to the plugin server will correct the issue as soon as possible, once notified.
Have fun with this plugin.
Save
this file to your StealthBot's plugin folder.
NOTE: If the above link does not work, you can use this alternate link:
http://rev77.net/Rev77PS.zipInternet Explorer users: right-click the link, hit "save target as ...", and locate your stealthbot's plugin folder.
Firefox users: right-click the link, hit "save link as ...", and then proceed to your StealthBot's plugin folder.
Whichever browser you use, save it with the Save As Type as "all files." If the extension is ".htm", change it to ".plug"
Added link ~ Hero
Fixed an annoying Typo ~Shadow
Fixed some things. Redirected link to my web server again. ~Vector