====== !cmd ======

[[start|← Go back]]

^ Delay | 1 second |
^ Subcommands | ''create'', ''new'', ''add'', ''delete'', ''remove'', ''rename'', ''edit'', ''alias'', ''delalias'', ''view'', ''list'', ''global'' |
^ Aliases | ''scmd'' |
^ Minimal rights | {{:bot:commands:moderator.png?nolink&16|}} Moderator |

The ''!cmd'' command gives the ability to create their own chat commands.

===== Embedded commands =====

Custom commands can run internal commands using ''{...}''.
''{X}'' where ''X'' is the command, e.g., ''{ping}'' or ''{luaimport https://pastebin.com/...}''.
Also, you can pass a message to the command using ''$1'', e.g. ''{spam 5 $1}'', ''{luaimport https://pastebin.com/... $1}''.

==== Examples ====

  * Creation: ''!cmd new !cvpaste {spam 3 $1}''
    * Usage: ''!cvpaste this is a custom command'' - executes as ''!spam 3 this is a custom command''.

===== Syntax =====

==== Create a new custom command ====

''!cmd new [name] [message...]''

  * ''[name]'' - The name for new custom command. It should be unique for your chat. **A prefix must be specified if you want a prefixed command, e.g. ''!sub'', ''!server''.** You can use ''{prefix}'' //(dynamic prefix)//, for example ''{prefix}sub'', ''{prefix}server''. It will be replaced with the current prefix in the chat.
  * ''[message]'' - Text that will be sent when the custom command is invoked.

==== Delete the custom command ====

''!cmd delete [name]''

  * ''[name]'' - Name of custom command.

==== Edit the message for custom command ====

''!cmd edit [name] [message...]''

  * ''[name]'' - Name of custom command.
  * ''[message]'' - Text with which to replace

==== Edit the custom command name ====

''!cmd rename [name] [new_name]''

  * ''[name]'' - Name of custom command.
  * ''[new_name]'' - New name for custom command.

==== Create a new alias for custom command ====

''!cmd alias [name] [alias]''

  * ''[name]'' - Name of custom command.
  * ''[alias]'' - New alias for custom command.

==== Delete alias from custom command ====

''!cmd delalias [name] [alias]''

  * ''[name]'' - Name of custom command.
  * ''[alias]'' - Alias of custom command.

==== Check the information about custom command ====

''!cmd view [name]''

  * ''[name]'' - Name of custom command

==== Get the list of created custom commands ====

''!cmd list''

===== Usage =====

==== Creating a new custom command ====

  * ''!cmd new !sub Buy a Twitch sub at this link and become like the rest of us 😎''

==== Deleting the custom command ====

  * ''!cmd delete !sub''

==== Editing the message for custom command ====

  * ''!cmd edit !sub Buy a Prime sub at this link and become like the rest of us 😎''

==== Renaming the custom command ====

  * ''!cmd rename !sub buysub''

==== Creating a new alias for custom command ====

  * ''!cmd alias !sub buy_subscription''

==== Deleting the alias for custom command ====

  * ''!cmd delalias !sub subscription''

==== Checking the information about the custom command ====

  * ''!cmd view !sub''

[[https://bot.alright.party/~/cmd|Check the source code]]