Staredit Network

Custom Commands

How to use the Custom Commands system! I know I'm gonna get quite a few emails on this one..

FORMAT FOR CUSTOM COMMANDS
¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯
.cmdadd <r> <w> <a>

<r> = Required access to use the command, between 0 and 999. (For public commands like !help, use 0.)
<w> = Command keyword
<a> = Actions to take if a user uses the command

The custom commands are used like other bot commands, ".commandword arguments".
This system is very similar to zDSBot's system.
You can use unlimited arguments in your custom commands; number them accordingly. Argument 1 would be %1, Argument 2 is %2 and so on.

You can define another line by using "&_" (without quotes, _ is a space) in your command. Please note THERE MUST BE A SPACE after the &.

COMMAND EXAMPLES
¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯
COMMAND:
.cmdadd 50 argtest Argument 1: %1& Argument 2: %2& Argument 3: %3

USAGE:
<Stealth> .argtest First Second Third

BOT'S RESPONSE:
<StealthBot> Argument 1: First
<StealthBot> Argument 2: Second
<StealthBot> Argument 3: Third

Notice how the "& " breaks up lines. You can theoretically achieve something like 32,000 arguments (%32767).

Now the classic UltimateBot command:

¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯
COMMAND:
.cmdadd 50 serve *RexyRex pours a refreshing glass of %rest& *RexyRex hands the glass to %1, compliments of %0

USAGE:
<Stealth> .serve Mad Pepsi One

BOT'S RESPONSE:
<StealthBot pours a refreshing glass of pepsi>
<StealthBot serves the pepsi to Mad, compliments of Stealth >

%0 stands for the user who executed the command.
%1 is the first argument, or the person being served.
%rest is the rest of the message, after the highest-numbered argument you used in making the Custom Command.
In this case, what you want to serve to them.