CommandDocs object

From StealthBot Wiki Backup
Revision as of 19:43, 25 September 2010 by Ribose (talk) (Parameters property)
(diff) ← Older revision | Latest revision (diff) | Newer revision → (diff)
Jump to: navigation, search

The CommandDocs object allows you to access a command's documentation. This is not generally needed as most access checks are handled before calling Event_command() with a Command object. This object is returned by the CreateCommand function and OpenCommand function allowing scripts to provide the documentation for script commands during load. You must call .Save() after completing changes so that they get saved to the Commands.xml file.

History

This object was added in StealthBot version 2.7 by Eric to create an object-oriented experience in scripting.

How to use

Example: Get the current numeric rank required by the command.

Value = CommandDocsObj.Rank

Example: Store a response to the command.

CommandDocObj.Description = "Description for example command."
' more documentation / syntax changes
CommandDocObj.Save

Properties

List of properties

Name property

Returns or sets the name of the command, as a string. This is the name of the command as defined by the XML, not the alias.

Owner property

Returns or sets the name of the script which created the command with CreateCommand(). If this is an internal script, vbNullString will be returned.

Aliases property

Returns a collection of strings representing the aliases that can be used to execute the command. Changes to this collection can be saved. Do not include the command's name as one of its aliases.

IsEnabled property

Returns or sets whether a command is currently enabled. Disabled commands will not fire any Event_Command() subroutine.

RequiredRank property

Returns or sets the numeric rank a user requires in order to use a command. Commands attempted by a user without access will not fire any Event_Command() subroutine.

Description property

Returns or sets the description of a command, viewable with the help command or from the command manager.

AliasString property

Returns a string containing the aliases formatted as a comma-delimited list for display. Does not include the command name.

RequirementsString property

Returns a string containing the required rank and flags formatted like "Requires rank #[ or one of the following flags: ...]." for display.

RequirementsString property

Returns a string containing the required rank and flags formatted like "Requires rank #[ or one of the following flags: ...]." for display.

SpecialNotes property

Returns or sets a description string only visible in the command manager.

Parameters property

Returns a collection of CommandParams objects specifying the syntax the command can require for use with the CommandObj.Argument property. If the command's syntax is not valid, Event_Command will still fire. You will have to use CommandObj.IsValid to determine whether the command follows this documentation object.

Functions

List of functions

NewParameter function

Returns a CommandParams object containing the information you provide. You must add this parameter to the collection from the Parameters property before saving this CommandDocs object.

NewRestriction function

Returns a CommandRestriction object containing the information you provide. You must add this restriction to the collection from a CommandParamsObj.Restrictions property before saving this CommandDocs object.

Save function

Saves the current command to the commands.xml file. Returns True on success and False on failure.

Deletes function

Deletes the current command from the commands.xml file.

SyntaxString function

Returns a string showing how to use the current command for display, such as ".add <username> [rank] [attributes]". If you pass True to its only parameter, you will receive the same string but with your currently set bot trigger replaced by a "/", to indicate how to use this command from inside the bot.

GetParameterByName function

Returns a CommandParams object for the specified parameter name.

See also