Rev77.net Plugin Manager

[Vector]

[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]

Code: [Select]

'*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.zip

Internet 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

[ArticWolve]

I believe this should be made into a tutorial (Just in case we ever get a non-spam boom of members lol).

Edit: Right Click, Save Target As Rev77PS.plug in your Stealthbot plugins folder.

[DarkMage2303]

(Just in case we ever get a non-spam boom of members lol).

Yeah, that is likely

[Wolf-TBR]

how do u get the list of plugin's with the r77 plug??

[size=][3:22:27 PM] [/size][size=]PressedEnter Call Error On File> C:\Program Files\StealthBot\plugins\scripts.plug

[/size][size=][3:22:27 PM] [/size][size=]Error Number: 9 Description: Subscript out of range

this error comes up when u use te /r77 edit or open cmd vector

[/size]

before u tell me to type /r77 updates for the list of plugins

i already have and it does not list the plugins for me

[ArticWolve]

It has something to with the above stated error. Let me look at mine and see if it errors. I won't promise that I can fix it.
@Vector: Did you try this in SB 2.6 R3 or SB Beta??

[Vector]

SB 2.6r3. It should work fine with the beta too.

Re-download. I fixed a type casting error, so the plugin should show you newer updates to plugins you've already downloaded and such.

[Vector]

Implemented an update manager.

[ArticWolve]

Sweet! I'll update sooner or later.

[Vector]

I am going to implement a feature that will allow scripters to include functions from the "Useful Functions" topic into their plugins. The following updates must be done to allow this:

• Update the Plugin Manager to include the command
• a Functions.txt file with tags to emcompass the new functions
• An HTML page to upload the new function to (won't add if there are any syntax errors, and if password is wrong)

I have not started this, but I still need to know how to use forms properly in HTML. I'll work on this as soon as I can.

[Vector]

• Update the Plugin Manager to include the command
• a Functions.txt file with tags to emcompass the new functions
  

I will just use a functions.txt file, remove the functions.plug plugin, and just have that file updated as new functions are added to the Useful Functions topic.

Example file outline:

Code: [Select]

<IsChar>
  <name>IsChar</name>
  <author>Vector</author>
  <description>Returns True if the character is an alphanumeric character, otherwise returns False</description>

  <code>
    Function IsChar(charact)
      charact = lcase(charact)
      if Asc(charact) >= 97 and Asc(charact) <= 122 then
        IsChar = true
      else
        IsChar = false
      end if
    End Function
  </code>
</IsChar>This is to make it very easy to pull functions out of this file. The tags will help a LOT. I will not use XML though. Just Split() parsing.

Indent the final code with Chr(255). The reason being is that it will look nice in Functions.txt, but I will be able to make it look decent in plugins because I can just replace Chr(255) with a null string.

[size=]NOTE: All sub/function names are NOT in camel toe naming conventions (InArray instead of inArray)[/size]

@Hero: If you add a function, remember to update the file too.

It will be in scripts\deps\functions.txt

[Hero]

I would recommend XML > TXT if you are going to format it like that.

[ArticWolve]

This plugin screws up Stealth Bot Beta DR 13, just so you know vector.

[Vector]

I'd like to know exactly how it screws it up so I can add beta compatibility without screwing up 2.6r3 compatibility.

I would recommend XML > TXT if you are going to format it like that.

Alright. I'll learn XML then, and how to parse with it.

[ArticWolve]

PMed you the screw up. Its a very long quote.

[Vector]

It is my pride and joy to introduce version 0.29 of the plugin manager.

This introduces new features for plugin scripters never before seen in the plugin manager.

Fool around with the new commands:

Code: [Select]

/r77 insert list
/r77 insert preview <function>
/r77 insert <function> into <prefix>