Need help? Ask on the forum, ask a fellow user or developer (join us on IRC), or contact sk89q.
Contribute to the wiki, edit this page! Register an account, or login with Facebook first.
HEY! Do you integrate (or want to) a plugin into yours? Do you help work on WE/WG/etc.? Please subscribe to our mailing list!
In CommandHelper, there are two types of variables, variables (start with $) and ivariables (start with @).
Variables are set in a command, like so:
/cmd $var1 $var2 $ = msg($var1 $var2 $)
These variables are used when it comes to matching a command, however, when the script is running, they are thought of as constants. This is because you, as the programmer, can't change them. They may change from run to run of the command, so they are still technically variables. The variable $ is a special variable, and matches any parameter after, which also means that it must be the final thing in a command definition. This is why it is referred to as the final var. It is treated as a string. However, if you wish to treat it as an array (for example, to parse the arguments individually), use parse_args($) to return an array of individual items. Here is a more complex, but valid scenario:
/cmd one $var1 const $var2 const $var3 $ = ...
In this case, if the user types "/cmd one hi const bye const what is this, I don't even", it would match, and the defined variables would be as follows:
|$:||is this, I don't even|
As you can see, constants are only used to determine if a command matches, but otherwise not used.
IVariables are defined by the programmer, and are a pure mscript feature. To create a variable, you simply use it, the default value in the variable is an empty string. Usually however, you want to define it with a value before you use it. This can be done with the
assign takes an ivariable, and any other parameter. Unlike most functions, it does require an actual variable, which most functions will never return. (
assign does, however, so it is possible to chain an assignment with another function)
assign(@var, 2) msg(@var)
This code will send the player "2".
Here is an example of a chained assignment:
for(assign(@i, 0), lt(@i, 10), inc(@i), msg(@i) )
Because assign returns the actual ivariable that was set, and
for() requires an ivar as the first argument, this works ok. In addition, this is possible:
assign(@var1, assign(@var2, 6))
In this case, both @var1 and @var2 get assigned to 6. This is because the ivar is returned, and then resolved to the value 6, which is then stored in @var1. This resolution behavior is typical, but a few functions have special functionality to handle this, such as assign, and if, and loops, so the variable isn't resolved immediately.