Original command module by Pinkie Pie (https://discord.gg/RR9zf85), modified and added auto-updating functionality.
Type /toolbox
or /8
into chat to switch to the command line, then enter the specified command. To pass strings containing spaces as arguments, enclose them in quotes (""
or ''
). To enclude quotes or backslashes in arguments, precede them with a backslash \
.
/toolbox mymod
/toolbox mymod dostuff
/toolbox mymod 123 456 'Hello!'
/toolbox mymod "This is a string containing 'quotes', \"similar quotes\", and \\backslashes."
To use Command in your module, you can just use mod.command
. It is guaranteed to be installed, even if the user attempts to delete it.
module.exports = function MyMod(mod) {
mod.command.add('mymod', (x, y, z) => {
mod.command.message('Parameters: ' + [x, y, z].join(', '))
})
}
module.exports = function SubCommandTest(mod) {
mod.command.add('test', {
$default() { mod.command.message('Usage: test [echo|hello]') },
echo(...args) {
if(args[0] === undefined) mod.command.message('Usage: test echo [msg]')
else mod.command.message(args.join(' '))
},
hello: {
$default() { mod.command.message('Usage: test hello [blue|red]') },
blue() { mod.command.message('<font color="#5555ff">Hello!</font>') },
red() { mod.command.message('<font color="#ff5555">Hello!</font>') }
}
})
}
Adds one or more command hooks. All commands must be unique and are case insensitive.
command
may be a string or an array of strings.
callback
may be a function or an object. Callback receives a variable number of input string arguments. If an object is provided, the object's keys are registered as sub-commands which may in turn be either a callback or another object. Two special keys are usable for sub-commands:
$none
called if there were no arguments.$default
called if no other hook was matched.
context
optional this
to pass to callbacks. Default is unspecified.
Removes one or more command hooks.
command
may be a string or an array of strings.
Sends a message in the [Toolbox]
channel. May contain HTML.
Executes a raw command string. If str
is an array then it will be interpreted as arguments instead.
Returns true
on command found, false
otherwise. May throw an exception if the callback contains an error.