Minecraft:Commands/advancement: Difference between revisions
From SAS Gaming Wiki
More actions
Fix template calls: add MC/ prefix |
Sync: updated from Minecraft |
||
| Line 1: | Line 1: | ||
{{ | {{exclusive|java}} | ||
{{Infobox command | {{Infobox command | ||
|name=advancement | |name=advancement | ||
| Line 5: | Line 5: | ||
}} | }} | ||
Gives or takes an advancement or its criterion from one or more players. | Gives or takes an [[Minecraft:advancement]] or its criterion from one or more players. | ||
== Syntax == | == Syntax == | ||
| Line 29: | Line 29: | ||
: Specifies whether to add or remove the to-be-specified advancement(s). | : Specifies whether to add or remove the to-be-specified advancement(s). | ||
{{ | {{argument|targets|entity}} | ||
: Specifies one player or more. | : Specifies one player or more. | ||
: {{ | : {{arg desc|je=entity|amount=multiple|type=players}} | ||
{{ | {{argument|advancement|resource_location}} | ||
: Specifies a valid resource location of the advancement to target. | : Specifies a valid resource location of the advancement to target. | ||
: {{ | : {{arg desc|je=resource_location}} | ||
{{ | {{argument|criterion|string}} | ||
: Specifies a valid criterion of the advancement to manipulate. | : Specifies a valid criterion of the advancement to manipulate. | ||
: The command defaults to the entire advancement. | : The command defaults to the entire advancement. | ||
: If specified, the command refers to merely the criterion and not the entire advancement. | : If specified, the command refers to merely the criterion and not the entire advancement. | ||
: {{ | : {{arg desc|je=string|type=greedy}} | ||
== Result == | == Result == | ||
| Line 48: | Line 48: | ||
{{Result table|<code><targets></code> fails to resolve to one or more online players.|fail}} | {{Result table|<code><targets></code> fails to resolve to one or more online players.|fail}} | ||
{{Result table|There's no advancement (or criterion) added to (or remove from) any player.}} | {{Result table|There's no advancement (or criterion) added to (or remove from) any player.}} | ||
{{Result table|cmd=/... only <advancement> <criterion>|The {{ | {{Result table|cmd=/... only <advancement> <criterion>|The {{cd|<criterion>}} is invalid for the {{cd|<advancement>}}.}} | ||
{{Result table|cmd=|succeed}} | {{Result table|cmd=|succeed}} | ||
{{Result table}} | {{Result table}} | ||
== Output == | == Output == | ||
{{ | {{Output table}} | ||
{{ | {{Output table|edition=je|On fail|0|0|0}} | ||
{{ | {{Output table|On success|1|1|the total number of advancements(or criterions) added to (or removed from) each player.}} | ||
{{ | {{Output table}} | ||
== Examples == | == Examples == | ||
| Line 66: | Line 66: | ||
== History == | == History == | ||
{{HistoryTable | {{HistoryTable | ||
|{{ | |{{HistoryLine|java}} | ||
|{{HistoryLine||1.12|dev=17w13a|Added {{ | |{{HistoryLine||1.12|dev=17w13a|Added {{cd|/advancement}}.}} | ||
|{{HistoryLine||1.13|dev=17w45a|Removed {{ | |{{HistoryLine||1.13|dev=17w45a|Removed {{cd|/advancement test}} in favor of [[Minecraft:Commands#Selecting targets by advancements|advancement target selectors]].}} | ||
|{{HistoryLine||1.20.3|dev=23w45a|The {{ | |{{HistoryLine||1.20.3|dev=23w45a|The {{cd|/advancement}} no longer throws unhandled expections when fails.}} | ||
}} | }} | ||
== See also == | == See also == | ||
* {{ | * {{cmd|gamerule announceAdvancements}} | ||
== Navigation == | == Navigation == | ||
{{ | {{Navbox commands}} | ||
de:Befehl/advancement | [[Minecraft:de:Befehl/advancement]] | ||
es:Comandos/advancement | [[Minecraft:es:Comandos/advancement]] | ||
ja:コマンド/advancement | [[Minecraft:ja:コマンド/advancement]] | ||
[[Minecraft:nl:Opdrachten/advancement]] | |||
nl:Opdrachten/advancement | [[Minecraft:pt:Comandos/advancement]] | ||
pt:Comandos/advancement | [[Minecraft:ru:Команды консоли/advancement]] | ||
ru:Команды консоли/advancement | [[Minecraft:uk:Команди консолі/advancement]] | ||
uk:Команди консолі/advancement | [[Minecraft:zh:命令/advancement]] | ||
zh:命令/advancement | |||
Latest revision as of 11:04, 3 October 2026
Template:Exclusive Template:Infobox command
Gives or takes an Minecraft:advancement or its criterion from one or more players.
Syntax
advancement (grant|revoke) <targets> everything- Adds or removes all loaded advancements.
advancement (grant|revoke) <targets> only <advancement> [<criterion>]- Adds or removes a single advancement or criterion.
advancement (grant|revoke) <targets> from <advancement>- Adds or removes an advancement and all its child advancements.
- Think of specifying everything from that advancement to the end.
- The exact order the operation is carried out in is
specified advancement > child > child's child > ...When it operates on a child that branches, it iterates through all its children before continuing.
advancement (grant|revoke) <targets> through <advancement>- Specifies an advancement, and adds or removes all its parent advancements, and all its child advancements.
- Think of specifying everything through the specified advancement, going both backward and forward.
- The exact order the operation is as if the command were executed with "until" specified, then with "from" specified:
parent > parent's parent > ... > root > specified advancement > child > child's child > ...
advancement (grant|revoke) <targets> until <advancement>- Adds or removes an advancement and all its parent advancements until the root for addition/removal.
- Think of specifying everything from the start until that advancement.
- The exact order the operation is carried out in is:
parent > parent's parent > ... > root > specified advancement.
Arguments
- Specifies whether to add or remove the to-be-specified advancement(s).
- Specifies one player or more.
- Template:Arg desc
- Specifies a valid resource location of the advancement to target.
- Template:Arg desc
- Specifies a valid criterion of the advancement to manipulate.
- The command defaults to the entire advancement.
- If specified, the command refers to merely the criterion and not the entire advancement.
- Template:Arg desc
Result
Template:Result table Template:Result table Template:Result table Template:Result table Template:Result table Template:Result table Template:Result table
Output
Template:Output table Template:Output table Template:Output table Template:Output table
Examples
- To grant the "Cover Me With Diamonds" advancement to the player, execute the command
/advancement grant @s only minecraft:story/shiny_gear. - To grant all advancements to every player, execute
/advancement grant @a everything. - To revoke "Cover Me With Diamonds" advancement from the player, execute the command
/advancement revoke @s only minecraft:story/shiny_gear. - To revoke all advancements from every player, execute
/advancement revoke @a everything.
History
See also
Minecraft:de:Befehl/advancement Minecraft:es:Comandos/advancement Minecraft:ja:コマンド/advancement Minecraft:nl:Opdrachten/advancement Minecraft:pt:Comandos/advancement Minecraft:ru:Команды консоли/advancement Minecraft:uk:Команди консолі/advancement Minecraft:zh:命令/advancement