To assign a command to an item, you have to assign it an ID as well. This is necessary to be able to track-down, edit, or even disable all the existing copies of the item once you've distributed it to the players.

You just need to provide a new ID to the set sub-command, optionally followed by the command to assign to it:

/cmditem set a_fancy_id /command argument

Warning

If you try to specify an ID already in use by another item, the item will be cloned, but the command you've supplied will be discarded.

Simply re-issue the command again to override the existing command with a new one. The new command will be assigned to all the items having the same ID.

Command¶

You can change the command (or specify it later) with:

/cmditem set /command ${p} param2 ...

Note

You're not required to supply the ID again, if it's already bound.

Note

${p} is a variable that gets replaced with the name of the user/player.

It's possible to assign multiple commands, to be run in chain:

/cmditem set /command ${p} param2 /command2 ${p} param4

Tip

If you need to pass an argument starting with a slash (/), make sure to escape it with a back-slash or it'll be assumed to be a command. For example:

/cmditem set /command ${p} param2 \/param3

Options¶

Depletion¶

You can change how many times the item can be used before it depletes (default is 1), with:

/cmditem depletion 5

Tip

If you set 0 here the item can be used infinite times.

Cool-down¶

You can also specify a different duration for the cool-down period after each use, in seconds (default value is 30), like this:

/cmditem cooldown 15

Tip

If you set 0 here the item won't have a cool-down period.

Note

This option is meaningless if the item is configured to deplete after its first and only execution (see above).

All-in-one alternative¶

The set sub-command seen above also lets you specify all these options at once. For example, to set depletion to 3, you will issue:

/cmditem set 3 /command arg1 arg2 ...

To also specify the cool-down duration (e.g. lasting 10 seconds), you'll have to supply it after the depletion value:

/cmditem set 3 10 /command arg1 arg2 ...

Unbinding¶

You can revert an item to its original state (i.e. detach the command(s) associated), by issuing:

/cmditem unset