Ver el código de «Plantilla:Command/doc»

{{doc/start}}
{{lua}}
{{shortcut|cmd}}
This template is used to generate auto-formatted commands. Commands can either be pasted directly into the template (with or without a slash), or each parameter specified as a separate argument.

Any parameter that isn't specified or is set to an empty value or <code>?</code> will be replaced with the default parameter for the command, if it is a [[Module:Command/Syntax|known command]] and a valid parameter. Specified optional parameters will be displayed as if required, along with any other parameters in the optional group. Unspecified optional parameters won't be displayed.

These parameters are formatted as follows:
* Parameters that do not have to be entered to use a command are given in parentheses.
* If a given parameter can accept one of several different values, the values are listed in square brackets ([]) and separated by pipes, e.g. <code>[val1|val2]</code>.
* Parameter names are enclosed in angled brackets and italicized, e.g. <code><''player''></code>.
* Parameter values are given as plaintext and enclosed with square brackets, e.g. <code>[true]</code>.
* These are combined as necessary, e.g. <code><''operation'':[start|stop]></code> or <code><''operation'':[add <''player''>|remove <''player''>|list|on|off|reload]></code>

== Arguments ==
* To output the rest of the command including optional parameters, add <code>...</code> to the template.
* To remove the forward slash, add <code>|/=0</code> or <code>|slash=0</code> to the template.
* To change the command name's link, add <code>|link=<link></code> to the template.
* To remove the command name's link, add <code>|link=none</code> to the template.
* To add HTML in the command, add <code>|escape=0</code> to the template. It's then your responsibility to <code><nowiki><nowiki></nowiki></code> anything that looks like HTML but isn't.
* If a command is long and may go off the edge of the screen, add <code>|long=1</code> to the template. This allows the code to wrap as well as displaying it on its own line.

== Examples ==
;<nowiki>{{cmd|kill}}</nowiki> : {{cmd|kill}}
;<nowiki>{{cmd|clear|?|diamond}}</nowiki> : {{cmd|clear|?|diamond}}
;<nowiki>{{cmd|give ? diamond 64}}</nowiki> : {{cmd|give ? diamond 64}}
;<nowiki>{{cmd|give ? diamond 64|...}}</nowiki> : {{cmd|give ? diamond 64|...}}
;<nowiki>{{cmd|say I'm saying stuff!}}</nowiki> : {{cmd|say I'm saying stuff!}}
;<nowiki>{{cmd|op|...}}</nowiki> : {{cmd|op|...}}
;<nowiki>{{cmd|give|...}}</nowiki> : {{cmd|give|...}}
;<nowiki>{{cmd|time|...}}</nowiki> : {{cmd|time|...}}
;<nowiki>{{cmd|whitelist|...}}</nowiki> : {{cmd|whitelist|...}}
;<nowiki>{{cmd|tp|...}}</nowiki> : {{cmd|tp|...}}
;<nowiki>{{cmd|?|...}}</nowiki> : {{cmd|?|...}}
;<nowiki>{{cmd|give ? command_block 1 0 {BlockEntityTag:{Command:"{{cmd|setblock ~ ~ ~ diamond_block}}"<nowiki>}}</nowiki></nowiki><nowiki>}}</nowiki>
: {{cmd|give ? command_block 1 0 {BlockEntityTag:{Command:"{{cmd|setblock ~ ~ ~ diamond_block}}"<nowiki>}}</nowiki>}}
;<nowiki>{{cmd|long=1|setblock ~1 ~-1 ~0 mob_spawner 0 replace {EntityId:Chicken, MaxNearbyEntities:10, SpawnCount:6, SpawnRange:2, RequiredPlayerRange:16, MinSpawnDelay:50, MaxSpawnDelay:200, SpawnData:{Riding:{id:"Pig"<nowiki>}}}&lt;/nowiki>}}</nowiki>
: {{cmd|long=1|setblock ~1 ~-1 ~0 mob_spawner 0 replace {EntityId:Chicken, MaxNearbyEntities:10, SpawnCount:6, SpawnRange:2, RequiredPlayerRange:16, MinSpawnDelay:50, MaxSpawnDelay:200, SpawnData:{Riding:{id:"Pig"<nowiki>}}}</nowiki>}}

== Pitfalls ==
* Commands containing equals signs or vertical pipes must be escaped to display correctly. For equals, if using a single argument place <code>1=</code> at the start of the command, otherwise replace each equals sign with {{tl|1==}}. For vertical pipes replace each one with {{tl|!}}.
* Commands containing braces must be careful not to end with a brace or have two or more next to each other. In a case such as: <code><nowiki>{{cmd|data {some:"data"}}}</nowiki></code>, a space can simply be placed at the end of the command: <code><nowiki>{{cmd|data {some:"data"} }}</nowiki></code>. In a case such as: <code><nowiki>{{cmd|data {some:{more:"data"}}}}</nowiki></code>, <code><nowiki><nowiki></nowiki></code> tags must be placed around the problem area: <code><nowiki>{{cmd|data {some:{more:"data"<nowiki>}}</nowiki></nowiki><nowiki>}}</nowiki></code> or <code><nowiki>{{cmd|data <nowiki>{some:{more:"data"}}</nowiki></nowiki><nowiki>}}</nowiki></code>, whatever is more readable.
* In order to count dataTags and sub-commands as a single parameter, spaces inside are ignored. However this won't work if a command contains multiple separate dataTags or multiple separate sub-commands. In that case, use separate arguments for the parameters.
{{doc/end}}
<noinclude>