====== Command ======

A command in [[start|Wurst]] is a type of [[feature]] that can be triggered by sending a special [[mc>chat]] message that starts with a the ''.'' character. This message will not be sent to the server, but is instead processed by Wurst. Wurst commands can also be run by using a previously created [[keybind]].

If the [[#syntax|syntax]] is correct and no error occurs, the command will do something. Otherwise the command will return an error message that is only visible to the user who typed the command.

Wurst commands can be bypassed by using the [[cmd:say|.say command]]. For example, typing ''.say .help'' would send ''.help'' as a chat message instead of running the [[cmd:help|.help command]].

For long commands, the [[InfiniChat]] hack can be used to remove Minecraft's 256 character chat limit.

===== Syntax =====

All Wurst commands must start with the ''.'' character. Other than that, Wurst's command syntax follows the conventions of Microsoft's command-line syntax ((https://docs.microsoft.com/en-us/windows-server/administration/windows-commands/command-line-syntax-key)).

  * ''text without any brackets'' must be typed exactly as shown.
  * ''<text in angle brackets>'' is a placeholder that must be replaced with a value.
  * ''[text in square brackets]'' is optional. It can either be omitted or typed without the square brackets.
  * ''(text|separated|by|pipes)'' is mutually exclusive. You must choose one item.

**Example:** The [[cmd:nuker|.nuker command]] <sup>[ //[[Wurst 6]] only// ]</sup> has the following syntax:

<code>
.nuker mode (normal|id|flat|smash)
.nuker id <block_id>
.nuker name <block_name>
</code>

For ''.nuker mode (normal|id|flat|smash)'', ''.nuker'' must be typed exactly as shown, ''mode'' must be typed exactly as shown, and ''(normal|id|flat|smash)'' must be replaced with one of the items shown.

  * ✔ ''.nuker mode id'' is valid input.
  * ✔ ''.nuker mode flat'' is also valid input.
  * ✘ ''.nuker flat'' is invalid.
  * ✘ ''.nuker flat flat'' is invalid.
  * ✘ ''.nuker mode (flat)'' is invalid.
  * ✘ ''.nuker mode (flat|flat|flat|flat)'' is invalid.

For ''.nuker id <block_id>'', ''.nuker'' must be typed exactly as shown, ''id'' must be typed exactly as shown, and ''<id>'' must be replaced with a value (in this case: a [[mc>Java_Edition_data_value/Pre-flattening#Block_IDs|block ID]]).
  * ✔ ''.nuker id 1'' is valid input.
  * ✘ ''.nuker 1 1'' is invalid.
  * ✘ ''.nuker id <1>'' is invalid.

===== List of Commands =====

  * [[cmd:.addalt]]
  * [[cmd:.annoy]]
  * [[cmd:.author]]
  * [[cmd:.bind]]
  * [[cmd:.binds]]
  * [[cmd:.blink]]
  * [[cmd:.blocklist]] <sup>[//[[:Wurst 7]] only//]</sup>
  * [[cmd:.clear]]
  * [[cmd:.copyitem]]
  * [[cmd:.damage]]
  * [[cmd:.dig]]
  * [[cmd:.drop]]
  * [[cmd:.dupe]] <sup>[ //[[Wurst 7]] only// ]</sup>
  * [[cmd:.enabledhax]] <sup>[ //[[Wurst 7]] only// ]</sup>
  * [[cmd:.enchant]]
  * [[cmd:.excavate]]
  * [[cmd:.features]]
  * [[cmd:.follow]]
  * [[cmd:.friends]]
  * [[cmd:.getpos]]
  * [[cmd:.ghosthand]]
  * [[cmd:.give]]
  * [[cmd:.gm]]
  * [[cmd:.goto]]
  * [[cmd:.help]]
  * [[cmd:.invsee]]
  * [[cmd:.ip]]
  * [[cmd:.itemlist]] <sup>[//[[:Wurst 7]] only//]</sup>
  * [[cmd:.jump]]
  * [[cmd:.leave]]
  * [[cmd:.modify]]
  * [[cmd:.nothing]] <sup>[ //[[Wurst 6]] only// ]</sup>
  * [[cmd:.nuker]] <sup>[ //[[Wurst 6]] only// ]</sup>
  * [[cmd:.path]]
  * [[cmd:.potion]]
  * [[cmd:.protect]]
  * [[cmd:.rename]]
  * [[cmd:.repair]]
  * [[cmd:.rv]]
  * [[cmd:.say]]
  * [[cmd:.search]]
  * [[cmd:.setblock]] <sup>[//[[:Wurst 7]] only//]</sup>
  * [[cmd:.setcheckbox]]
  * [[cmd:.setcolor]] <sup>[ //[[Wurst 7]] only// ]</sup>
  * [[cmd:.setmode]]
  * [[cmd:.setslider]]
  * [[cmd:.settings]]
  * [[cmd:.spammer]]
  * [[cmd:.sv]]
  * [[cmd:.t]]
  * [[cmd:.taco]]
  * [[cmd:.throw]]
  * [[cmd:.toomanyhax]] <sup>[ //[[Wurst 7]] only// ]</sup>
  * [[cmd:.tp]]
  * [[cmd:.unbind]]
  * [[cmd:.vclip]]
  * [[cmd:.viewnbt]]
  * [[cmd:.wms]] <sup>[ //[[Wurst 6]] only// ]</sup>
  * [[cmd:.xray]]

==== Removed Commands ====

Removed commands no longer exist in current versions of Wurst.

  * [[cmd:RenameForceOPEvenThoughTheNameIsTechnicallyCorrect|.RenameForceOPEvenThoughTheNameIsTechnicallyCorrect]]